Android Studio集成Hilt提示dagger.hilt.android.plugin插件找不到如何解决

问题根因 #

你遇到的报错由两个核心原因导致：

• Android Studio Bumblebee及更高版本默认启用了Gradle新的插件管理机制，原有将Hilt插件作为classpath添加到项目级build.gradle的旧配置方案不再适配
• 你使用的dagger.hilt.android.plugin是2.40版本以前的旧Hilt插件ID，新版本已变更ID，且未在正确的配置文件中声明版本和仓库

解决步骤 #

1. 配置settings.gradle #

修改项目根目录的settings.gradle，确保pluginManagement和dependencyResolutionManagement块中添加了google()和mavenCentral()仓库，示例配置如下：

pluginManagement {
    repositories {
        gradlePluginPortal()
        google()
        mavenCentral()
    }
}
dependencyResolutionManagement {
    repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
    repositories {
        google()
        mavenCentral()
    }
}
rootProject.name = "你的项目名称"
include ':app'

2. 配置项目级build.gradle #

删除之前添加的Hilt相关classpath依赖，直接在plugins块中声明Hilt插件，版本和你后续使用的Hilt依赖版本保持一致即可：

plugins {
    id 'com.android.application' version '7.1.0' apply false
    id 'com.android.library' version '7.1.0' apply false
    id 'org.jetbrains.kotlin.android' version '1.6.10' apply false
    // 声明Hilt插件，2.40及以上版本插件ID为com.google.dagger.hilt.android
    id 'com.google.dagger.hilt.android' version '2.44' apply false
}

3. 配置app模块级build.gradle #

plugins {
    id 'com.android.application'
    id 'org.jetbrains.kotlin.android'
    // Kotlin项目需要添加kapt插件
    id 'kotlin-kapt'
    // 应用Hilt插件，无需重复声明版本
    id 'com.google.dagger.hilt.android'
}

android {
    // 保留原有配置，新增Java 8版本支持
    compileOptions {
        sourceCompatibility JavaVersion.VERSION_1_8
        targetCompatibility JavaVersion.VERSION_1_8
    }
    kotlinOptions {
        jvmTarget = '1.8'
    }
}

dependencies {
    // 保留原有依赖，新增Hilt相关依赖
    implementation "com.google.dagger:hilt-android:2.44"
    kapt "com.google.dagger:hilt-android-compiler:2.44"
}

kapt {
    correctErrorTypes = true
}

4. 同步并重建项目 #

配置完成后点击Gradle同步，同步成功后依次执行Build -> Clean Project、Build -> Rebuild Project即可消除报错。

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