Android项目构建失败：Glide Compiler依赖离线模式无法解析

问题 #

按教程创建Android项目并更新Gradle配置后，项目无法启动，构建出现两个失败任务：

• 任务:app:kaptGenerateStubsDebugKotlin执行失败：评估filteredArgumentsMap属性时出错，无法解析:app:kapt配置的所有文件，离线模式下无com.github.bumptech.glide:glide:compiler的缓存版本。
• 任务:app:javaPreCompileDebug执行失败：无法解析:app:_agp_internal_javaPreCompileDebug_kaptClasspath配置的所有文件，同样因离线模式下无Glide Compiler缓存版本。

已尝试切换离线模式启动项目，怀疑问题与Dagger&Hilt相关。以下是Gradle配置文件：

Module级build.gradle #

plugins {
    id 'com.android.application'
    id 'org.jetbrains.kotlin.android'
    id 'androidx.navigation.safeargs.kotlin'
    id 'dagger.hilt.android.plugin'
    id 'kotlin-kapt'
}

android {
    namespace 'com.example.movieapp'
    compileSdk 33

    defaultConfig {
        applicationId "com.example.movieapp"
        minSdk 21
        targetSdk 33
        versionCode 1
        versionName "1.0"

        testInstrumentationRunner "androidx.test.runner.AndroidJUnitRunner"
    }

    buildTypes {
        release {
            minifyEnabled false
            proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'), 'proguard-rules.pro'
        }
    }
    compileOptions {
        sourceCompatibility JavaVersion.VERSION_1_8
        targetCompatibility JavaVersion.VERSION_1_8
    }
    kotlinOptions {
        jvmTarget = '1.8'
    }
    buildFeatures {
        dataBinding = true
    }
}

dependencies {

    implementation 'androidx.core:core-ktx:1.9.0'
    implementation 'androidx.appcompat:appcompat:1.6.0'
    implementation 'com.google.android.material:material:1.8.0'
    implementation 'androidx.constraintlayout:constraintlayout:2.1.4'
    testImplementation 'junit:junit:4.13.2'
    androidTestImplementation 'androidx.test.ext:junit:1.1.5'
    androidTestImplementation 'androidx.test.espresso:espresso-core:3.5.1'

    implementation 'androidx.navigation:navigation-fragment-ktx:2.5.3'
    implementation 'androidx.navigation:navigation-ui-ktx:2.5.3'

    implementation 'com.google.dagger:hilt-android:2.31.2-alpha'
    kapt 'com.google.dagger:hilt-android-compiler:2.31.2-alpha'

    implementation 'com.squareup.retrofit2:retrofit:2.9.0'
    implementation 'com.squareup.retrofit2:converter-gson:2.9.0'

    implementation 'androidx.paging:paging-runtime-ktx:3.1.1'

    implementation 'com.github.bumptech.glide:glide:4.13.0'
    kapt 'com.github.bumptech.glide:glide:compiler:4.13.0'
}

Project级build.gradle #

plugins {
    id 'com.android.application' version '7.3.1' apply false
    id 'com.android.library' version '7.3.1' apply false
    id 'org.jetbrains.kotlin.android' version '1.7.20' apply false

    id 'androidx.navigation.safeargs' version '2.4.2' apply false
    id 'com.google.dagger.hilt.android' version '2.41' apply false
}

解决方案 #

1. 修正Glide编译器依赖坐标 #

当前Glide编译器依赖写法错误，正确坐标应为com.github.bumptech.glide:compiler:版本号，而非com.github.bumptech.glide:glide:compiler:版本号。修改Module级build.gradle中的对应依赖：

// 替换原kapt Glide依赖
kapt 'com.github.bumptech.glide:compiler:4.13.0'

2. 统一Hilt版本，消除版本冲突 #

项目中Hilt插件版本（2.41）与依赖库版本（2.31.2-alpha）不一致，会引发构建异常。将两者版本统一为匹配的稳定版：

• 修改Project级build.gradle的Hilt插件版本（保持当前2.41即可）：

id 'com.google.dagger.hilt.android' version '2.41' apply false

• 修改Module级build.gradle的Hilt依赖版本，与插件版本对齐：

implementation 'com.google.dagger:hilt-android:2.41'
kapt 'com.google.dagger:hilt-android-compiler:2.41'

3. 关闭离线模式并重新同步 #

错误提示明确指出离线模式下无对应依赖缓存，操作步骤：

• 在Android Studio右上角打开Gradle面板，找到项目，点击Toggle Offline Mode确保该选项未被勾选。
• 点击工具栏的Sync Project with Gradle Files按钮重新同步，让Gradle下载缺失的依赖包。

4. 清理构建缓存（可选） #

若同步后问题仍存在，可清理构建缓存：

• 点击菜单栏File -> Invalidate Caches...，选择Invalidate and Restart，重启Android Studio后重新构建项目。

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