在 kotlin 的 android 项目中使用 dagger(特别是 dagger hilt,官方推荐的简化版)进行依赖注入(di)可以大幅提升代码的可测试性和模块化程度。
1. 配置 dagger hilt
1.1 添加依赖
在 build.gradle (module) 中:
plugins {
id("com.google.dagger.hilt.android") version "2.48" apply false
}
dependencies {
implementation("com.google.dagger:hilt-android:2.48")
kapt("com.google.dagger:hilt-compiler:2.48") // kotlin 注解处理器
}在 build.gradle (project) 中:
plugins {
id("com.google.dagger.hilt.android") version "2.48" apply false
}1.2 启用 hilt
在 application 类上添加 @hiltandroidapp:
@hiltandroidapp class myapp : application()
2. 核心注解与用法
2.1 注入依赖到 android 类
使用 @inject 标记需要注入的依赖,并在目标类(如 activity、fragment)上添加 @androidentrypoint:
@androidentrypoint
class mainactivity : appcompatactivity() {
@inject lateinit var mydependency: mydependency // 依赖注入
override fun oncreate(savedinstancestate: bundle?) {
super.oncreate(savedinstancestate)
mydependency.dosomething() // 直接使用
}
}2.2 提供依赖(module)
使用 @module 和 @provides 定义依赖:
@module
@installin(singletoncomponent::class) // 作用域为全局单例
object appmodule {
@provides
fun providemydependency(): mydependency = mydependencyimpl()
}2.3 作用域(scoping)
@singleton:全局单例(整个应用生命周期)。@activityscoped:与 activity 生命周期绑定。@viewmodelscoped:与 viewmodel 生命周期绑定。
@module
@installin(viewmodelcomponent::class) // 作用域为 viewmodel
object viewmodelmodule {
@viewmodelscoped
@provides
fun providemyviewmodeldependency(): myviewmodeldependency = myviewmodeldependencyimpl()
}3. 注入 viewmodel
结合 viewmodel 和 hilt:
@hiltviewmodel
class myviewmodel @inject constructor(
private val mydependency: mydependency
) : viewmodel() {
fun dowork() {
mydependency.dosomething()
}
}在 activity/fragment 中获取:
@androidentrypoint
class mainactivity : appcompatactivity() {
private val viewmodel: myviewmodel by viewmodels()
}4. 注入接口或第三方库
4.1 接口绑定(@binds)
interface myrepository {
fun getdata(): string
}
class myrepositoryimpl @inject constructor() : myrepository {
override fun getdata() = "data from repository"
}
@module
@installin(singletoncomponent::class)
abstract class repositorymodule {
@binds
abstract fun bindmyrepository(impl: myrepositoryimpl): myrepository
}4.2 注入 retrofit / room
@module
@installin(singletoncomponent::class)
object networkmodule {
@provides
fun provideretrofit(): retrofit {
return retrofit.builder()
.baseurl("https://api.example.com/")
.addconverterfactory(gsonconverterfactory.create())
.build()
}
@provides
fun provideapiservice(retrofit: retrofit): apiservice {
return retrofit.create(apiservice::class.java)
}
}5. 常见问题与解决
5.1 编译错误:cannot be provided without an @provides
- 原因:dagger 找不到依赖的提供方式。
- 解决:
- 检查是否正确定义了
@module和@provides。 - 确保
@inject的类可以被 dagger 构造(如非接口、非第三方库类)。
- 检查是否正确定义了
5.2 作用域冲突
- 错误示例:在
activity中注入@singleton依赖,但该依赖需要@activityscoped。 - 解决:调整
@installin和作用域注解,确保生命周期匹配。
5.3 延迟注入(lazy)
如果依赖初始化耗时,可以使用 lazy<t>:
@inject lateinit var heavydependency: lazy<heavydependency>
fun usedependency() {
heavydependency.get().dowork() // 使用时才初始化
}6. dagger hilt vs. dagger 2
| 特性 | dagger hilt | dagger 2 |
|---|---|---|
| 配置复杂度 | 低(自动生成组件) | 高(需手动定义组件) |
| 作用域管理 | 内置 android 生命周期作用域(如 @activityscoped) | 需自定义作用域 |
| 适用场景 | 标准 android 项目 | 需要高度定制的复杂项目 |
7. 最佳实践
- 避免全局过度使用
@singleton,按需选择作用域。 - 用
@binds替代@provides 注入接口,减少模板代码。 - 结合 viewmodel 使用,避免内存泄漏。
到此这篇关于在kotlin的安卓项目中使用dagger的文章就介绍到这了,更多相关kotlin使用dagger内容请搜索代码网以前的文章或继续浏览下面的相关文章希望大家以后多多支持代码网!
发表评论