原生移动开发 / 系统课时
验证新版本能否覆盖升级
验证新版本能否覆盖升级
发布包能成功全新安装,并不代表它能安全覆盖线上旧版本。有效的升级测试应从真实旧版出发,检查应用 ID、签名、versionCode、数据库迁移和本地数据连续性,最终确认用户无需卸载应用也能升级并继续使用原有数据。
学习目标
- 建立从旧版到候选新版的覆盖安装测试流程
- 判断签名、
versionCode与数据库迁移失败分别会出现什么现象 - 用可重复的验收项确认本地数据和核心功能在升级后仍可用
先确认升级前提
测试样本应包含一个旧版 APK 和本次候选 APK。两者必须保持相同 applicationId;候选版应使用与该测试升级链一致的签名身份,并使用更高的 versionCode 来模拟真实发布。
先比较两个 APK 的签名、应用 ID 和版本号。下面的 <PATH> 要替换为实际文件目录,<SHA256> 代表证书摘要的动态值。
apksigner verify --print-certs <PATH>/old.apk
apksigner verify --print-certs <PATH>/new.apk
apkanalyzer manifest application-id <PATH>/old.apk
apkanalyzer manifest application-id <PATH>/new.apk
apkanalyzer manifest version-code <PATH>/old.apk
apkanalyzer manifest version-code <PATH>/new.apk预期输出中的关键值应满足如下关系:
Signer #1 certificate SHA-256 digest: <SHA256>
Signer #1 certificate SHA-256 digest: <SHA256>
com.example.notes
com.example.notes
41
42<SHA256> 的实际内容因证书而异,但新旧包应对应同一升级签名身份;示例中的 41 和 42 只是说明新版 versionCode 更高,项目实际值可能不同。若使用 Google Play App Signing,还要区分上传密钥和实际分发给设备的应用签名密钥,不能仅凭本地上传包推断线上 APK 的签名关系。

执行一次真实覆盖安装
选择干净的测试设备或模拟器,先安装旧版。不要先装新版,也不要在升级前卸载旧版,否则会破坏“保留原有应用数据”的测试前提。下面的命令适用于可通过 adb 访问的设备。
adb install <PATH>/old.apk
echo '请在旧版本中创建测试数据后按 Enter 继续升级:'
read -r
adb install -r <PATH>/new.apk预期输出
Success
请在旧版本中创建测试数据后按 Enter 继续升级:
Success旧版安装成功后,应在应用里创建一组容易辨认的基线数据,例如新增一条名为 upgrade-check-001 的记录、修改一个本地设置,并进入至少一个会写数据库的页面。按 Enter 后,adb install -r 会在不主动清除应用数据的前提下尝试覆盖安装新版。
升级成功后重新打开应用,确认刚才的数据仍存在、设置没有意外复位,并对读取、写入、编辑和删除做一次最小回归。若应用使用 Room 或自行维护 SQLite schema,还要确认旧 schema 能正确迁移到当前 schema。
从失败现象定位原因
覆盖安装阶段的错误通常比“直接装一个全新 APK”更有诊断价值。
| 现象 | 优先检查 | 含义 |
|---|---|---|
INSTALL_FAILED_UPDATE_INCOMPATIBLE |
新旧 APK 的签名身份 | 常见于已安装包与待更新包签名不兼容 |
INSTALL_FAILED_VERSION_DOWNGRADE |
新旧 versionCode |
待安装版本低于当前已安装版本 |
| 安装成功但启动后崩溃 | 数据库迁移、序列化格式、初始化逻辑 | 安装身份连续,但应用层数据兼容失败 |
| 安装成功但旧数据“消失” | applicationId、迁移逻辑、存储位置变化 |
先确认是否真的覆盖了同一个应用,而不是装成了新应用 |
不要把 adb install -r 返回 Success 当成全部验收结果。它只说明包管理器接受了这次替换,并不能证明数据库迁移正确、历史文件可读或业务状态仍然有效。
把升级路径做成发布前验收
至少保留“当前线上版本 → 候选版本”这一条路径。若应用允许用户跨多个版本直接升级,还应选择仍在支持范围内的较老版本直接升级到候选版,避免只验证相邻版本而遗漏数据库迁移链断点。
对每条路径记录旧版号、新版号、签名摘要、是否覆盖安装成功、基线数据是否保留、数据库是否正常打开以及核心功能是否通过。这样出现问题时,可以快速区分安装层身份问题和应用内部的数据兼容问题。
真正可发布的候选包,应同时满足“能够覆盖安装”和“升级后数据与功能仍然正确”两个条件;任何一个条件失败,都不能用全新安装成功来替代升级验证。