如何在Android Studio的libs.versions.toml中添加Hilt依赖并解决报错

以下是排查和解决该问题的具体步骤：

1. 检查libs.versions.toml的配置格式 #

格式错误是导致依赖无法识别的最常见原因，确保你按如下规范配置：

[versions]
# 定义Hilt统一版本号
hilt = "2.48"

[libraries]
# 映射Hilt核心依赖，key需与build.gradle.kts中的调用名一致
hilt = { module = "com.google.dagger:hilt-android", version.ref = "hilt" }
hilt-compiler = { module = "com.google.dagger:hilt-android-compiler", version.ref = "hilt" }

注意：如果你在build.gradle.kts中写implementation(libs.hilt)，那么[libraries]中的key必须为hilt；若写成libs.hilt.android，则key需设为hilt-android。

2. 配置项目级build.gradle.kts #

在项目根目录的build.gradle.kts中，确保添加Hilt插件的classpath并配置正确仓库：

plugins {
    id("com.android.application") version "7.4.2" apply false
    // 引入Hilt插件，版本需与toml中定义的一致
    id("com.google.dagger.hilt.android") version "2.48" apply false
}

dependencyResolutionManagement {
    repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
    repositories {
        google()
        mavenCentral() // Hilt依赖托管在此仓库，必须添加
    }
}

3. 配置应用级build.gradle.kts #

在app模块的build.gradle.kts中，应用Hilt插件并正确引用依赖：

plugins {
    id("com.android.application")
    id("kotlin-android")
    id("com.google.dagger.hilt.android") // 应用Hilt插件
    id("kotlin-kapt") // Kotlin项目必须添加，用于注解处理
}

dependencies {
    implementation(libs.hilt) // 对应toml中的hilt核心依赖
    kapt(libs.hilt-compiler) // 注解处理器必须用kapt声明，不能用implementation
}

// 可选：开启kapt的错误类型校正，提升注解处理稳定性
kapt {
    correctErrorTypes = true
}

4. 同步并清理项目 #

• 点击Android Studio右上角的Sync Project with Gradle Files按钮，同步配置
• 在终端执行./gradlew clean build命令，清理缓存后重新构建

若问题仍存在，检查以下细节：

• 版本兼容性：确保Hilt版本与Android Gradle Plugin版本匹配（如AGP 7.4+对应Hilt 2.44+）
• 拼写错误：检查toml中的key与build.gradle.kts中的引用是否完全一致（大小写敏感）

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