在安卓开发中，Hilt 是 Google 推出的一个**依赖注入（Dependency Injection，简称 DI）**库。

简单来说，Hilt 的作用是自动化地管理类与类之间的依赖关系，让你的代码更整洁、更易于测试和维护。

---

1. 什么是依赖注入（DI）？

在理解 Hilt 之前，先看一个通俗的例子。

不用 DI 的做法（手动创建）：
如果你要在 MainActivity 里用一个 UserService，你可能得自己 new 出来：

code Kotlin

downloadcontent_copy

expand_less

class MainActivity : AppCompatActivity() {
    private val userService = UserService(Database()) // 还要手动创建数据库依赖
}

缺点： 如果 UserService 的构造函数变了，或者它依赖了更多东西，你得在每个使用它的地方都改一遍代码。

使用 DI（Hilt）的做法：
你只需要声明“我想要这个东西”，Hilt 会自动帮你把它“送过来”：

code Kotlin

downloadcontent_copy

expand_less

@AndroidEntryPoint
class MainActivity : AppCompatActivity() {
    @Inject lateinit var userService: UserService // Hilt 自动帮你实例化并注入
}

---

2. Hilt 的核心特点

Hilt 是在著名的 Dagger 基础上开发的，但它比 Dagger 简单得多：

1. 专门为 Android 设计：内置了 Android 生命周期组件（Activity, Fragment, ViewModel 等）的支持。

2. 标准化：规定了依赖项应该放在哪里，减少了架构混乱。

3. 减少模板代码：自动生成那些复杂的 Dagger 样板代码。

---

3. Hilt 的常用注解（关键语法）

要用好 Hilt，你只需要记住几个核心注解：

• @HiltAndroidApp：
  必须放在你的 Application 类上。它是 Hilt 的“开关”。

  code Kotlin

  downloadcontent_copy

  expand_less

  @HiltAndroidApp
  class MyApplication : Application()

• @AndroidEntryPoint：
  放在 Activity、Fragment、View、Service 或 BroadcastReceiver 上。表示这个类可以接受 Hilt 注入的依赖。

  code Kotlin

  downloadcontent_copy

  expand_less

  @AndroidEntryPoint
  class MainActivity : AppCompatActivity() { ... }

• @Inject：

  • 用在构造函数上：告诉 Hilt 怎么创建这个类的实例。

  • 用在变量上：告诉 Hilt 把实例注入到这个变量里。

  code Kotlin

  downloadcontent_copy

  expand_less

  // 告诉 Hilt 怎么创建这个类
  class MyRepository @Inject constructor() { ... }
  
  // 在 Activity 中使用
  @Inject lateinit var repository: MyRepository

• @Module 和 @InstallIn：
  如果你要注入的东西是接口或者第三方库里的类（你没法在人家的构造函数上加 @Inject），就需要用到模块。

  code Kotlin

  downloadcontent_copy

  expand_less

  @Module
  @InstallIn(SingletonComponent::class) // 这个依赖存活范围和 App 一样长
  object NetworkModule {
      @Provides
      fun provideRetrofit(): Retrofit {
          return Retrofit.Builder().baseUrl("https://api.com").build()
      }
  }

---

4. Hilt 的生命周期（Scope）

Hilt 最厉害的地方在于它能自动绑定 Android 的生命周期：

注解	存活范围
@Singleton	整个 App 运行期间（全局单例）
@ActivityRetainedScoped	整个 ViewModel 的生命周期（配置更改如旋转屏幕不销毁）
@ActivityScoped	对应 Activity 的生命周期
@FragmentScoped	对应 Fragment 的生命周期

---

5. 为什么要学 Hilt？

1. Google 强推：它是 Jetpack 家族的一部分，是目前 Android 开发的主流标准。

2. 解耦：你的类不再需要知道它的依赖项是如何创建的。

3. 单元测试：你可以非常轻松地把真实的数据库依赖替换成“模拟（Mock）”的对象，从而进行测试。

4. ViewModel 支持：Hilt 对 ViewModel 的注入非常友好，只需一个 @HiltViewModel 注解。

总结

Hilt 是 Android 开发者的“后勤部”。你只需要在代码里打上标签（注解），告诉它你需要什么，它就会在合适的时机（Activity 创建时）把你需要的对象准备好并递给你。