原生移动开发 / 系统课时
发布应用升级版本
发布应用升级版本
应用升级不是“重新打一个包”这么简单,而是要保证新版本身份连续、Release 构建可追溯、旧版本能原地覆盖安装,并在提交市场前完成关键回归。本篇给出一条从版本号、构建、升级验证到发布说明与提交的最短闭环。
学习目标
- 正确提升
versionCode与versionName,避免更新包被判定为旧版本 - 构建 Release 产物,并验证旧版本可以覆盖升级且用户数据不丢失
- 准备发布说明与市场提交材料,形成可复查的升级验收记录
先保证版本身份连续
Android 是否把安装包视为“同一个应用的新版本”,核心取决于应用标识、签名身份和版本号。更新版本必须保持与线上版本一致的 applicationId,并使用兼容的发布签名;同时,新包的 versionCode 必须高于已发布版本。versionName 主要面向用户展示,可以按团队的版本命名规则调整。
下面是片段示例,假设线上版本的 versionCode 为 42,项目使用 Kotlin DSL。它依赖现有 android 配置上下文:
android {
defaultConfig {
applicationId = "com.example.store"
versionCode = 43
versionName = "2.4.0"
}
}配置生效后,先确认这次升级涉及的数据结构变化。例如数据库表、SharedPreferences、文件缓存或登录凭据发生变化时,应明确迁移路径;不能只验证“全新安装能启动”,否则最常见的升级故障会被漏掉。
构建可提交的 Release 产物
在项目根目录使用 Gradle Wrapper 构建 Release。以下命令假设主应用模块名为 app,并且 Release 签名已在项目或 CI 中正确配置:
./gradlew clean :app:bundleRelease :app:assembleRelease预期输出:
BUILD SUCCESSFUL in <TIME><TIME> 会随机器和缓存状态变化。AAB 用于应用市场分发,Release APK 便于在真实设备上做覆盖升级验证。若项目没有生成 APK 的需求,可以只执行 :app:bundleRelease。
验证旧版本覆盖升级
至少准备一台安装了当前线上正式版的测试设备,并先在旧版本中制造真实状态,例如登录账号、保存草稿、写入本地数据库或完成一次核心业务流程。然后安装本次 Release APK,覆盖原应用而不是先卸载。
adb install -r <PATH>/app-release.apk预期输出:
Success<PATH> 是实际 APK 所在目录。若出现签名不一致、版本号过低或设备不兼容,adb 会返回失败信息,应先解决根因,而不是卸载旧版后重新安装,因为卸载会破坏升级测试条件。
覆盖安装成功后,再验证版本:
adb shell dumpsys package <ID> | grep versionName预期输出:
versionName=2.4.0<ID> 替换为真实应用 ID。随后检查旧数据是否仍在、数据库迁移是否成功、登录态是否符合预期、通知与深链是否正常、核心页面能否完成一次完整操作。若应用包含后台任务或本地加密数据,也要在升级后重新触发这些路径。
准备发布说明与市场提交
发布说明应该让用户知道“这次变化是什么”,而不是复制开发提交记录。通常保留三类信息就够了:用户可感知的新功能、重要问题修复、兼容性或体验改进。不要写内部类名、工单号、测试环境地址,也不要承诺无法保证的性能结果。
一个简洁版本可以写成:
新增订单筛选功能;修复部分设备返回首页后列表状态丢失的问题;优化冷启动阶段的资源加载。
提交应用市场前,把版本号、构建产物、签名来源、发布说明和测试结果绑定到同一个发布记录中。若使用 Google Play,通常上传 AAB 并创建对应发布版本;其他市场可能要求 APK、AAB 或额外的隐私与合规材料,具体以目标平台当时的要求为准。
用升级验收而不是全新安装作为放行条件
正式提交前,至少保留一份可重复执行的验收清单:旧版本来源与版本号、新版本构建号、覆盖升级设备、关键数据迁移结果、核心业务回归结果和异常日志。新版本只有在“旧版可覆盖升级、数据可继续使用、核心路径可完成”同时成立时,才算真正完成了应用升级。