原生移动开发 / 系统课时

区分 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 可能仍然是未签名产物。

bash
# 构建 app 模块的 Release APK
./gradlew :app:assembleRelease

预期输出(关键结果)

text
BUILD SUCCESSFUL in <TIME>

<TIME> 会随机器性能、缓存状态和项目规模变化。构建成功只说明 Gradle 完成了对应任务,还应继续检查生成产物是否使用了预期签名和发布配置。

如果准备向支持 Android App Bundle 的应用市场提交版本,项目通常还会生成 AAB:

bash
# 构建用于发布的 Android App Bundle
./gradlew :app:bundleRelease

预期输出(关键结果)

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

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

目录与阅读设置

阅读设置

17

记录一个想法

区分 Debug 与 Release 构建

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

登录哪都通