跨平台开发 / 系统课时

配置 Android 发布签名

配置 Android 发布签名

本篇解决 Flutter 应用发布到 Android 应用商店前的签名配置问题,完成 keystore 创建、安全保存以及 release 构建关联,让产物具备正式发布条件。

学习目标

  • 理解 Android 发布签名与 debug 签名的区别
  • 创建 keystore 并配置 Flutter Android release 构建
  • 掌握签名文件安全管理和验证方法

创建发布 keystore

Android 发布版本必须使用开发者自己的签名密钥。debug 构建通常由开发工具自动生成签名,而正式发布需要长期保存的 keystore。

可以使用 JDK 提供的 keytool 创建签名文件。下面示例中的路径和密码应替换为项目实际值。

bash
keytool -genkeypair -v -keystore <PATH>/upload-keystore.jks -keyalg RSA -keysize 2048 -validity 10000 -alias <ID>

预期输出

text
Generating 2,048 bit RSA key pair and self-signed certificate...
Enter keystore password:
Enter key password:
[Storing <PATH>/upload-keystore.jks]

创建完成后,建议不要把 keystore 提交到公开代码仓库,而是通过安全存储或 CI/CD 密钥管理服务保存。

配置 Flutter release 签名

Flutter Android 项目的签名配置位于 Android Gradle 工程中。通常通过 key.properties 保存密钥引用,再由 Gradle release 构建读取。

在 android/key.properties 中配置:

properties
storePassword=<STORE_PASSWORD>
keyPassword=<KEY_PASSWORD>
keyAlias=<ID>
storeFile=<PATH>/upload-keystore.jks

然后在 android/app/build.gradle 的 Android 配置中加载签名信息:

gradle
android {
    signingConfigs {
        release {
            def keystoreProperties = new Properties()
            def keystorePropertiesFile = rootProject.file('key.properties')
            if (keystorePropertiesFile.exists()) {
                keystoreProperties.load(new FileInputStream(keystorePropertiesFile))
            }
            keyAlias keystoreProperties['keyAlias']
            keyPassword keystoreProperties['keyPassword']
            storeFile keystoreProperties['storeFile'] ? file(keystoreProperties['storeFile']) : null
            storePassword keystoreProperties['storePassword']
        }
    }
}

配置生效后,release 构建会使用指定 keystore 签名,而不是默认 debug 密钥。

验证签名配置

可以通过构建 release APK 验证 Gradle 是否正确读取签名配置。

bash
flutter build apk --release

预期输出

text
Running Gradle task 'assembleRelease'...
✓ Built build/app/outputs/flutter-apk/app-release.apk

常见签名问题

如果发布时提示签名不匹配,通常不是 Flutter 代码问题,而是使用了不同 keystore 重新生成安装包。应用商店会根据签名判断应用身份,因此发布后应长期保留原始签名文件。

CI 环境中应通过环境变量或密钥服务注入密码,而不是把明文凭据写入构建脚本。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

配置 Android 发布签名

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通