原生移动开发 / 系统课时
用 Gradle 构建 Release APK
用 Gradle 构建 Release APK
Release APK 不是把 Debug 包改个名字,而是由 release 构建类型、签名配置以及可选的压缩混淆规则共同决定。掌握命令行构建和验证方法后,可以在本地或 CI 中稳定生成可提交、可追踪的发布产物。
学习目标
- 使用 Gradle Wrapper 执行
assembleRelease并找到生成的 APK。 - 理解
release构建类型与签名配置如何影响最终产物。 - 在构建后验证 APK 是否已经使用预期签名。
构建前确认 Release 配置
Android Gradle Plugin 会根据构建类型决定打包属性;release 通常用于发布,可配置代码压缩、资源收缩和发布签名。Android 官方文档也将 Release 构建描述为可由 Gradle 自动完成构建、优化与签名的发布流程。([Android Developers][3])
下面是 app/build.gradle.kts 中的片段示例,依赖上下文是项目已经应用 Android Application 插件,并在执行 Gradle 前设置四个签名环境变量。
val keystorePath = providers.environmentVariable("ANDROID_KEYSTORE_PATH")
val keystorePassword = providers.environmentVariable("ANDROID_KEYSTORE_PASSWORD")
val keyAliasName = providers.environmentVariable("ANDROID_KEY_ALIAS")
val keyPasswordValue = providers.environmentVariable("ANDROID_KEY_PASSWORD")
android {
signingConfigs {
create("release") {
// 发布密钥信息从环境变量读取,避免把口令硬编码进仓库。
storeFile = file(keystorePath.get())
storePassword = keystorePassword.get()
keyAlias = keyAliasName.get()
keyPassword = keyPasswordValue.get()
}
}
buildTypes {
getByName("release") {
signingConfig = signingConfigs.getByName("release")
// 是否启用 R8 应由项目的发布策略决定。
isMinifyEnabled = false
}
}
}这段配置生效后,release 变体会使用名为 release 的签名配置。验证重点不是“配置文件能解析”就结束,而是后续生成的 APK 确实可通过签名校验。
执行 assembleRelease
在项目根目录执行 Gradle Wrapper。下面使用动态占位符保存敏感值和本机路径;实际执行前要替换 <PATH>、<PASSWORD> 与 <ALIAS>。
export ANDROID_KEYSTORE_PATH=<PATH>
export ANDROID_KEYSTORE_PASSWORD=<PASSWORD>
export ANDROID_KEY_ALIAS=<ALIAS>
export ANDROID_KEY_PASSWORD=<PASSWORD>
./gradlew :app:assembleRelease预期输出
BUILD SUCCESSFULGradle 还会输出多个任务名称、执行状态和耗时,这些内容会随缓存命中情况和项目规模变化。使用模块限定任务 :app:assembleRelease 可以明确只构建 app 模块的 Release APK;Windows 环境可使用 gradlew.bat 调用同一任务。
找到并验证 APK
标准 app 模块的 Release APK 通常输出到 app/build/outputs/apk/release/。应用了上面的发布签名后,常见文件名为 app-release.apk;如果看到名称包含 unsigned,应先检查 release 是否真正引用了签名配置。
签名验证可以使用 Android SDK Build Tools 提供的 apksigner。<PATH_TO_APK> 应替换为刚生成 APK 的实际路径。
apksigner verify <PATH_TO_APK>
echo $?预期输出
0apksigner verify 在验证成功时以退出码 0 结束;这里通过 echo $? 显式查看上一条命令的退出码。如果需要确认究竟是哪张证书签名,可再使用 apksigner verify --print-certs <PATH_TO_APK> 查看证书信息,但不要把私钥文件或口令写入构建日志。
构建失败时先看这几处
如果 Gradle 在读取签名配置时就失败,先检查四个环境变量是否存在,以及 <PATH> 指向的 keystore 文件是否可读。路径错误、别名错误或口令错误都会导致构建失败,不应通过删除发布签名配置来“让构建先过”。
如果 assembleRelease 成功但得到未签名 APK,重点检查 buildTypes.release.signingConfig 是否绑定到正确配置。如果启用了 isMinifyEnabled = true 后才失败,则应转而查看 R8 报错和混淆规则,因为这属于 Release 特有的代码收缩阶段。
完成构建后至少确认三件事:Gradle 任务成功、APK 位于预期 Release 目录、apksigner verify 返回成功。只有这三项同时成立,才说明当前命令行流程真正产出了可进入后续发布环节的 Release APK。