原生移动开发 / 系统课时

用 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 前设置四个签名环境变量。

kotlin
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>。

bash
export ANDROID_KEYSTORE_PATH=<PATH>
export ANDROID_KEYSTORE_PASSWORD=<PASSWORD>
export ANDROID_KEY_ALIAS=<ALIAS>
export ANDROID_KEY_PASSWORD=<PASSWORD>
./gradlew :app:assembleRelease

预期输出

text
BUILD SUCCESSFUL

Gradle 还会输出多个任务名称、执行状态和耗时,这些内容会随缓存命中情况和项目规模变化。使用模块限定任务 :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 的实际路径。

bash
apksigner verify <PATH_TO_APK>
echo $?

预期输出

text
0

apksigner 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。

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

目录与阅读设置

阅读设置

17

记录一个想法

用 Gradle 构建 Release APK

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

登录哪都通