原生移动开发 / 系统课时
整理发布前版本检查项
整理发布前版本检查项
发布失败往往不是“不会打包”,而是把调试环境、测试资源或错误版本号带进了 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>。
./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预期输出
com.example.app
<ID>
1.8.0其中 <ID> 代表实际 versionCode,不同发布版本会不同。若包名、版本号与预期不一致,应回到 Gradle 配置、Flavor 或 CI 参数中定位覆盖来源,而不是继续签名或上传。
检查调试开关、日志与测试入口
Release 包不应依赖开发期能力。重点搜索仅用于调试的开关、测试菜单、Mock 数据、代理地址、抓包配置和详细日志。若项目允许 Release 保留部分日志,也应明确哪些级别可保留,避免输出令牌、手机号、请求体等敏感数据。
测试账号也要区分“给审核使用的正式测试账号”和“开发人员临时账号”。前者应可正常登录、权限稳定、不会依赖内网;后者不应写死在代码、资源或远程配置中。
可以把容易遗漏的项目记录为可勾选清单,而不是依赖发布人员记忆:
- 生产接口与第三方正式环境已切换。
- 调试菜单、Mock、测试服务器和开发证书已关闭。
- 日志不包含密钥、令牌、个人信息和完整请求体。
- 审核账号可用,必要说明已同步给运营或上架人员。
- 正式图标、启动图、应用名称、隐私政策地址等资源已核对。
从最终产物做最后确认
源码检查解决“我们打算怎么配”,产物检查解决“实际上打出了什么”。除 Manifest 外,还应至少安装一次 Release 包,验证启动、登录、核心接口、深链或推送等与环境强相关的路径。
如果 Release 构建启用了混淆或资源压缩,还要特别验证反射、序列化、WebView JS 接口、第三方 SDK 初始化等容易受压缩影响的功能。发布前检查的目标不是覆盖全部测试,而是阻止明显错误进入签名、上传和审核阶段。
一份有效的发布清单应该能回答三个问题:版本是否正确、线上环境是否正确、产物是否仍含开发期内容。只要这三类检查能在每次发布前重复执行,很多低级但代价很高的问题就能在提交应用商店之前被拦住。