介绍
Release Readiness 是自动化发布前检查清单，用于验证应用是否已经适合生产部署。每个检查都会分析项目配置、manifest、构建输出、签名身份、bundle metadata 和依赖信息，并给出明确的 pass、fail 或 warning 结果。
它避免团队依赖容易被赶工跳过的手动 checklist，把常见配置错误、安全风险、兼容性问题和策略违规集中到一次扫描报告中。
为什么使用 Release Readiness？
- 忘记关闭 debuggable。 可调试 release build 会带来安全风险，并可能被应用商店拒绝。
- API keys 被硬编码。 Google Maps、Firebase、AWS 或第三方 SDK secrets 可能被提交到仓库并打进 APK。
- 未开启 minifyEnabled。 未压缩 release 构建体积更大，也更容易被逆向分析。
- target SDK 版本不符合要求。 Google 会周期性提高新提交应用的 target SDK 要求。
- 手动 checklist 容易漏项。 即使有经验的开发者，也可能在发布日期前漏掉某些项目，且纸面流程没有审计记录。
功能
Release Readiness 会运行一组自动化检查，每个检查都针对发版配置中的一个具体风险点：
1. Debuggable Flag Check
确认 release 构建中 android:debuggable 为 false，并检查可能在生产环境开启 debug 行为的 BuildConfig.DEBUG 使用。
2. MinifyEnabled Verification
确认 release build type 已开启 R8/ProGuard 代码压缩，并展示资源压缩 shrinkResources 状态。
3. API Key Exposure Scan
扫描源码和资源文件中的硬编码 API keys、secrets 和 tokens，包括 Google Maps、Firebase、AWS 和第三方 SDK 常见模式。
4. SDK Version Compliance
验证 targetSdkVersion 是否满足当前 Google Play 要求，并检查 compileSdkVersion 与依赖使用是否匹配。
5. Signing Configuration
确认 release 构建使用正确 release keystore，而不是 debug keystore，并检查签名 scheme 和证书有效性。
6. ProGuard Rules Review
确认 ProGuard/R8 规则文件存在且被引用，提示反射密集库缺少 keep 规则或过度宽泛的 wildcard 规则。
7. Version Code and Name
检查 versionCode 和 versionName。相同本地 versionCode 只作为 warning，因为真正阻塞的是目标商店已接受的版本号基线。
8. Target SDK Behavior
检查近期 Android 版本引入的运行时权限、后台执行限制和平台级要求。
9. Permissions Review
列出声明权限，突出位置、相机、麦克风、联系人、电话状态等敏感权限，并提示缺少运行时请求代码的权限。
10. Test Coverage
检查测试 source set 是否存在，并可选运行单元测试，报告测试是否存在、是否通过和上次执行时间。
11. Resource Optimization
确认资源压缩是否开启，检查未使用资源和可被 WebP 或 vector drawable 替换的大图片。
12. Manifest Checks
验证 allowBackup、usesCleartextTraffic、android:exported 和 networkSecurityConfig 等关键 manifest 属性。
13. Dependency Audit
扫描依赖树中的已知漏洞、过期依赖、snapshot 版本和传递依赖冲突。
14. 16 KB Native Library Page Size
检查 native libraries 在 Android 15+ 16 KB page-size 设备上的兼容风险。
15. Remote AAB Release Candidate Checks
支持检查本地构建产物或从远程仓库缓存下载的 AAB。远程缓存是产物来源，不会被误判为构建类型。
16. Documentation Links for Each Check
每个检查结果可以在状态旁提供 Docs 链接，方便团队从 warning/fail 跳转到官方或项目说明。
Check Status Types
每个检查会产生五类状态：PASS 表示通过，INFO 表示信息提示，WARNING 表示不阻塞但需要 review，FAIL 表示发布前必须修复，SKIP 表示当前环境无法评估。总 readiness score 只统计 PASS，方便快速判断是否可以发布。
Check History
检查结果会持久化，方便跨构建对比。历史视图展示每次扫描的 pass、fail、warning 数量，适合在发版周期中确认 warning 是否减少、近期改动是否引入新 failure。
Score: 14 / 16 passed
[PASS] Debuggable flag is false
[PASS] minifyEnabled is true
[PASS] No hardcoded API keys detected
[PASS] targetSdkVersion 35 meets Play requirement
[PASS] Signed with release keystore
[WARNING] versionCode matches the last local scan; confirm store upload history
[FAIL] 3 permissions lack runtime request code
[FAIL] android:exported missing on 2 activities
[PASS] Native libraries are compatible with 16 KB page-size devices
开始使用
- Tools > ADB Pro > Run Release Readiness Check：运行完整发布检查。
- ADB Pro side panel：进入 Release Readiness 标签页并点击 Run Check。
- Post-build hook：可配置为 release 构建后自动运行。
结果解读方式：
- 先查看报告顶部总分，例如通过、警告和失败数量。
- 每个项目都会展示状态、描述和具体配置位置。
- 点击失败项目可跳转到编辑器中的相关位置。
- 失败或警告项会包含问题说明、受影响文件或配置、建议修复方式，以及可用时的文档链接。
更多配置位于 Settings > Tools > ADB Pro > Release Readiness，可以启用或禁用单个检查、设置 API key patterns、覆盖 targetSdk 要求、启用自动运行和设置阻塞阈值。
验证
- 关键项目应显示绿色 check，warning 项应在上传前 review。
- 红色 FAIL 项会包含修复步骤；修复后重新运行检查。
- 修复失败项后，执行 release 构建并安装到设备，确认运行行为与报告一致。
- 任何构建配置变更后都应重新运行检查，避免回归进入发布包。