如何在Android Studio Iguana中正确添加Dagger Hilt依赖？

一、Project级依赖配置（根目录build文件） #

Kotlin DSL（build.gradle.kts）

在 plugins 块中添加Hilt插件的classpath：

plugins {
    id("com.android.application") version "8.1.0" apply false
    id("org.jetbrains.kotlin.android") version "1.8.10" apply false
    // 添加Hilt插件classpath
    id("com.google.dagger.hilt.android") version "2.48" apply false
}

Groovy（build.gradle）

在 buildscript 的 dependencies 块中添加：

buildscript {
    dependencies {
        classpath "com.google.dagger:hilt-android-gradle-plugin:2.48"
    }
}

二、Module级依赖配置（一般是app模块的build文件） #

Kotlin DSL（build.gradle.kts）

1. 顶部应用插件：

plugins {
    id("com.android.application")
    id("org.jetbrains.kotlin.android")
    id("kotlin-kapt") // 必须添加，用于注解处理
    id("com.google.dagger.hilt.android")
}

2. 在 dependencies 块添加依赖：

dependencies {
    // Hilt核心依赖
    implementation("com.google.dagger:hilt-android:2.48")
    // 注解处理器
    kapt("com.google.dagger:hilt-android-compiler:2.48")
}

Groovy（build.gradle）

1. 顶部应用插件：

plugins {
    id 'com.android.application'
    id 'org.jetbrains.kotlin.android'
    id 'kotlin-kapt'
    id 'com.google.dagger.hilt.android'
}

2. 依赖块添加：

dependencies {
    implementation 'com.google.dagger:hilt-android:2.48'
    kapt 'com.google.dagger:hilt-android-compiler:2.48'
}

三、配置Application类 #

创建或修改你的Application类，添加@HiltAndroidApp注解：

import android.app.Application
import dagger.hilt.android.HiltAndroidApp

@HiltAndroidApp
class MyApp : Application()

四、修改AndroidManifest.xml #

将Application节点的android:name指定为上面的类：

<application
    android:name=".MyApp"
    ...>
    ...
</application>

常见问题排查 #

• 版本不兼容：确保Hilt版本与你的AGP（Android Gradle Plugin）版本匹配，比如AGP 8.0+建议使用Hilt 2.44及以上版本。
• 忘记添加kotlin-kapt插件：Hilt依赖注解处理器，缺少这个插件会导致注解无法生效。
• 缓存问题：执行File > Sync Project with Gradle Files，或者Build > Clean Project后再Rebuild Project。
• Application类未正确配置：必须添加@HiltAndroidApp，且Manifest中指定正确的类名。

内容的提问来源于stack exchange，提问作者Viorel