前言
基于Dagger2
、Hilt
以Android专属DI框架的身份继续完善了Jetpack的布局,本文将主要介绍Hilt
的优点&缺点
定义
基于Dagger(Dagger2),专为Android App打造的依赖注入方案。
特点
它在保留Dagger2的编译时注入的性能优势前提下,简化了注解的使用,同时针对Android框架类进行了优化。
储备知识
在讲解Hilt前先来简单了解依赖注入的各个角色&流程
- 依赖的需求方:
通过构造参数或字段依赖其他实例的角色,一般使用@Inject
描述 - 依赖的提供方:
对被依赖的实例提供实现的角色,如使用@Provides
描述 - 依赖的注入方:
将提供方的实现注入到需求方的角色,如使用@Component
描述
Hilt的优点
主要包括:
- 高度封装了框架类的注入
- 绑定生命周期
- 预设作用域
- Context注入
- 针对Jetpack组件的支持
优点1:高度封装了框架类的注入
- 定义应用组件
对于Application,添加@HiltAndroidApp
注解即可告知Hilt生成应用级别的组件,自动实现了依赖注入的起点,免去了Dagger2的手动调用。
@HiltAndroidApp
class MyApplication :Application(){...}
- 定义Android框架类组件
@AndroidEntryPoint
注解用来为Activity、Fragment、Service等Android框架类生成Hilt组件,省去了定义相应SubComponent的模版处理。
@AndroidEntryPoint
open class BaseActivity():AppCompatActivity(){...}
优点2:绑定生命周期
@InstallIn
注解可以告知Hilt每个模块将用在或绑定哪个Android类中。比如指定的value为ApplicationComponent
的话将表明该模块在整个应用周期内只会实例化一份,即单例。其他的还有绑定Activity生命周期的ActivityComponent。
@Module
@InstallIn(ApplicationComponent::class)
class NetworkModule{...}
优点3:预设作用域
@Singleton
和 @ActivityRetainedScoped
等注解用以声明该注入的作用范围。比如Activity因为Configuration Change重绘了但@ActivityRetainedScoped
注解的依赖并不会重新创建。
@ActivityRetainedScoped
class MovieAdapter @Inject constructor(){...}
@AndroidEntryPoint
class DemoActivity :AppCompatActivity(){
@Inject lateinit var movieAdapter:MovieAdapter
...
}
优点4:注入Context
通过@ApplicationContext
和@ActivityContext
注解等可以快速注入Context实例,省的我们自己提供Context的实现
class MovieAdapter @Inject constructor(@ActivityContext private val context:Context):RecycleView.Adapter<RecycleView.ViewHolder>(){...}
优点5:Jetpack组件的支持
Hilt实现了一些扩展帮助我们注入ViewModel和WorkManager的依赖,比如:@ViewModelInject
注解就可以告知Hilt此处需要注入ViewModel实例。
class MovieViewModel @ViewModelInject constructor(private val repository:Repository,var movieAdapter:MoveAdapter):ViewModel(){...}
Hilt的缺点
主要包括:
- @AndroidEntryPoint的限制
- Android框架类的注入限制
- 生命周期限制
- ViewModel注入限制
缺点1:
@AndroidEntryPoint
的限制
- 依附类:依附类的话同样需要添加
@AndroidEntryPoint
- Activity:只能注解ComponentActivity子类Activity
- Fragment: 只能注解Androidx的Fragment,但不包括不支持Retained Fragment
- 基类: 基类可统一添加
@AndroidEntryPoint
,但抽象类不需要
缺点2:Android框架类的注入限制
- 注入方式:只能是字段注入
- 字段的修饰符:不能为private
- BrocastReceiver:不会生成单独的组件
- View :默认绑定到ActivityComponent
- ContentProvide:无法直接使用@AndroidEntryPoint注解
缺点3:生命周期的限制
使用@ViewModelInject
向ViewModel注入依赖时需要注意:
- 如果使用
viewModels()
的KTX获取ViewModel实例的话,可能会遇到找不到该KTX的问题,这时候注意下gradle文件有没有导入fragmenmt-ktx
的依赖 - 如果运行失败并提示viewModel不包含默认构造函数,一定记得检查
hilt-compiler
的注解处理器有没有在gradle文件里声明。 - 如果编译发生如下错误,需记得在gradle的kotlinOptions里声明jvm的版本为1.8
总结
相较于Dagger2,Hilt确实存在许多优点,但由于其同时也带来了一些天生的劣势,在实际应用中,需要根据实际需要做出抉择:小而美的Hilt亦或者大而强的Dagger2
官方文档
https://developer.android.google.cn/training/dependency-injection/hilt-android
本文来自读者虾米君投稿,其公众号:TechMerger
查看原文