Android Studio构建含C++库应用时隐式任务依赖错误求助

问题背景 #

近期搭建了一个包含原生C库的Android应用，环境配置为Gradle 8.0、AGP 7.4.2、JDK 11、C14。应用依赖一个含原生C++代码的模块，该模块会从私有Maven仓库下载远程AAR文件，下载后自动提取出包含4种ABI及对应.so文件的jni目录，已在CMakeLists.txt中完成.so文件的链接配置。

执行构建命令 ./gradlew :app:assembleDebug 时触发错误，但在Gradle 6.5 + AGP 4.1.1的旧环境下构建完全正常。

错误详情 #

***************** ERROR OUTPUT START ***********************

FAILURE: Build failed with an exception.

* What went wrong:
A problem was found with the configuration of task ':app:externalNativeBuildPqrDebug' (type 'ExternalNativeBuildTask').
  - Gradle detected a problem with the following location: '<private>/AndroidStudioProjects/SFIOTestApp/app/build/intermediates/cxx/Debug/1y181390'.
    
    Reason: Task ':app:mergeNonpqrDebugNativeLibs' uses this output of task ':app:externalNativeBuildPqrDebug' 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 ':app:externalNativeBuildPqrDebug' as an input of ':app:mergeNonpqrDebugNativeLibs'.
      2. Declare an explicit dependency on ':app:externalNativeBuildPqrDebug' from ':app:mergeNonpqrDebugNativeLibs' using Task#dependsOn.
      3. Declare an explicit dependency on ':app:externalNativeBuildPqrDebug' from ':app:mergeNonpqrDebugNativeLibs' using Task#mustRunAfter.
    
    Please refer to https://docs.gradle.org/8.0/userguide/validation_problems.html#implicit_dependency for more details about this problem.

***************** ERROR OUTPUT END ***********************

注：Pqr和Nonpqr是自定义的构建变体，Debug为构建类型，两个任务均为AGP自动生成的隐式任务。

解决方案 #

1. 显式声明任务依赖（推荐） #

在app模块的build.gradle（或build.gradle.kts）中，为mergeNonpqrDebugNativeLibs任务添加对externalNativeBuildPqrDebug的依赖：

Groovy DSL

tasks.named('mergeNonpqrDebugNativeLibs') {
    dependsOn 'externalNativeBuildPqrDebug'
}

Kotlin DSL

tasks.named("mergeNonpqrDebugNativeLibs") {
    dependsOn("externalNativeBuildPqrDebug")
}

如果硬编码任务名不生效，可通过变体匹配动态关联任务：

android {
    applicationVariants.all { variant ->
        if (variant.name == "nonpqrDebug") {
            def mergeTask = tasks.named("merge${variant.name.capitalize()}NativeLibs")
            def externalNativeTask = tasks.named("externalNativeBuildPqrDebug")
            mergeTask.configure {
                dependsOn externalNativeTask
            }
        }
    }
}

2. 调整构建变体配置 #

AGP 7.x对构建变体的任务生成逻辑做了优化，自定义变体名称若存在前缀/后缀冲突，可能导致自动依赖链断裂。检查productFlavors配置，确保变体划分清晰且无命名冲突：

android {
    flavorDimensions "variant"
    productFlavors {
        pqr {
            dimension "variant"
            // 其他配置
        }
        nonpqr {
            dimension "variant"
            // 其他配置
        }
    }
}

同时确保CMake配置中明确指定了对应变体的ABI过滤：

android {
    defaultConfig {
        externalNativeBuild {
            cmake {
                abiFilters 'armeabi-v7a', 'arm64-v8a', 'x86', 'x86_64'
            }
        }
    }
}

3. 临时禁用Gradle隐式依赖检查（应急方案） #

如果以上方法均无法快速解决，可临时降低Gradle的依赖验证级别，将错误转为警告，保证构建先通过：
在项目根目录的gradle.properties中添加：

org.gradle.validation.warning.mode=warn

或在settings.gradle中配置：

validation {
    implicitDependencies = "warn"
}

注意：此方案仅作临时应急，长期使用可能掩盖潜在的构建顺序问题。

问题根源 #

Gradle 8.0引入了更严格的任务依赖验证机制，而AGP 7.4.2对自定义构建变体的任务关联逻辑进行了调整。旧版本AGP/Gradle会自动处理这类跨变体的隐式依赖，新版本则要求显式声明，否则会触发验证错误。

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