原生移动开发 / 系统课时

签名、AAB 与正式发布

签名、AAB 与正式发布

正式发布 Android 应用时,真正需要串起来的是版本号、Release 签名、AAB 构建和商店发布四个环节。本节给出一套可复现的 Release 配置,说明密钥如何安全接入,并把构建产物一直验证到可上传的 App Bundle。

学习目标

  • 正确配置 versionCode、versionName 与 Release 签名
  • 构建并验证签名后的 .aab 产物
  • 理解上传密钥、应用签名以及商店分阶段发布之间的关系

先确定版本与签名职责

versionCode 是系统和商店用来比较版本的新旧标识,每次向同一发布渠道提交新版本时应递增;versionName 是展示给用户看的版本名称,可以采用 1.4.0 这类可读格式。

Release 包必须经过签名。不要把 keystore 密码、key 密码或明文凭据写进仓库。更安全的做法是把 keystore 文件放在受控位置,把路径和密码通过本机环境变量或 CI 的 secret 注入 Gradle。

Android AAB 正式发布与签名链路

在使用 Play App Signing 的流程中,开发者通常用 上传密钥 对上传的 AAB 签名;商店侧再使用受保护的 应用签名密钥 为最终分发到设备的 APK 签名。两把密钥职责不同,不要把上传密钥等同于最终应用签名密钥。

配置 Release 构建

下面以 Kotlin DSL 的 app/build.gradle.kts 为例。假设 keystore 已存在,四个环境变量在执行 Release 构建前已经注入。

kotlin
android {
    namespace = "com.example.release"
    compileSdk = 36

    defaultConfig {
        applicationId = "com.example.release"
        minSdk = 24
        targetSdk = 36
        versionCode = 42
        versionName = "1.4.0"
    }

    signingConfigs {
        create("release") {
            storeFile = file(providers.environmentVariable("ANDROID_KEYSTORE_FILE").get())
            storePassword = providers.environmentVariable("ANDROID_KEYSTORE_PASSWORD").get()
            keyAlias = providers.environmentVariable("ANDROID_KEY_ALIAS").get()
            keyPassword = providers.environmentVariable("ANDROID_KEY_PASSWORD").get()
        }
    }

    buildTypes {
        getByName("release") {
            signingConfig = signingConfigs.getByName("release")
            isDebuggable = false
        }
    }
}

生效行为:Release variant 会使用指定 keystore 完成签名,并把版本信息写入构建产物。如果任一环境变量缺失,Gradle 在配置阶段就会失败,这比静默生成未按预期签名的产物更安全。

构建并验证 AAB

先在终端注入当前环境需要的值,再构建 Release App Bundle。占位符需替换为真实路径和凭据,实际环境中更推荐由 CI secret 管理这些变量。

bash
export ANDROID_KEYSTORE_FILE="<PATH>/release.jks"
export ANDROID_KEYSTORE_PASSWORD="<VALUE>"
export ANDROID_KEY_ALIAS="upload"
export ANDROID_KEY_PASSWORD="<VALUE>"
./gradlew clean bundleRelease

预期输出:

text
> Task :app:bundleRelease
BUILD SUCCESSFUL in <TIME>

默认情况下,产物位于 app/build/outputs/bundle/release/app-release.aab。<TIME> 与构建缓存、机器性能有关,实际值会不同。

AAB 是面向应用商店的发布格式,不应把它当成“所有设备直接安装的单一 APK”。上传后,商店会根据设备配置生成并分发合适的 APK 集合。构建完成后,可以先验证 Bundle 是否带有有效签名:

bash
jarsigner -verify -verbose -certs app/build/outputs/bundle/release/app-release.aab

预期输出:

text
jar verified.

如果出现未签名、证书链或 keystore 相关错误,应先停止上传,重新核对 Release signingConfig 和实际注入的密钥,再重建产物。

上传前做最后检查

发布前至少核对应用 ID、versionCode、versionName、Release 签名和关键功能测试结果。上传到商店后,先使用内部测试或小范围测试轨道验证安装、升级和核心业务,再逐步扩大发布范围,比直接全量发布更容易控制风险。

当新版本已经提交后,不要尝试复用旧的 versionCode。若应用启用了 Play App Signing,也应分别管理上传密钥与应用签名密钥的责任边界;前者用于证明“谁有权上传”,后者决定用户设备最终接受哪一个签名身份。

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

目录与阅读设置

阅读设置

17

记录一个想法

签名、AAB 与正式发布

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

登录哪都通