在 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内容请搜索代码网以前的文章或继续浏览下面的相关文章希望大家以后多多支持代码网!
发表评论