Android中的依赖注入(DI)框架Hilt

Hilt 是 Android 提供的一种依赖注入（DI）框架，它基于 Dagger，目的是简化依赖注入的使用，提供更易用的接口和与 Android 生命周期组件的紧密集成。下面是 Hilt 的详细介绍。

为什么选择 Hilt?

依赖注入的优势：

1. 解耦代码：通过构造函数注入可以避免组件之间的强依赖。
2. 易于测试：通过提供 mock 实现，可以轻松测试各个组件。
3. 管理依赖生命周期：在适当的时间创建和销毁依赖，避免内存泄漏。

Hilt 的优势：

1. 与 Android 集成良好：支持 Android 常见组件（如 Activity、Fragment、ViewModel 等）的依赖注入。
2. 简化配置：通过预定义的作用域和注解减少手动配置。
3. 提升性能：通过 Dagger 的代码生成特性保证运行时性能。

核心概念

1. 模块和绑定

使用 @Module 和 @Provides 注解来定义模块和依赖。Hilt 会自动将这些依赖注入到需要的地方。

@Module
@InstallIn(SingletonComponent::class)
object AppModule {

    @Provides
    fun provideString(): String = "Hello, Hilt!"
}

2. 作用域（Scopes）

Hilt 提供了预定义的作用域，帮助管理依赖的生命周期：

例如，提供全局单例：

@Module
@InstallIn(SingletonComponent::class)
object SingletonModule {

    @Singleton
    @Provides
    fun provideDatabase(@ApplicationContext context: Context): MyDatabase {
        return MyDatabase.getInstance(context)
    }
}

3. 注入依赖

在需要注入依赖的地方使用 @Inject：

构造函数注入：

class Repository @Inject constructor(
    private val apiService: ApiService
) {
    fun fetchData() = apiService.getData()
}

属性注入：

@AndroidEntryPoint
class MainActivity : AppCompatActivity() {

    @Inject
    lateinit var repository: Repository

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_main)

        repository.fetchData()
    }
}

4. 预定义组件

Hilt 提供了一些内置组件，用于不同场景的依赖注入：

要启用这些组件，使用 @AndroidEntryPoint 注解标记目标类。

@AndroidEntryPoint
class MainActivity : AppCompatActivity()

典型用例

网络请求和仓库模式

@Module
@InstallIn(SingletonComponent::class)
object NetworkModule {

    @Singleton
    @Provides
    fun provideRetrofit(): Retrofit {
        return Retrofit.Builder()
            .baseUrl("https://api.example.com")
            .addConverterFactory(GsonConverterFactory.create())
            .build()
    }

    @Singleton
    @Provides
    fun provideApiService(retrofit: Retrofit): ApiService {
        return retrofit.create(ApiService::class.java)
    }
}

@AndroidEntryPoint
class MainActivity : AppCompatActivity() {

    @Inject
    lateinit var apiService: ApiService

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_main)

        lifecycleScope.launch {
            val data = apiService.getData()
            // Process data
        }
    }
}

注意事项

1. @AndroidEntryPoint 的限制

• 只能注解支持的 Android 类（Activity、Fragment、Service 等）。
• 自定义类需要通过构造函数注入。

2. Avoid Circular Dependencies

• 如果两个类互相依赖，会引发编译错误，需要重新设计依赖结构。

3. 模块生命周期与依赖管理

• 确保将依赖绑定到合适的生命周期组件中，避免内存泄漏或无效的依赖实例。

总结

Hilt 是 Android 现代开发中非常重要的工具之一，帮助开发者以更少的代码实现依赖注入，同时保持代码的清晰性和模块化。在使用 Hilt 时，需要掌握其核心注解和生命周期管理，并根据具体需求选择适合的作用域。