原生移动开发 / 系统课时
区分 Debug 与 Release 构建
区分 Debug 与 Release 构建
Android 项目中的 Debug 和 Release 不只是两个不同文件名,而是面向开发调试与正式交付的两套构建配置。本节通过构建、签名、调试能力和优化策略的对比,明确什么样的产物才具备正式发布的基础条件。
学习目标
- 区分 Debug 与 Release 在签名、调试能力和构建配置上的差异
- 理解 Release 构建并不等于已经满足正式发布条件
- 能通过 Gradle 生成并检查 Release 构建产物
两种构建面向不同场景
Android Gradle Plugin 通常至少提供 debug 和 release 两个 build type。Debug 主要服务于开发阶段,需要快速构建、方便连接调试器;Release 面向测试、分发和正式发布,因此更强调不可调试、稳定签名以及可选的代码优化。
| 对比项 | Debug | Release |
|---|---|---|
| 主要用途 | 开发、联调、问题定位 | 测试、分发、应用市场发布 |
| 调试能力 | 默认可调试 | 默认不可调试 |
| 签名 | 通常自动使用 Debug 签名 | 需要正式签名方案 |
| 代码压缩 | 通常关闭 | 可按配置启用 R8 压缩和混淆 |
| 构建配置 | 偏向开发效率 | 偏向稳定交付与发布要求 |
实际生成 Release 构建
在包含 app 应用模块的标准 Gradle 项目根目录,可以直接执行 Release 构建。以下命令生成 Release APK;如果项目没有配置正式签名,生成的 APK 可能仍然是未签名产物。
# 构建 app 模块的 Release APK
./gradlew :app:assembleRelease预期输出(关键结果)
BUILD SUCCESSFUL in <TIME><TIME> 会随机器性能、缓存状态和项目规模变化。构建成功只说明 Gradle 完成了对应任务,还应继续检查生成产物是否使用了预期签名和发布配置。
如果准备向支持 Android App Bundle 的应用市场提交版本,项目通常还会生成 AAB:
# 构建用于发布的 Android App Bundle
./gradlew :app:bundleRelease预期输出(关键结果)
BUILD SUCCESSFUL in <TIME>典型项目会在 <PATH>/app/build/outputs/bundle/release/ 下生成 Release AAB;实际路径会受到模块名和工程结构影响。
Release 必须重点检查签名
Debug 构建通常由开发工具自动使用 Debug keystore 签名,因此开发者几乎感觉不到签名步骤。Release 则不能依赖这套开发签名,因为应用升级要求新版本能够延续既有的签名身份。
如果使用 Google Play App Signing,需要进一步区分两个概念:上传密钥用于开发者向 Play 提交版本,应用签名密钥用于给最终分发给用户的 APK 签名。两者可以由 Play 的签名流程分别管理,因此不能简单理解成“上传的 AAB 用哪个密钥签名,用户安装的 APK 就一定是同一个密钥”。
正式发布还需要满足哪些条件
一次 assembleRelease 或 bundleRelease 成功,只证明构建链路可以产生产物。准备正式提交前,至少还要确认应用版本号、签名身份、目标环境配置以及测试结果正确。
尤其要检查 Release 是否误带测试服务器地址、调试开关、测试账号或日志配置。很多发布事故并不是代码无法编译,而是开发环境配置被一起打进了正式包。
因此可以把两者的边界记成一句话:Debug 是为了让开发过程更容易观察和修改,Release 是为了生成可交付版本;而“可交付”仍然需要经过签名、测试和发布检查,不能只看 Gradle 是否显示 BUILD SUCCESSFUL。