设置 Hilt
添加 Hilt 和应用组件
设置 Hilt 是 CoddyKit 上的免费 Android Academy 课时。 这是第 2 节课，共 4 节。 你可以在下方免费阅读本课时的完整内容 — 然后在浏览器中使用内置代码编辑器和全天候 AI 导师进行实践。 这是 Android Academy 学习路径的一部分，你的进度在网页和 CoddyKit 应用中同步。 Android Academy 课程共包含 4 节课。
将 Hilt 添加到项目
Hilt 需要 Gradle 插件、依赖项以及注解处理器（KSP 或 kapt）。每个项目只需设置一次。
Gradle 插件
在模块构建文件中启用 Hilt 插件，并同时启用 KSP。
// module build.gradle.kts
plugins {
id("com.google.dagger.hilt.android")
id("com.google.devtools.ksp")
}依赖项
添加 Hilt 运行时库和编译器。
dependencies {
implementation("com.google.dagger:hilt-android:2.x")
ksp("com.google.dagger:hilt-compiler:2.x")
}为 Application 添加注解
Hilt 需要在应用级别设置一个入口点。创建一个带有 @HiltAndroidApp 注解的 Application 子类。
import android.app.Application
import dagger.hilt.android.HiltAndroidApp
@HiltAndroidApp
class MyApp : Application()在清单中注册
让您的清单文件中的 application 标签指向此类。
<application
android:name=".MyApp"
... >@HiltAndroidApp 的作用
它会触发 Hilt 的代码生成，并创建应用级依赖容器，这是整个依赖关系图的根。
在 Activity 中启用注入
为任何需要注入的 Activity 添加 @AndroidEntryPoint 注解。
import dagger.hilt.android.AndroidEntryPoint
@AndroidEntryPoint
class MainActivity : ComponentActivity() {
// Hilt can now inject members here
}其他类的入口点
@AndroidEntryPoint 也适用于 Fragment、Service 和 BroadcastReceivers。它会在正确的作用域中将每个类连接到 Hilt 依赖关系图。
字段注入
在入口点内部，您可以在字段上使用 @Inject 来请求依赖项。
@AndroidEntryPoint
class MainActivity : ComponentActivity() {
@Inject lateinit var analytics: Analytics
}组件层级结构
Hilt 会生成以下层级结构：SingletonComponent（应用） → ActivityRetainedComponent → ViewModelComponent → ActivityComponent。每个组件都有对应的作用域注解。
设置检查清单
- 启用 Hilt + KSP 插件。
- 添加运行时库和编译器依赖项。
- 创建一个带有
@HiltAndroidApp的 Application。 - 为使用依赖的类添加
@AndroidEntryPoint。
快速检查
测试您对 Hilt 设置的理解。
回顾
您学到了：
- 启用 Hilt + KSP 插件并添加依赖项。
- 在 Application 上添加
@HiltAndroidApp可创建根容器。 @AndroidEntryPoint可在 Activity 和 Fragment 中启用注入。- 使用
@Inject进行字段注入。
常见问题解答
「设置 Hilt」课时是免费的吗？
是的 — 「设置 Hilt」的完整文本可在网页上免费阅读。要进行交互式练习（内置代码编辑器和全天候 AI 导师）并解锁 Android Academy 课程的其余内容，请升级到 CoddyKit PRO。 Android Academy 课程共包含 4 节课。
「设置 Hilt」这节课中我会学到什么？
添加 Hilt 和应用组件 你通过在浏览器中直接运行的动手代码来练习 Android Academy，全天候 AI 导师会在你学习这节课的过程中回答你的问题。
学习 Android Academy 需要有经验吗？
无需任何先前经验。CoddyKit 上的 Android Academy 课程适合初学者到高级学习者，你可以从这里开始或从头开始，按照自己的节奏学习。 这是第 2 节课，共 4 节。
「设置 Hilt」课时需要多长时间？
大多数 CoddyKit 课程大约需要 5–10 分钟。每节课都很精短且互动，所以你能稳步进步，并在网页和应用中从离开的地方继续。
我能在这节 Android Academy 课中编写并运行代码吗？
能。每节 Android Academy 课都包含内置代码编辑器，你可以在浏览器中直接编写并运行真实代码，并获得即时 AI 反馈 — 无需本地设置。