Android Kotlin DSL下如何按条件执行externalNativeBuild配置

• 路径判断逻辑错误：直接使用File("相对路径")时，路径基准是Gradle Daemon的启动工作目录，并非当前库模块的根目录，大概率会误判CMakeLists.txt不存在，导致externalNativeBuild配置根本没有被注册，release构建时也不会编译原生库，最终触发so找不到的崩溃。
• 配置时机错误：你的判断逻辑运行在Gradle 配置阶段，而CMakeLists.txt是在构建执行阶段才生成的，配置阶段文件还未创建，自然不会触发原生构建配置。
• 配置作用域错误：externalNativeBuild是模块级的AGP配置项，不支持直接写在buildTypes块内，写在内部不会被AGP识别生效。
• 变体配置缺失：debug构建时如果没有主动禁用原生构建任务、排除so打包逻辑，AGP会默认尝试查找并打包so文件，找不到时要么编译报错要么运行时崩溃。

直接在库模块的build.gradle.kts中使用以下配置，完全满足两个触发条件：

android {
    namespace = "your.library.package"
    compileSdk = 34

    defaultConfig {
        minSdk = 21
        // 其余defaultConfig常规配置
    }

    buildTypes {
        release {
            isMinifyEnabled = false
            proguardFiles(getDefaultProguardFile("proguard-android-optimize.txt"), "proguard-rules.pro")
        }
        debug {
            // debug常规配置
        }
    }

    // 用project.file()获取模块级绝对路径，彻底解决路径基准错误问题
    val cmakeFile = project.file("src/main/cpp/CMakeLists.txt")
    // 满足两个条件任意一个就启用原生构建配置：1.release构建 2.CMakeLists.txt已存在
    val shouldEnableNativeBuild = gradle.startParameter.taskRequests.any { taskReq ->
        taskReq.args.any { it.contains("Release", ignoreCase = true) }
    } || cmakeFile.exists()

    if (shouldEnableNativeBuild) {
        externalNativeBuild {
            cmake {
                path = cmakeFile
                // 按需填写你的cmake配置，比如cppFlags、abiFilters等
            }
        }
    }
}

// 变体级任务配置，避免无效构建和运行时崩溃
androidComponents {
    onVariants { variant ->
        if (variant.buildType == "debug") {
            // 禁用debug下所有原生构建相关任务
            tasks.configureEach {
                if (name.contains("externalNativeBuildDebug", ignoreCase = true)
                    || name.contains("CompileDebugJni", ignoreCase = true)
                    || name.contains("MergeDebugJniLibFolders", ignoreCase = true)
                ) {
                    enabled = false
                }
            }
            // 排除debug下的so查找逻辑，避免打包时强制找so
            android.sourceSets.getByName("debug") {
                jniLibs.exclude("**/*.so")
            }
        }

        if (variant.buildType == "release") {
            // 把CMakeLists.txt生成逻辑绑定到release预构建任务，确保cmake执行前文件已生成
            tasks.named("preBuildRelease") {
                doFirst {
                    if (!cmakeFile.exists()) {
                        // 替换成你自己的CMakeLists.txt生成逻辑，比如执行生成脚本
                        // exec { commandLine("your_generate_cmake_script.sh") }
                        throw GradleException("Release构建需CMakeLists.txt，当前文件不存在，请先执行生成逻辑")
                    }
                }
            }
        }
    }
}

• 业务代码中需要加构建类型判断，debug构建下不要调用System.loadLibrary("mylibrary")，否则debug包没有内置so时依然会触发启动崩溃。
• 如果你的CMakeLists.txt生成逻辑依赖其他任务，记得给preBuildRelease加上任务依赖，确保生成任务先执行。
• 配置修改后先执行./gradlew clean再同步Gradle，避免旧的构建缓存影响结果。

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