当前位置：首页 > article >正文

在 Android 应用中使用 Hilt

article 2025/2/28 16:24:36

在这里插入图片描述

依赖注入（DI，Dependency Injection）是现代 Android 开发中提高代码可维护性和可测试性的重要工具。Hilt 是 Google 推出的一个基于 Dagger 的依赖注入框架，它简化了 DI 在 Android 应用中的使用。

在本文中，我们将详细介绍如何在 Android 项目中使用 Hilt，包括其基本概念、使用方式以及一些进阶用法。

1. 为什么使用 Hilt？

在 Android 应用开发中，随着项目规模的增长，类之间的依赖关系会变得复杂。如果手动管理依赖，会导致代码耦合度过高，不利于测试和维护。而 Hilt 通过注解和自动生成代码的方式帮助我们管理依赖关系，使得代码更加清晰、可复用。

2. 配置 Hilt

首先，我们需要在项目中添加 Hilt 依赖。

步骤 1：修改 build.gradle.kts（Project 级别）

 plugins {
     id("com.google.dagger.hilt.android") version "2.48" apply false
 }

步骤 2：修改 build.gradle.kts（App 级别）

 plugins {
     id("com.android.application")
     id("org.jetbrains.kotlin.android")
     id("com.google.dagger.hilt.android")
 }
 
 dependencies {
     implementation("com.google.dagger:hilt-android:2.48")
     kapt("com.google.dagger:hilt-android-compiler:2.48")
 }
 
 android {
     compileOptions {
         sourceCompatibility(JavaVersion.VERSION_17)
         targetCompatibility(JavaVersion.VERSION_17)
     }
 }

步骤 3：在 Application 类中启用 Hilt

 @HiltAndroidApp
 class MyApp : Application()

这一步告诉 Hilt 这个应用需要使用依赖注入，并在应用的生命周期中进行初始化。

3. 使用 Hilt 进行依赖注入

Hilt 主要使用 @Inject 和 @Module 注解来提供依赖。

（1）使用 @Inject 直接注入依赖

 class Engine @Inject constructor() {
     fun start() = "引擎启动..."
 }

（2）在 Activity 或 Fragment 中使用 Hilt

 @AndroidEntryPoint
 class MainActivity : AppCompatActivity() {
 
     @Inject lateinit var engine: Engine
 
     override fun onCreate(savedInstanceState: Bundle?) {
         super.onCreate(savedInstanceState)
         setContentView(R.layout.activity_main)
 
         println(engine.start())
     }
 }

（3）使用 @Module 和 @Provides 提供依赖

 @Module
 @InstallIn(SingletonComponent::class)
 object AppModule {
 
     @Provides
     fun provideEngine(): Engine {
         return Engine()
     }
 }

4. 进阶用法

（1）在 ViewModel 中使用 Hilt

 @HiltViewModel
 class MyViewModel @Inject constructor(
     private val engine: Engine
 ) : ViewModel() {
 
     fun startEngine() = engine.start()
 }

（2）在 Repository 中使用 Hilt

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

（3）测试中的依赖注入

 @HiltAndroidTest
 @RunWith(AndroidJUnit4::class)
 class MyTest {
 
     @get:Rule
     var hiltRule = HiltAndroidRule(this)
 
     @Inject
     lateinit var repository: Repository
 
     @Test
     fun testFetchData() {
         assert(repository.fetchData() == "测试数据")
     }
 }