经典修改版 · 兼容性
冷链仓库的扫码枪:老机型兼容与 targetSdk 的三次回退

冷链仓库的扫码枪是一批 2016 年的工业平板,系统停在 Android 7,扫码模块只认旧版相机接口。原来的采集应用升级后在这些机器上直接闪退,换设备要几十万,能改的只有包。

这是一次典型的“新应用迁就旧硬件”。本文讲三步:先确认闪退原因是 targetSdk 带来的运行时权限与相机接口变化,再做最小回退,最后用签名一致的方式覆盖安装,并把三种常见闪退的日志特征列出来。

先判断是不是应用的问题

仓库一开始怀疑是扫码模块坏了。做法很简单:用系统相机拍一张,能用;用另一台同型号机器装同一个新版本,同样闪退。日志里出现的是权限相关和相机初始化失败,基本锁定是应用在新系统行为下的兼容问题,而不是硬件。

targetSdk 抬高的两个副作用

新版应用把 targetSdk 抬到 30 以上,在 Android 7 上会带来两个直接后果:一是运行时权限的判定逻辑变了,二是部分相机与存储接口的行为和老系统对不上。工业平板的系统是定制 ROM,比原生更保守,问题更容易暴露。

  • 运行时权限:老 ROM 上弹窗不出现,直接返回拒绝
  • 相机接口:预览分辨率协商失败,初始化即回调错误
  • 存储:外部存储写入路径变化,扫码结果落盘失败

第一次回退:把 targetSdk 降回 28

改动清单里只动这一个值,别顺手把 minSdk 也改,minSdk 一改会影响 dex 的编译方式,容易引出别的崩溃。

第二次回退:相机预览分辨率与格式

降了 targetSdk 之后,五台机器里还有两台失败。日志显示预览回调的格式被设成了新机型默认的 YUV 变体,老模块只支持 NV21。把预览格式显式写成 NV21、分辨率固定到 1280×720,这两台也正常了。这说明“兼容”有时候不是版本号问题,而是默认值问题。

第三次回退:签名与覆盖安装

仓库里已经有旧版本在跑,新包签名不同会导致覆盖安装失败。解决办法是用原来的 keystore 重签新包,包名保持不变,版本号抬高一档,这样直接覆盖、数据不丢。如果原来的 keystore 已经找不到,就只能在每台机器上卸载重装,代价是重新配置仓库和工位信息。

三种闪退的日志特征,抄下来备用

最后提醒:这类改造要留一份“回退记录”。降了哪个值、为什么降、哪台机器验证过,写在一张纸上贴在仓库办公室,下次升级的人不用再从头试一遍。

一句话记住

旧硬件上的兼容问题,先从版本号和默认值两个方向找。每次只改一个变量、只在一台机器上验证,再推到全部设备。

想动手试一遍

三个版本任选:经典修改版 适合精修与反编译研究,智改工坊电脑版 适合批量与口述改包,智改工坊安卓版 适合手机现场改包。

同栏目其他文章:经典修改版栏目列表;也看看新手上路。