Flutter+Azure DevOps：无需Git共享密钥文件实现本地与流水线签名

解决方案 #

1. 修改Android项目的build.gradle，适配双环境签名逻辑 #

让Gradle根据本地是否存在key.properties自动切换签名模式，避免流水线因缺失配置报错：

def keystorePropertiesFile = rootProject.file('key.properties')
def keystoreProperties = new Properties()

// 仅本地存在key.properties时加载签名配置
if (keystorePropertiesFile.exists()) {
    keystoreProperties.load(new FileInputStream(keystorePropertiesFile))
}

android {
    // 保留原有compileSdkVersion、defaultConfig等配置

    signingConfigs {
        release {
            // 本地有配置才填充签名参数，流水线无配置则留空
            if (keystorePropertiesFile.exists()) {
                keyAlias keystoreProperties['keyAlias']
                keyPassword keystoreProperties['keyPassword']
                storeFile keystoreProperties['storeFile'] ? file(keystoreProperties['storeFile']) : null
                storePassword keystoreProperties['storePassword']
            }
        }
    }

    buildTypes {
        release {
            // 本地有配置时用release签名，流水线无配置时生成未签名APK
            if (keystorePropertiesFile.exists()) {
                signingConfig signingConfigs.release
            }
            shrinkResources false
            minifyEnabled false
        }
    }
}

2. 本地环境配置 #

• 在Android项目的android/目录下新建key.properties文件，内容参考如下：

  storePassword=你的密钥库密码
  keyPassword=你的密钥密码
  keyAlias=upload
  storeFile=../upload-keystore.jks # 替换为你本地JKS文件的实际路径（相对/绝对均可）
  

• 将敏感文件加入.gitignore，禁止提交到Git：

  # Android签名敏感文件
  android/key.properties
  android/upload-keystore.jks
  

3. Azure DevOps流水线调整 #

确保流水线能安全获取签名文件，同时Gradle构建不触发验证错误：

3.1 上传签名文件到Azure Secure Files

登录Azure DevOps项目，进入Pipelines > Library > Secure Files，上传你的upload-keystore.jks文件。

3.2 修改流水线YAML配置

添加下载签名文件的任务，将文件复制到指定目录后，保留原有的签名任务：

# 从Azure Secure Files下载签名文件
- task: DownloadSecureFile@1
  name: keystoreFile
  inputs:
    secureFile: 'upload-keystore.jks' # 需与Secure Files中上传的文件名完全一致

# 将签名文件复制到Android项目的app目录，确保签名任务能找到
- task: CopyFiles@2
  inputs:
    sourceFolder: $(keystoreFile.secureFilePath)
    targetFolder: $(Build.SourcesDirectory)/android/app
    contents: 'upload-keystore.jks'

# 保留原有的签名任务无需修改
- task: AndroidSigning@3
  displayName: 'Signing and aligning APK file(s) **/*.apk'
  inputs:
    apkFiles: '**/*.apk'
    apksign: true
    apksignerKeystoreFile: upload-keystore.jks
    apksignerKeystorePassword: $(upload-keystore-password)
    apksignerKeystoreAlias: upload
    apksignerKeyPassword: $(upload-keystore-password)

逻辑说明 #

• 本地环境：存在key.properties和JKS文件时，Gradle自动使用release签名配置，执行flutter build apk直接生成签名APK。
• 流水线环境：无key.properties文件，Gradle跳过签名配置生成未签名APK，随后通过AndroidSigning@3任务使用Azure存储的签名文件完成签名，全程无需提交敏感信息到Git。

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