原生移动开发 / 系统课时

整理发布前版本检查项

整理发布前版本检查项

发布失败往往不是“不会打包”,而是把调试环境、测试资源或错误版本号带进了 Release。这里把发布前最容易出错的项目收敛成一份可执行检查清单,并给出构建与产物核验方法,确保提交前能发现明显问题。

学习目标

  • 能按版本、环境、调试信息、账号与资源五类检查 Release 配置
  • 能构建 Release 产物,并从最终 APK 中核对关键清单信息
  • 能把一次性人工检查整理成团队可复用的发布前清单

先检查会影响线上行为的配置

发布前最优先确认的不是图标,而是“这个包会连到哪里、以什么模式运行”。至少检查应用名称、applicationId、版本号、生产接口地址、调试开关、日志级别和第三方服务配置。

如果项目使用 Gradle 的 buildTypes 或 Product Flavor 区分环境,应确认 release 最终使用生产配置,而不是只看源码中的默认值。例如 BuildConfig.DEBUG 在 Release 中应为 false,接口地址也应来自对应的 Release 配置。

核对版本与应用身份

应用商店通常用包名识别应用,用版本号判断升级关系。发布前至少确认:

  • 应用名称是否为正式名称,是否误带“测试版”“Dev”等字样。
  • applicationId 是否是正式包名,不能与测试包或内部包混用。
  • versionCode 是否比已发布版本更大。
  • versionName 是否与本次发布说明一致。
  • minSdk、targetSdk 是否符合当前发布计划。

先执行一次 Release 构建,再直接读取 APK 中的 Manifest 信息。示例假设已经安装 Android SDK Command-line Tools,实际 APK 路径请替换 <PATH>。

bash
./gradlew :app:assembleRelease
apkanalyzer manifest application-id <PATH>/app-release.apk
apkanalyzer manifest version-code <PATH>/app-release.apk
apkanalyzer manifest version-name <PATH>/app-release.apk

预期输出

text
com.example.app
<ID>
1.8.0

其中 <ID> 代表实际 versionCode,不同发布版本会不同。若包名、版本号与预期不一致,应回到 Gradle 配置、Flavor 或 CI 参数中定位覆盖来源,而不是继续签名或上传。

检查调试开关、日志与测试入口

Release 包不应依赖开发期能力。重点搜索仅用于调试的开关、测试菜单、Mock 数据、代理地址、抓包配置和详细日志。若项目允许 Release 保留部分日志,也应明确哪些级别可保留,避免输出令牌、手机号、请求体等敏感数据。

测试账号也要区分“给审核使用的正式测试账号”和“开发人员临时账号”。前者应可正常登录、权限稳定、不会依赖内网;后者不应写死在代码、资源或远程配置中。

可以把容易遗漏的项目记录为可勾选清单,而不是依赖发布人员记忆:

  • 生产接口与第三方正式环境已切换。
  • 调试菜单、Mock、测试服务器和开发证书已关闭。
  • 日志不包含密钥、令牌、个人信息和完整请求体。
  • 审核账号可用,必要说明已同步给运营或上架人员。
  • 正式图标、启动图、应用名称、隐私政策地址等资源已核对。

从最终产物做最后确认

源码检查解决“我们打算怎么配”,产物检查解决“实际上打出了什么”。除 Manifest 外,还应至少安装一次 Release 包,验证启动、登录、核心接口、深链或推送等与环境强相关的路径。

如果 Release 构建启用了混淆或资源压缩,还要特别验证反射、序列化、WebView JS 接口、第三方 SDK 初始化等容易受压缩影响的功能。发布前检查的目标不是覆盖全部测试,而是阻止明显错误进入签名、上传和审核阶段。

一份有效的发布清单应该能回答三个问题:版本是否正确、线上环境是否正确、产物是否仍含开发期内容。只要这三类检查能在每次发布前重复执行,很多低级但代价很高的问题就能在提交应用商店之前被拦住。

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

目录与阅读设置

阅读设置

17

记录一个想法

整理发布前版本检查项

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

登录哪都通