原生移动开发 / 系统课时

发布应用升级版本

发布应用升级版本

应用升级不是“重新打一个包”这么简单,而是要保证新版本身份连续、Release 构建可追溯、旧版本能原地覆盖安装,并在提交市场前完成关键回归。本篇给出一条从版本号、构建、升级验证到发布说明与提交的最短闭环。

学习目标

  • 正确提升 versionCode 与 versionName,避免更新包被判定为旧版本
  • 构建 Release 产物,并验证旧版本可以覆盖升级且用户数据不丢失
  • 准备发布说明与市场提交材料,形成可复查的升级验收记录

先保证版本身份连续

Android 是否把安装包视为“同一个应用的新版本”,核心取决于应用标识、签名身份和版本号。更新版本必须保持与线上版本一致的 applicationId,并使用兼容的发布签名;同时,新包的 versionCode 必须高于已发布版本。versionName 主要面向用户展示,可以按团队的版本命名规则调整。

下面是片段示例,假设线上版本的 versionCode 为 42,项目使用 Kotlin DSL。它依赖现有 android 配置上下文:

kotlin
android {
    defaultConfig {
        applicationId = "com.example.store"
        versionCode = 43
        versionName = "2.4.0"
    }
}

配置生效后,先确认这次升级涉及的数据结构变化。例如数据库表、SharedPreferences、文件缓存或登录凭据发生变化时,应明确迁移路径;不能只验证“全新安装能启动”,否则最常见的升级故障会被漏掉。

构建可提交的 Release 产物

在项目根目录使用 Gradle Wrapper 构建 Release。以下命令假设主应用模块名为 app,并且 Release 签名已在项目或 CI 中正确配置:

bash
./gradlew clean :app:bundleRelease :app:assembleRelease

预期输出:

text
BUILD SUCCESSFUL in <TIME>

<TIME> 会随机器和缓存状态变化。AAB 用于应用市场分发,Release APK 便于在真实设备上做覆盖升级验证。若项目没有生成 APK 的需求,可以只执行 :app:bundleRelease。

验证旧版本覆盖升级

至少准备一台安装了当前线上正式版的测试设备,并先在旧版本中制造真实状态,例如登录账号、保存草稿、写入本地数据库或完成一次核心业务流程。然后安装本次 Release APK,覆盖原应用而不是先卸载。

bash
adb install -r <PATH>/app-release.apk

预期输出:

text
Success

<PATH> 是实际 APK 所在目录。若出现签名不一致、版本号过低或设备不兼容,adb 会返回失败信息,应先解决根因,而不是卸载旧版后重新安装,因为卸载会破坏升级测试条件。

覆盖安装成功后,再验证版本:

bash
adb shell dumpsys package <ID> | grep versionName

预期输出:

text
versionName=2.4.0

<ID> 替换为真实应用 ID。随后检查旧数据是否仍在、数据库迁移是否成功、登录态是否符合预期、通知与深链是否正常、核心页面能否完成一次完整操作。若应用包含后台任务或本地加密数据,也要在升级后重新触发这些路径。

准备发布说明与市场提交

发布说明应该让用户知道“这次变化是什么”,而不是复制开发提交记录。通常保留三类信息就够了:用户可感知的新功能、重要问题修复、兼容性或体验改进。不要写内部类名、工单号、测试环境地址,也不要承诺无法保证的性能结果。

一个简洁版本可以写成:

新增订单筛选功能;修复部分设备返回首页后列表状态丢失的问题;优化冷启动阶段的资源加载。

提交应用市场前,把版本号、构建产物、签名来源、发布说明和测试结果绑定到同一个发布记录中。若使用 Google Play,通常上传 AAB 并创建对应发布版本;其他市场可能要求 APK、AAB 或额外的隐私与合规材料,具体以目标平台当时的要求为准。

用升级验收而不是全新安装作为放行条件

正式提交前,至少保留一份可重复执行的验收清单:旧版本来源与版本号、新版本构建号、覆盖升级设备、关键数据迁移结果、核心业务回归结果和异常日志。新版本只有在“旧版可覆盖升级、数据可继续使用、核心路径可完成”同时成立时,才算真正完成了应用升级。

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

目录与阅读设置

阅读设置

17

记录一个想法

发布应用升级版本

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

登录哪都通