如何通过Gradle注入属性启用Android V3/V4签名？

核心问题原因 #

通过Fastlane注入android.injected.signing.*系列属性时，Android Gradle Plugin（AGP）会自动生成临时的signingConfig，完全覆盖你在app/build.gradle中手动配置的release签名规则，包括V3/V4签名的启用开关。目前官方仅支持通过注入属性控制V1/V2签名，没有提供V3/V4的对应注入属性。

可行解决方案 #

方案1：修改build.gradle，复用注入属性并保留签名配置 #

不让AGP自动生成签名配置，而是在app/build.gradle中手动读取注入的签名属性，同时保留V3/V4签名的开关设置：

// app/build.gradle
signingConfigs {
    release {
        // 保留V3/V4签名配置
        enableV3Signing true
        enableV4Signing true // 按需开启V4
        
        // 读取Fastlane注入的签名属性，fallback值可根据实际情况调整
        storeFile file(project.findProperty("android.injected.signing.store.file") ?: "默认密钥库路径")
        storePassword project.findProperty("android.injected.signing.store.password") ?: "默认存储密码"
        keyAlias project.findProperty("android.injected.signing.key.alias") ?: "默认密钥别名"
        keyPassword project.findProperty("android.injected.signing.key.password") ?: "默认密钥密码"
    }
}

buildTypes {
    release {
        signingConfig signingConfigs.release
        // 其他release配置
    }
}

Fastlane中的gradle任务无需修改，保持原有的属性注入即可：

gradle(
  task: "assemble",
  build_type: "Release",
  project_dir: 'android/',
  flavor: "Dev",
  properties: {
    "android.injected.signing.store.file" => "android/app/debug.keystore",
    "android.injected.signing.store.password" => "android",
    "android.injected.signing.key.alias" => "androiddebugkey",
    "android.injected.signing.key.password" => "android" 
  }
)

方案2：自定义注入属性控制V3/V4开关 #

如果需要通过Fastlane动态控制V3/V4的启用状态，可以在app/build.gradle中读取自定义属性：

// app/build.gradle
signingConfigs {
    release {
        // 通过自定义属性控制V3/V4，默认值可调整
        enableV3Signing project.findProperty("android.signing.v3.enabled")?.toBoolean() ?: true
        enableV4Signing project.findProperty("android.signing.v4.enabled")?.toBoolean() ?: false
        
        // 读取注入的签名信息
        storeFile file(project.findProperty("android.injected.signing.store.file") ?: "")
        storePassword project.findProperty("android.injected.signing.store.password") ?: ""
        keyAlias project.findProperty("android.injected.signing.key.alias") ?: ""
        keyPassword project.findProperty("android.injected.signing.key.password") ?: ""
    }
}

Fastlane任务中添加自定义属性：

gradle(
  task: "assemble",
  build_type: "Release",
  project_dir: 'android/',
  flavor: "Dev",
  properties: {
    "android.injected.signing.store.file" => "android/app/debug.keystore",
    "android.injected.signing.store.password" => "android",
    "android.injected.signing.key.alias" => "androiddebugkey",
    "android.injected.signing.key.password" => "android",
    "android.signing.v3.enabled" => "true",
    "android.signing.v4.enabled" => "true"
  }
)

方案3：通过afterEvaluate手动关联注入属性 #

在app/build.gradle中添加afterEvaluate逻辑，当检测到注入的签名属性时，将值赋值给已有的release签名配置，避免AGP自动覆盖：

// app/build.gradle
signingConfigs {
    release {
        enableV3Signing true
        // 其他默认签名配置（可选，会被注入属性覆盖）
    }
}

afterEvaluate {
    def injectedStoreFile = project.findProperty("android.injected.signing.store.file")
    if (injectedStoreFile != null) {
        signingConfigs.release.apply {
            storeFile file(injectedStoreFile)
            storePassword project.findProperty("android.injected.signing.store.password")
            keyAlias project.findProperty("android.injected.signing.key.alias")
            keyPassword project.findProperty("android.injected.signing.key.password")
        }
    }
}

关于官方支持的说明 #

目前AGP没有提供注入V3/V4签名开关的官方属性，你可以向Google的Issue Tracker提交功能请求，但这属于官方迭代范畴，短期内无法落地。

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