Android Java遗留项目调试时出现debugCompileClasspath依赖解析错误

问题描述 #

维护Android Java遗留代码时，调整SDK版本后出现Gradle错误：Gradle同步正常，但调试时提示无法解析:app:debugCompileClasspath的任务依赖，找不到匹配的:tcn_liftboard项目配置。修改buildToolsVersion无效。

错误信息 #

Could not determine the dependencies of task ':app:compileDebugJavaWithJavac'.
> Could not resolve all task dependencies for configuration ':app:debugCompileClasspath'.
   > Could not resolve project :tcn_liftboard.
     Required by:
         project :app
      > No matching configuration of project :tcn_liftboard was found. The consumer was configured to find an API of a component, preferably optimized for Android, as well as attribute 'com.android.build.api.attributes.BuildTypeAttr' with value 'debug' but:
          - None of the consumable configurations have attributes.

项目配置文件 #

项目级build.gradle #

// Top-level build file where you can add configuration options common to all sub-projects/modules.

buildscript {
    
    repositories {
        google()
        mavenCentral()
    }
    dependencies {
        classpath 'com.android.tools.build:gradle:7.0.3'


        // NOTE: Do not place your application dependencies here; they belong
        // in the individual module build.gradle files
    }
}

allprojects {
    repositories {
        google()
        mavenCentral()
    }
}


ext {
    compileVersion = 31
    buildVersion = '27.0.3'
    minVersion = 18
    targetVersion = 31
    supportVersion = '27.1.1'
    commonsNetVersion = "3.6"
    glideVersion = "4.8.0"
    traypVersion = "0.12.0"
    gsonVersion = "2.8.5"
}

task clean(type: Delete) {
    delete rootProject.buildDir
}

模块级build.gradle #

apply plugin: 'com.android.application'

android {
    compileSdkVersion 31
    buildToolsVersion "30.0.3"
    defaultConfig {
        applicationId "com.tcn.sdk.liftdemo"
        minSdkVersion 18
        targetSdkVersion 31
        versionCode 1
        versionName "1.0.1"
        testInstrumentationRunner "android.support.test.runner.AndroidJUnitRunner"
    }
    buildTypes {
        release {
            minifyEnabled false
            proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'
            android.applicationVariants.all { variant ->
                variant.outputs.all {
                    outputFileName = "TcnSdkLiftDemo-${defaultConfig.versionName}.apk"
                }
            }
        }
    }
    sourceSets {
        main {
            jniLibs.srcDirs = ['src/main/jniLibs']
            aidl.srcDirs = ['src/main/aidl']
        }
    }
}

repositories {
    flatDir {
        dirs 'libs'   // aar目录
    }
}

dependencies {
    implementation fileTree(dir: 'libs', include: ['*.jar'])
    implementation "androidx.appcompat:appcompat:1.5.1"
    testImplementation 'junit:junit:4.12'
    implementation(name: 'sdk_auth_lib-release', ext: 'aar')
    implementation(name: 'tcn_liftboard-release', ext: 'aar')
    implementation project(':tcn_liftboard')
}

问题原因分析 #

1. 重复依赖冲突：模块级build.gradle中同时引用了tcn_liftboard的aar包和项目依赖，两者冲突导致调试时依赖解析混乱。
2. 子项目配置缺失：:tcn_liftboard子项目可能未正确配置Android库插件，导致没有生成符合调试要求的debug配置属性。

解决方案 #

方案一：移除重复依赖 #

模块级build.gradle的dependencies中同时存在aar包和项目依赖，保留其中一种即可：

• 如果:tcn_liftboard是本地子项目，删除aar引用：

dependencies {
    implementation fileTree(dir: 'libs', include: ['*.jar'])
    implementation "androidx.appcompat:appcompat:1.5.1"
    testImplementation 'junit:junit:4.12'
    implementation(name: 'sdk_auth_lib-release', ext: 'aar')
    // 移除aar包引用
    // implementation(name: 'tcn_liftboard-release', ext: 'aar')
    implementation project(':tcn_liftboard')
}

• 如果不需要子项目依赖，保留aar包并删除项目依赖：

dependencies {
    implementation fileTree(dir: 'libs', include: ['*.jar'])
    implementation "androidx.appcompat:appcompat:1.5.1"
    testImplementation 'junit:junit:4.12'
    implementation(name: 'sdk_auth_lib-release', ext: 'aar')
    implementation(name: 'tcn_liftboard-release', ext: 'aar')
    // 移除项目依赖
    // implementation project(':tcn_liftboard')
}

方案二：修复子项目配置 #

如果保留子项目依赖，检查:tcn_liftboard模块的build.gradle，确保应用Android库插件并配置正确的build类型：

apply plugin: 'com.android.library'

android {
    compileSdkVersion 31
    buildToolsVersion "30.0.3"
    defaultConfig {
        minSdkVersion 18
        targetSdkVersion 31
        versionCode 1
        versionName "1.0"
    }
    // 确保存在debug build类型（默认会生成，若被删除需添加）
    buildTypes {
        release {
            minifyEnabled false
            proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'
        }
        debug {
            // 可选配置，比如开启调试信息
        }
    }
}

dependencies {
    // 子项目的依赖配置
}

方案三：同步并清理项目 #

完成上述修改后，执行以下操作：

• 点击Android Studio的File -> Sync Project with Gradle Files重新同步
• 执行Build -> Clean Project清理缓存
• 重启Android Studio后尝试调试

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