1. Hilt依赖注入实战完全指南
作为一名经历过多个Android项目的老兵，我深刻理解依赖注入(DI)在复杂应用开发中的重要性。Hilt作为Android官方推荐的DI解决方案，相比Dagger大幅降低了使用门槛。今天我就带大家从实战角度，彻底掌握Hilt的核心用法和进阶技巧。
2. Hilt核心概念解析
2.1 为什么需要依赖注入
在传统开发中，我们经常看到这样的代码：
kotlin复制class UserRepository {
private val apiService = ApiService()
//...
}
class UserViewModel {
private val repository = UserRepository()
//...
}
这种硬编码的依赖关系会导致：
- 测试困难：无法轻松替换模拟实现
- 代码耦合：修改一个类可能影响多个依赖它的类
- 生命周期管理复杂：难以控制对象的创建和销毁
2.2 Hilt与Dagger的关系
Hilt是基于Dagger的封装层，它：
- 自动生成大量模板代码
- 提供标准化的Android组件集成
- 简化作用域管理
- 内置最佳实践配置
提示：如果你已经熟悉Dagger，学习Hilt会非常容易；如果是新手，建议直接从Hilt开始
3. 基础配置与使用
3.1 项目配置
在模块级build.gradle中添加：
groovy复制dependencies {
implementation 'com.google.dagger:hilt-android:2.48'
kapt 'com.google.dagger:hilt-compiler:2.48'
}
在Application类添加注解：
kotlin复制@HiltAndroidApp
class MyApp : Application()
3.2 基本注入示例
定义可注入的依赖：
kotlin复制class AnalyticsAdapter @Inject constructor(
private val service: AnalyticsService
) {
//...
}
在Activity中使用：
kotlin复制@AndroidEntryPoint
class MainActivity : AppCompatActivity() {
@Inject lateinit var analytics: AnalyticsAdapter
//...
}
4. 进阶用法详解
4.1 模块化依赖提供
创建Module提供特定依赖：
kotlin复制@Module
@InstallIn(ActivityComponent::class)
object AnalyticsModule {
@Provides
fun provideAnalyticsService(): AnalyticsService {
return Retrofit.Builder()
.baseUrl("https://example.com")
.build()
.create(AnalyticsService::class.java)
}
}
4.2 作用域管理
Hilt提供多种预定义作用域：
- @Singleton - 应用级别单例
- @ActivityScoped - Activity生命周期
- @ViewModelScoped - ViewModel生命周期
使用示例：
kotlin复制@ActivityScoped
class UserDataCache @Inject constructor() {
//...
}
4.3 多绑定与限定符
当同一类型有多个实现时：
kotlin复制@Qualifier
annotation class AuthInterceptorOkHttpClient
@Qualifier
annotation class OtherInterceptorOkHttpClient
@Module
@InstallIn(SingletonComponent::class)
object NetworkModule {
@AuthInterceptorOkHttpClient
@Provides
fun provideAuthOkHttpClient(): OkHttpClient {
return OkHttpClient.Builder()
.addInterceptor(AuthInterceptor())
.build()
}
@OtherInterceptorOkHttpClient
@Provides
fun provideOtherOkHttpClient(): OkHttpClient {
//...
}
}
5. 实战技巧与避坑指南
5.1 ViewModel注入最佳实践
推荐使用hilt-viewmodel扩展：
kotlin复制@HiltViewModel
class UserViewModel @Inject constructor(
private val userRepository: UserRepository
) : ViewModel() {
//...
}
// Activity中获取
private val viewModel: UserViewModel by viewModels()
5.2 测试中的Hilt使用
配置测试依赖：
kotlin复制@HiltAndroidTest
class ExampleTest {
@get:Rule
var hiltRule = HiltAndroidRule(this)
@Inject
lateinit var analytics: AnalyticsAdapter
@Before
fun init() {
hiltRule.inject()
}
//...
}
5.3 常见问题解决
-
编译错误"找不到符号"：
- 确保所有@Inject构造函数的类都是public
- 检查是否添加了kapt插件
-
注入失败(NullPointerException)：
- 确认使用@AndroidEntryPoint注解了Android组件
- 检查依赖是否提供了合适的@Provides方法
-
循环依赖：
- 重构代码结构
- 使用Lazy或Provider延迟初始化
6. 性能优化建议
-
合理使用作用域：
- 避免滥用@Singleton
- 短生命周期对象不要使用大作用域
-
模块拆分原则：
- 按功能划分模块
- 将常用依赖放在公共模块
-
编译时验证：
- 使用./gradlew :app:kaptDebugKotlin检查错误
- 关注编译警告信息
在实际项目中，我从最初的抗拒到现在的主动采用Hilt，最大的体会是：前期虽然需要投入学习成本，但随着项目复杂度提升，它带来的可维护性和可测试性优势会越来越明显。特别是当团队规模扩大后，统一的依赖管理方式能显著降低协作成本。