本文首发于公众号“AntDream”，欢迎微信搜索“AntDream”或扫描文章底部二维码关注，和我一起每天进步一点点
Hilt概述
Hilt是Google推出的一种用于Android的依赖注入（Dependency Injection，DI）框架，构建于Dagger之上，旨在简化Android应用中的依赖注入过程。通过Hilt，你可以更轻松地管理和提供依赖，显著减少DI的样板代码，并提高应用的可测试性和可维护性。
Hilt的主要概念
1、 Modules：用来定义如何提供实例。在Hilt中，使用@Module和@InstallIn注解类，并使用@Provides方法提供依赖。
2、 Components：Hilt自动生成不同的组件来管理不同的生命周期。这包括单例组件、Activity组件、Fragment组件等。
3、 Inject：用来注入实例。类中的构造函数、字段和方法都可以使用@Inject注解。
4、 Entry Points：用于获取Hilt提供的实例。
Hilt的基本用法
1. 添加依赖
首先，在你的build.gradle文件中添加Hilt的依赖：
plugins {
id 'com.android.application'
id 'kotlin-android'
id 'kotlin-kapt' // Kotlin Annotation Processor
id 'dagger.hilt.android.plugin'
}
dependencies {
implementation "com.google.dagger:hilt-android:2.44"
kapt "com.google.dagger:hilt-android-compiler:2.44"
}
确保在根build.gradle文件中也应用了Hilt的插件：
buildscript {
repositories {
google()
}
dependencies {
classpath 'com.google.dagger:hilt-android-gradle-plugin:2.44'
}
}
2. 初始化Hilt
在Application类上添加@HiltAndroidApp注解以启用Hilt：
@HiltAndroidApp
class MyApplication : Application() {
// Application class code
}
3. 创建Module
模块用于提供实例。在Hilt中，你可以创建一个带有@Module和@InstallIn注解的类，并用@Provides方法提供依赖：
@Module
@InstallIn(SingletonComponent::class)
object AppModule {
@Provides
@Singleton
fun provideRetrofit(): Retrofit {
return Retrofit.Builder()
.baseUrl("https://api.example.com/")
.addConverterFactory(GsonConverterFactory.create())
.build()
}
@Provides
@Singleton
fun provideApiService(retrofit: Retrofit): ApiService {
return retrofit.create(ApiService::class.java)
}
}
4. 使用@Inject注解
现在，你可以使用@Inject注解来注入依赖：
@HiltViewModel
class MyViewModel @Inject constructor(
private val apiService: ApiService
) : ViewModel() {
fun fetchData() {
// Use apiService to fetch data
}
}
在Activity或Fragment中使用注入的ViewModel：
@AndroidEntryPoint
class MyActivity : AppCompatActivity() {
private val viewModel: MyViewModel by viewModels()
override fun onCreate(savedInstanceState: Bundle?) {
super.onCreate(savedInstanceState)
setContentView(R.layout.activity_main)
viewModel.fetchData()
}
}
5. 生命周期相关的组件
Hilt支持多种Android组件，并且能够管理这些组件的生命周期。例如，@InstallIn(ActivityComponent::class)表示依赖将在Activity的生命周期内存在。
@Module
@InstallIn(ActivityComponent::class)
object ActivityModule {
@Provides
fun provideActivityDependency(): ActivityDependency {
return ActivityDependency()
}
}
在Activity中注入依赖：
@AndroidEntryPoint
class MyActivity : AppCompatActivity() {
@Inject
lateinit var activityDependency: ActivityDependency
override fun onCreate(savedInstanceState: Bundle?) {
super.onCreate(savedInstanceState)
setContentView(R.layout.activity_main)
// Use activityDependency
}
}
Hilt的原理
Hilt构建于Dagger2之上，因此其工作原理与Dagger是类似的。它通过一系列注解生成编译时代码来实现依赖注入。总结如下：
1、 模块（Module）和提供者（Provider Method）：通过注解创建模块和提供者方法，并使用Dagger编译器生成相关代码。
2、 组件（Component）：Hilt自动生成不同生命周期作用域的组件，这些组件负责管理实例的生命周期。
3、 注入点（Injection Site）：通过注解确定类的哪些部分需要注入依赖，并在运行时由Hilt提供实例。
通过这种方式，Hilt大幅简化了Android应用中的依赖注入过程，减少了手动编写组件和模块所需的代码，并提高了代码的可读性和可维护性。
总结起来，Hilt提供了一种简洁且强大的方式来管理依赖，特别适合于Android开发的场景。希望这个介绍对你理解和使用Hilt有所帮助！
欢迎关注我的公众号AntDream查看更多精彩文章！
