跨平台开发 / 系统课时
配置 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 环境中应通过环境变量或密钥服务注入密码,而不是把明文凭据写入构建脚本。
按自己的节奏,确认真正理解。