AGP7.4.1下为不同变体配置signingConfig生成未签名APK问题

核心问题分析 #

你遇到的问题本质是：虽然通过androidComponents.onVariants设置了签名配置，但签名功能未被启用，或者配置逻辑存在疏漏，导致Gradle依然生成未签名APK。

修复步骤 #

1. 确保Release构建类型开启签名允许 #

在buildTypes.release中添加占位签名配置，让Gradle识别该构建类型需要执行签名逻辑，后续再通过androidComponents替换为实际配置：

buildTypes {
    release {
        // 先设置占位签名配置，确保签名逻辑被启用
        signingConfig signingConfigs.debug
        // 保留你原有其他配置（如minifyEnabled、proguardFiles等）
    }
}

2. 修正androidComponents的签名配置逻辑 #

避免硬编码变体名称（易因Flavor顺序变化出错），通过解析变体的Flavor维度属性匹配对应签名配置，同时显式开启签名开关：

androidComponents {
    onVariants(selector().withBuildType("release")) { variant ->
        // 获取各维度的Flavor值
        val fruitFlavor = variant.productFlavors.find { it.dimension == "fruit" }?.name
        val colorFlavor = variant.productFlavors.find { it.dimension == "color" }?.name

        // 根据Flavor组合匹配目标签名配置
        val targetSigningConfigName = when {
            fruitFlavor == "apple" && colorFlavor == "red" -> "appleRedRelease"
            fruitFlavor == "pear" && colorFlavor == "yellow" -> "pearYellowRelease"
            // 补充其他Flavor组合的签名配置映射
            else -> null
        }

        targetSigningConfigName?.let {
            variant.signingEnabled.set(true)
            variant.signingConfig.setConfig(android.signingConfigs.getByName(it))
        }
    }
}

3. 验证构建结果 #

• 执行命令./gradlew clean assembleRelease，或在Android Studio中选择对应变体执行构建
• 构建完成后检查app/build/outputs/apk/<variantName>/目录，APK文件名不应再带有-unsigned后缀

关键注意事项 #

• AGP 7.x中signingEnabled默认可能为false，必须显式设置为true才能触发签名流程
• 依赖变体名称硬编码易出错，通过Flavor维度属性匹配的方式更具可维护性
• 确保签名配置中的storeFile路径正确、文件存在，否则会直接触发构建报错（而非生成未签名APK）

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