Android升级Gradle 8后变体间隐式依赖错误排查求助

我有一个包含4个变体的Android应用，使用Bitrise在develop分支执行以下命令验证代码：

./gradlew "testDevADebugUnitTestCoverage" "testDevBDebugUnitTest" "testDevCDebugUnitTest" "testDevCDebugUnitTest" "--continue" "-PjacocoEnabled=true"

近期通过Android Studio的AGP升级助手将Gradle升级到8、AGP升级到8.0.1后，本地或Bitrise运行上述命令时出现多个类似如下的错误，涉及KotlinCompile、JacocoReport、MergeSourceSetFolders、ProcessTestManifest等多种任务：

Some problems were found with the configuration of task ':domain:compileDevADebugKotlin' (type 'KotlinCompile').
  - Gradle detected a problem with the following location: '/Users/MyUser/Developer/yapp/domain/build/tmp/kotlin-classes/devADebug'.

    Reason: Task ':domain:testDevBDebugUnitTestCoverage' uses this output of task ':domain:compileDevADebugKotlin' without declaring an explicit or implicit dependency. This can lead to incorrect results being produced, depending on what order the tasks are executed.

    Possible solutions:
      1. Declare task ':domain:compileDevADebugKotlin' as an input of ':domain:testDevBDebugUnitTestCoverage'.
      2. Declare an explicit dependency on ':domain:compileDevADebugKotlin' from ':domain:testDevBDebugUnitTestCoverage' using Task#dependsOn.
      3. Declare an explicit dependency on ':domain:compileDevADebugKotlin' from ':domain:testDevBDebugUnitTestCoverage' using Task#mustRunAfter.

我已尝试将Jacoco升级至最新版本0.8.10，但问题仍未解决（不确定是否为Jacoco问题）。附上我的jacoco.gradle文件：

apply plugin: 'jacoco'
apply from: "$project.rootDir/test_coverage_excludes.gradle"

jacoco {
    toolVersion = libs.versions.jacocoVersion.get()
    reportsDir = file("$buildDir/reports/jacoco")
}

android {
    testOptions {
        unitTests.all {
            jacoco {
                // Required for tests ran with RobolectricTestRunner to be included in coverage
                includeNoLocationClasses = true

                // Required for execution using Java 11
                excludes = ['jdk.internal.*']
            }
        }
    }
}

project.afterEvaluate {
    def variants

    if (android.hasProperty('applicationVariants')) {
        variants = android.applicationVariants.collect { it.name }
    } else {
        variants = android.libraryVariants.collect { it.name }
    }

    variants = variants.findAll { it.endsWith("Debug") || it.endsWith("debug") }

    // Generate a coverage report for each variant
    variants.each { variantName ->
        def unitTestTaskName = "test${variantName.capitalize()}UnitTest"
        def coverageTaskName = "${unitTestTaskName}Coverage"

        // Create the coverage tasks
        task(coverageTaskName, type: JacocoReport, dependsOn: "$unitTestTaskName") {
            group = "Reporting"
            description "Generate coverage reports for ${variantName.capitalize()}."

            // Location of Kotlin classes
            def kotlinClassDirectory = "$buildDir/tmp/kotlin-classes/$variantName"
            def kotlinClassTree = fileTree(dir: kotlinClassDirectory, excludes: fileFilter)
            getClassDirectories().setFrom(files([kotlinClassTree]))

            // Location of the actual source
            def coverageSourceDirs = [
                    "src/main/java",
                    "src/$variantName/java"
            ]

            getAdditionalSourceDirs().setFrom(coverageSourceDirs)
            getSourceDirectories().setFrom(coverageSourceDirs)

            // Include both unit test and instrumentation test execution data
            executionData.setFrom(fileTree(dir: buildDir, includes: ['**/*.exec', '**/*.ec']))

            reports {
                xml.getRequired().set(true)
                html.getRequired().set(true)
                csv.getRequired().set(false)
            }
        }
    }
}

Gradle 8+对任务依赖的检查更严格，问题根源是Jacoco任务直接引用编译输出的硬编码路径，未明确依赖对应的编译任务，导致跨变体的隐式依赖冲突。以下是具体修复步骤：

1. 关联编译任务输出而非硬编码路径 #

不要直接使用$buildDir/tmp/kotlin-classes/$variantName这种固定路径，而是通过变体对象获取编译任务的输出目录，让Gradle自动识别任务依赖。

修改jacoco.gradle中Jacoco任务的classDirectories配置：

// 获取当前变体对象
def variant = android.applicationVariants.find { it.name == variantName } ?: android.libraryVariants.find { it.name == variantName }
// 获取对应变体的Kotlin和Java编译任务
def kotlinCompileTask = variant.getCompileTaskName("kotlin")
def javaCompileTask = variant.getCompileTaskName("java")

// 替换原来的硬编码路径配置
getClassDirectories().setFrom(
    files(
        tasks.named(kotlinCompileTask).map { it.destinationDirectory },
        tasks.named(javaCompileTask).map { it.destinationDirectory }
    ).filter { it.exists() }.asFileTree.matching { exclude fileFilter }
)

2. 限定executionData的范围 #

原配置会扫描所有变体的测试执行数据，导致跨变体依赖冲突，需限定为当前变体的测试数据：

// 替换原来的executionData配置
executionData.setFrom(
    files(
        tasks.named(unitTestTaskName).map { it.jacocoDestinationFile },
        fileTree(dir: "$buildDir/outputs/code_coverage/${variantName}AndroidTest/connected", includes: ['**/*.ec'])
    )
)

3. 完整修改后的核心代码块 #

更新后的project.afterEvaluate部分如下：

project.afterEvaluate {
    def variants

    if (android.hasProperty('applicationVariants')) {
        variants = android.applicationVariants.collect { it.name }
    } else {
        variants = android.libraryVariants.collect { it.name }
    }

    variants = variants.findAll { it.endsWith("Debug") || it.endsWith("debug") }

    // Generate a coverage report for each variant
    variants.each { variantName ->
        def unitTestTaskName = "test${variantName.capitalize()}UnitTest"
        def coverageTaskName = "${unitTestTaskName}Coverage"
        // 获取当前变体对象
        def variant = android.applicationVariants.find { it.name == variantName } ?: android.libraryVariants.find { it.name == variantName }

        // Create the coverage tasks
        task(coverageTaskName, type: JacocoReport, dependsOn: [unitTestTaskName]) {
            group = "Reporting"
            description "Generate coverage reports for ${variantName.capitalize()}."

            // 关联编译任务输出，自动建立依赖
            def kotlinCompileTask = variant.getCompileTaskName("kotlin")
            def javaCompileTask = variant.getCompileTaskName("java")
            getClassDirectories().setFrom(
                files(
                    tasks.named(kotlinCompileTask).map { it.destinationDirectory },
                    tasks.named(javaCompileTask).map { it.destinationDirectory }
                ).filter { it.exists() }.asFileTree.matching { exclude fileFilter }
            )

            // Location of the actual source
            def coverageSourceDirs = [
                    "src/main/java",
                    "src/$variantName/java"
            ]

            getAdditionalSourceDirs().setFrom(coverageSourceDirs)
            getSourceDirectories().setFrom(coverageSourceDirs)

            // 仅使用当前变体的测试执行数据
            executionData.setFrom(
                files(
                    tasks.named(unitTestTaskName).map { it.jacocoDestinationFile },
                    fileTree(dir: "$buildDir/outputs/code_coverage/${variantName}AndroidTest/connected", includes: ['**/*.ec'])
                )
            )

            reports {
                xml.getRequired().set(true)
                html.getRequired().set(true)
                csv.getRequired().set(false)
            }
        }
    }
}

4. 额外注意事项 #

• 确保每个变体的Jacoco任务仅处理自身的编译输出和测试数据，避免跨变体的文件引用。
• Gradle 8+中，引用其他任务的输出必须通过任务对象的属性获取，禁止直接使用硬编码路径，否则会触发隐式依赖警告。

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