ANDROID APK EDITOR · 智改工坊
安卓修改大师智改工坊

只需说话,就能让应用变成你想要的样子。把反编译、改代码、回编、对齐、签名这条长链路,收进一句中文需求里。

查看智改工坊产品介绍 →
培训室里的十八台手机,比任何测试报告都诚实
培训室里的十八台手机,比任何测试报告都诚实

周一早上九点半,净屋家政总部的培训室坐满了人。十二位店长、六位派单员,桌上摆着十八台手机,屏幕都亮着,等着装新版的“净屋派单”。

这是公司自己的内部应用,平时由合作开发老许维护。派单员用它接单、排班、看客户地址,店长用它盯当天的订单完成率,保洁员到岗后用它点“已到达”,客户签完字,工单才算闭环。旧版本 3.1.8 用了大半年,稳定,但有两个老毛病:到达照片只能拍一张,客户签名要另外拿纸。新版 3.2.0 加了多角度拍照和屏幕签名,运营部催了两个月,终于定在周一培训时统一升级。

九点三十五分,第一台手机装完了,提示“应用未安装”。

九点三十七分,第二台手机提示“版本降级”。

九点四十分,第三台手机提示“更新包与已安装应用签名不一致”。

培训师站在投影前,手里还拿着激光笔,脸上的笑有点挂不住。店长们开始交头接耳,有人问“是不是我手机的问题”,有人已经把手机递到我面前。我是公司的信息化专员,平时负责这些内部工具的打包和分发。那一刻我很清楚:这不是某台手机的问题,这是交付流程的问题。

九点半,第一台手机就装不上

先把现场的情况说清楚。

十八台手机,型号很杂:有公司统一采购的千元机,有店长自己用的旧旗舰,还有两台是前一年留下的平板。系统从 Android 9 到 Android 13 都有。旧版 3.1.8 都装着,登录状态都在,有的人手机上还存着当天早上的派单草稿。

新版 3.2.0 是外部开发老许上周五发来的。他发的是一个 APK 文件,微信传输,文件名“净屋派单_3.2.0_最终.apk”。没有签名文件,没有版本说明,没有安装说明。我当时忙着手上的事,看了一眼文件名,就转到了店长群里,附了一句“周一培训时统一安装”。

这句话就是事故的起点。

现在回头看,这个流程有三个洞:包是谁签的没人知道,版本代码是多少没人核对,装之前也没有一台“装着旧版”的设备先试。三个洞平时都不露,只有所有人都集中安装时才一起爆。培训室就是那个把所有手机放在同一张桌子上的时刻。

以前我们一直是这么干的:开发出包,发微信,大家各自安装。装上了就用,装不上就在群里问。小问题远程指导,大问题让店长把手机寄回总部。公司不大,十二家店,四十多位保洁员,六位派单员,大家习惯了这种“人盯人”的方式。直到这次,十八台手机同时装不上,人盯人盯不过来。

我打开笔记本,连上第一台失败的手机,用 adb 看安装输出。屏幕上滚过几行字,最后一行是 Failure [INSTALL_FAILED_UPDATE_INCOMPATIBLE: Package com.jingwu.dispatch signatures do not match previously installed version; ignoring!]。翻译过来很简单:包名一样,签名不一样,系统拒绝覆盖。

第二台是 INSTALL_FAILED_VERSION_DOWNGRADE。第三台还是签名不一致。我又抽查了几台,问题分成三类:六台签名不一致,两台版本降级,一台存储空间不足。剩下的九台装上了,因为它们在周五晚上已经装过一次老许发的测试包。

十八台手机,九台失败。培训还没开始,先变成了排障现场。

九台装上的手机也不是“没问题”。它们装的是周五晚上的测试包,版本代码 318,签名是默认签名。也就是说,它们已经离开了公司 JKS 的轨道,后面再想装正式版,同样要卸载。这个事实当时没人注意,大家只看到“有的能装”,以为是个别手机的问题。

先把“装不上”拆成四种失败

“装不上”是一个笼统的说法。在 Android 里,它至少对应四种不同的失败,每一种的原因和处理方式都不一样。

设备提示真正的原因能不能自动救正确的处理
VERSION_DOWNGRADE手机上已装版本的版本代码更高可以,用允许降级的参数覆盖正式交付不应依赖,打包前把版本代码递增
UPDATE_INCOMPATIBLE包名相同,签名不同不能,只能卸载重装换回同一套签名重新打包,或经用户同意后卸载
TEST_ONLY清单里带了测试专用标记可以,加 -t 重装正式包不应该出现这个标记
INSUFFICIENT_STORAGE手机空间不够不能清理空间,不自动删用户数据

这张表是我后来补进交付文档的。那天现场,我只用了其中两行:签名不一致和版本降级。

测试专用标记通常出现在开发直接出的调试包上,清单里带了 testOnly,系统安装器会拒绝,但 adb 加 -t 能装。它不该出现在内测包里,因为用户自己装不了。空间不足更直接:那天一台手机的剩余空间不到安装包的两倍,系统解压和校验都需要临时空间,清掉两个视频就好了。这两类问题和签名无关,但现场都表现为“装不上”,所以要先分类,再动手。

工具在安装时会对这几种情况分别处理:版本降级自动改用允许降级的参数,测试专用包自动加 -t,签名不一致会弹窗问要不要卸载重装,空间不足原样报错。这些处理能救急,但不能当成流程。尤其是签名不一致,卸载重装会清掉应用数据,店长手机里的派单草稿、客户地址缓存、当天的工单记录都可能没了。工具不替用户做这个决定,是对的。

还有一个细节:adb 的输出里,最后一行往往不是失败原因。它会先打一行 Performing Streamed Install,再打 Failure [...]。如果只看最后一行,会得到一句“正在安装”,误以为成功了。正确的做法是找带 Failure 或 INSTALL_FAILED 的那一行。那天我一开始也差点看错,幸好第二眼扫到了 UPDATE_INCOMPATIBLE。

我把那行失败原文截图发到群里,店长们才知道不是手机坏了。技术问题最怕用“坏了”来描述,一旦归因到设备,就没人去查流程。把原文拿出来,大家看到的是 INSTALL_FAILED_UPDATE_INCOMPATIBLE,讨论才能回到签名和版本上。

签名是一把钥匙,不是一道手续

签名这件事,平时看不见,装不上时才知道它有多硬。

Android 的判断逻辑不复杂:两个 APK 的包名相同,签名也相同,系统认为它们是同一个应用的不同版本,可以覆盖;包名相同,签名不同,系统认为它们来自不同的发布者,拒绝覆盖。这不是工具的限制,是系统的安全规则。签名在这里不是加密,也不是防篡改的全部,它首先是一份身份声明:这个包,是不是原来那个人发的。

可以把它想成家里的门锁。包名是门牌号,签名是钥匙。门牌号没变,你换了一把锁,旧钥匙就打不开了。用户手机里装的是旧锁,你送来的新包配的是新钥匙,系统当然不让你进门。要进门,要么把旧锁换回来(用同一套签名),要么把门拆了重装(卸载再安装,数据丢失)。

工具里的四种签名,适合的场景完全不同:

签名模式用什么签适合什么现场要注意什么
默认签名工具随包的一套测试签名内部测试、一次性演示不是公司专属,不能作为长期交付的钥匙
JKS / keystore公司自己的密钥库正式应用、长期升级文件、别名、口令三样都要在
PEM + PK8证书加私钥已有证书体系的团队证书要 X.509,私钥要 PKCS#8
随机签名每次临时生成一套装一次就卸载的临时包每次都不一样,绝对不能覆盖升级

默认签名最容易让人误会。它确实能签出一个可安装的包,也能在内部测试时省事,但它不是公司的钥匙。它的密钥是工具自带的、公开的,任何拿到同一套工具的人都能签出同样的身份。用它做正式交付,等于把家门钥匙放在门口脚垫下面。更麻烦的是,一旦你用它发了一版,后面换成公司 JKS,用户就覆盖不上了,只能卸载重装。所以默认签名只适合“装一次就删”的测试,不适合内测分发,更不适合正式版本。

JKS 是公司自己的钥匙。文件是 .jks 或 .keystore,里面有别名、keystore 口令、密钥口令。工具在“设置签名”里选 JKS,填入文件、别名、口令,保存后每次打包直接用。口令是明文存在项目配置里的,这是为了方便,也是风险:项目目录不能随便发给别人。我们公司的做法是,JKS 文件放在财务的保险柜里,口令由我和财务各掌握一半,谁也不能单独签包。

PEM + PK8 是另一种形态:证书文件加私钥文件。适合已经有证书体系的团队,比如从旧系统迁移过来的应用。工具支持这两种格式,但要求证书是 X.509、私钥是 PKCS#8,格式不对,最后一步 verify 会明确报出来。

随机签名是“一次性钥匙”。每次打包临时生成一套,签完就删。它适合那种“装一次演示,演示完就卸载”的场景,绝对不能用于需要升级的应用。因为每次签名都不同,系统会把每一版当成不同的发布者,用户只能卸载重装,数据全丢。

签名方案还有 v1、v2、v3、v4 四个开关。工具默认勾 v1、v2、v3,不勾 v4。最低 SDK 低于 24 的包,v1 必须保留,否则 Android 7.0 以下的设备装不上。v4 会额外生成一个 .idsig 文件,主要用于增量安装,普通交付用不上,不勾反而少一个文件。这些组合不是越多越好,而是要和你的设备范围匹配。

签名方案从哪个版本开始支持作用什么时候必须开
v1Android 1.0JAR 签名,老系统只认它最低 SDK 低于 24
v2Android 7.0整包签名,校验更快大多数现代设备
v3Android 9支持密钥轮换需要长期升级的应用
v4Android 11增量安装,额外生成 .idsig有增量安装需求时

工具在保存签名设置时会拦两种错误组合:三个方案全不勾,或者 v4 单独勾。这两种组合看起来是小事,真出包时就是“签了但装不上”。v4 必须配合 v2 或 v3,因为它依赖整包签名;只勾 v4,等于只做了增量安装的标记,没有做完整签名。

JKS 文件要备份,但不能只备份一份。我们的做法是:保险柜一份,离线加密盘一份,两处的口令分开。签包的人可以拿到文件和口令,但不能同时拿走两份备份。这个规矩听起来像银行,其实小公司更需要,因为小公司没有专职的安全团队,钥匙丢了就是灾难。

PEM + PK8 和 JKS 的本质是一样的:一个私钥,一份证书。区别只是存放格式。JKS 把私钥和证书放在一个加密容器里,PEM + PK8 把它们分成两个文件。工具两种都支持,选哪种取决于你手上有什么。最怕的是两种混着用:这次用 JKS,下次用 PEM,虽然都是“自己的签名”,但密钥不同,照样覆盖不了。

签名不是一道手续,它是应用的身份;钥匙丢了,门就进不去
签名不是一道手续,它是应用的身份;钥匙丢了,门就进不去

实例一:派单工具 3.2.0 的内测翻车

回到培训室。九点五十分,我把失败原因归了类,开始处理。

旧版 3.1.8 是公司 JKS 签的,版本代码 318。两台手机上装过 3.1.9 的紧急修复包,版本代码 319,也是公司 JKS 签的。老许发来的 3.2.0 测试包,用的却是默认签名,版本代码还停在 318。也就是说,它既不是同一把钥匙,也没有比 3.1.9 更新。六台签名不一致,两台版本降级,一台空间不足,全部对上了。

老许在电话里解释:上周换了电脑,原来的签名文件没拷过来,想着“先出个测试包,培训时再说”。这句话我听过太多次。测试包也是交付,测试包也会装到别人的手机上,测试包也会留下数据。只要它进了内测群,它就不是“随便的包”。

我没有跟他争。现场有十八个人在等,争谁对谁错没有意义。我要做的是在天黑之前,把十八台手机装上一个能用的版本,并且保证明天不会再发生同样的事。工具在这时候的价值,不是“取代开发”,而是让我这个信息化专员,在不改一行代码的情况下,把签名和版本重新做对。

以前怎么做: 让老许回去找 JKS,重新出包,再发一次。运气好,中午能拿到;运气不好,他找不到签名文件,只能重新生成一套,所有手机卸载重装,培训推迟到下周。店长们白跑一趟,运营部的计划全部往后挪。这个方案听起来最“正规”,但在那个早上,它解决不了眼前的问题。

现在一句话怎么做: 我把老许发来的 3.2.0 拖进安卓修改大师电脑版,aapt 读出包名、版本、最低 SDK 和启动页。项目建好后,我在“设置签名”里选 JKS,填入保险柜里那份公司密钥的文件、别名和口令,签名方案保持 v1、v2、v3。然后我在需求框里写了一句:

“只把版本代码改为 320,版本名保持 3.2.0,包名、应用内容、权限、签名方案不变;用当前设置的公司 JKS 打包,打包后校验证书指纹。”

这句话的关键是“只”和“不变”。我不需要 AI 再改界面、改文案、改功能,我只需要它把版本代码加两格,然后用正确的钥匙重新签一遍。九点五十五分导入,十点零二分点“立刻修改”,十点十分打包完成。pack.log 里 verify 的输出打印出证书指纹,和 3.1.8 的那份对了一遍,一致。

我没有挂任何图片附件。这次不改界面,只改版本代码和签名,附件越多越容易让 AI 误以为要改别的东西。需求里写“只”和“不变”,附件栏留空,反而更稳。工具的历史里只记了这句原话,下次回填就能照着再做一遍。

有人问,为什么不直接让老许重新出包?因为他手上没有 JKS,重新生成一套新密钥,等于让所有已装用户卸载。用工具在现有 APK 上改版本代码、换签名,是把影响压到最小。这不是绕过开发,而是在事故现场做一次可控的修复。

改完怎么验证: 我先在自己的测试机上装,这台机器装着 3.1.8,版本代码 318。覆盖安装成功,登录状态还在,早上的派单草稿还在。然后我拿了两台店长的手机,一台装着 3.1.8,一台装着 3.1.9,分别覆盖安装,都成功,数据都在。最后才把包发到培训室,让剩下的人装。

验证的时候,我特意没有卸载任何一台手机。卸载重装当然更容易成功,但它证明不了覆盖安装。内部交付的核心场景就是“用户手机上已经有旧版”,只有在这个场景下装成功,才算真的交付。那天十八台手机里,有九台已经装了默认签名的测试包,它们反而成了例外:要回到公司 JKS 的轨道,必须先卸载。这个代价,是老许那个“先出个测试包”的决定留下的。

十点十八分,六台签名不一致的手机全部装上了。两台版本降级的手机也装上了,因为 320 比 319 高。空间不足的那台,店长自己删了两个视频,也装上了。剩下九台装着默认签名测试包的手机,没法直接覆盖。我让店长们先把本地草稿拍照留存,然后卸载、装新包、重新登录。九台手机,花了十二分钟。十点半,培训继续。投影上重新放出 3.2.0 的界面,像什么都没发生过。

打包日志里的证书指纹,是那天早上最有用的一行字
打包日志里的证书指纹,是那天早上最有用的一行字

这一单,拆成三个问题

以前怎么做:开发出包,发微信,大家各自安装;装不上就在群里问,问不清就寄手机;遇到签名不一致,卸载重装,数据丢了再补。整个流程没有版本记录,没有签名记录,也没有“在旧版上覆盖”的验收动作。

现在一句话怎么做:把包拖进工具,选公司 JKS,写一句“只改版本代码,其他不变”,让 AI 改完自动打包;产物落在 build 目录,pack.log 留档;需要的话直接装到已经装着旧版的手机上验证。人只需要做三件事:确认包名、确认签名、确认版本代码。

改完怎么验证:看 pack.log 的证书指纹和旧版是否一致;在装着 3.1.8 和 3.1.9 的手机上分别覆盖安装;打开应用,看登录状态、派单草稿、客户地址是否还在;点一遍新功能“多角度拍照”和“客户签名”;最后在关于页确认版本名 3.2.0、版本代码 320。五项都过,才算修复完成。

versionCode:覆盖安装的第二道门

签名是第一道门,版本代码是第二道门。

Android 判断新旧,看的是版本代码,不是版本名。版本名是给人看的,3.2.0 听起来比 3.1.9 新;版本代码是给系统看的,320 比 319 大,系统才认。如果版本代码没变,或者变小了,系统会认为你在降级,直接拒绝,或者要求你加允许降级的参数。

那天的事故里,两道门同时出了问题:签名不对,版本代码也没涨。老许的测试包版本代码是 318,和 3.1.8 一样,比 3.1.9 的 319 还低。所以即使签名对了,那两台装过 3.1.9 的手机也会提示降级。两个问题叠在一起,现场看起来就像“所有的手机都装不上”,其实原因各不相同。

版本版本名版本代码签名装在哪
稳定版3.1.8318公司 JKS大多数手机
紧急修复3.1.9319公司 JKS两台店长手机
问题测试包3.2.0318默认签名九台手机
修复后的内测包3.2.0320公司 JKS十八台手机

这张表看起来简单,但它能回答三个问题:现在最新的是哪版、哪台设备装了哪版、出问题该退到哪版。没有这张表,版本就是一笔糊涂账。

版本代码的规则很简单:只增不减,永不复用。每次出包,不管是正式版、内测版还是紧急修复,都要比之前所有已发出的版本高。不要因为“只是改个图标”就不加版本代码,也不要因为“这个包没发出去”就重复使用。你以为是小事,用户手机上的系统不这么认为。这条规则听起来死板,但它能让每一台设备都知道自己处在时间线的哪个位置。

工具在安装时遇到版本降级,会自动改用允许降级的参数覆盖,数据保留。这个兜底很有用,尤其是在测试机上。但正式交付不能依赖它。因为允许降级安装意味着你在用“特殊参数”绕过系统的正常判断,用户自己用系统安装器装的时候,没有这个参数,还是会失败。工具能替你兜一次,兜不了一辈子。

如果确实需要回滚,正确的做法不是把旧版本的版本代码改小再装,而是发一个版本代码更高的修复包,把旧功能带回来。比如 3.2.0 出了问题,不要发 3.1.8,而是发 3.2.1,版本代码 321,内容回到 3.1.8 的行为。这样用户能正常覆盖,数据也不用动。只有在测试设备上,才考虑卸载重装旧版,而且要先备份数据。

还有一个小坑:有些人为了“让版本号好看”,把版本代码写成 3.2.0 这种带小数点的字符串。版本代码必须是整数,工具和系统都不认小数点。版本名可以写 3.2.0,版本代码只能写 320、321 这样的整数。这个区别,写需求的时候就要说清楚。

版本代码不是版本名
版本名可以叫 3.2.0、3.2.0-beta、三月版,版本代码必须是整数,而且只能往上加。写需求时两个都写清楚,别让 AI 猜。

实例二:质检工具 2.6.1 的批量交付

派单工具的事故不是第一次。真正让我们立规矩的,是半年前的质检工具。

“净屋质检”是店长用的内部应用,装在十二家门店的十二台平板上。店长用它抽查保洁质量:拍照、打分、写整改意见、让保洁员签字,最后导出一份质检报告。版本 2.6.0,版本代码 260。

半年前,2.5.9 升 2.6.0 的时候,开发换了一台电脑,顺手用了默认签名。十二台平板,一台都覆盖不上。店长们不懂签名,只知道“装不上”,有人直接卸载了旧版,结果两百多张质检照片和整改记录全没了。那两天,十二家店重新补拍、补录,质检主管李姐带着两个人加班到晚上十点。这件事之后,公司才把 JKS 放进保险柜,才要求每次出包必须记录版本代码和证书指纹。

这次 2.6.1 要加“整改复检”功能:上次不合格的项目,复检时能直接调出来,不用重新建单。功能不复杂,但涉及数据表结构,不能改坏。我们决定按新规矩来。

以前怎么做: 开发出包,发到店长群,店长各自下载安装;装不上就远程指导,指导不了就卸载重装;重装之后照片没了,再补拍。十二家店,顺利的话两天,不顺利的话一周。没有人知道哪台平板装的是哪个版本,也没有人留上一版的包。

现在一句话怎么做: 我把 2.6.0 的包拖进安卓修改大师电脑版,先看 aapt 读出的包信息:包名、版本 2.6.0、版本代码 260、最低 SDK、启动页。然后在“设置签名”里选公司 JKS,确认别名和口令。需求写成一句话:

“新增‘整改复检’入口:复检时读取上一次质检的不合格项,允许逐项拍照、打分、签字;版本名改为 2.6.1,版本代码改为 261;包名、签名、权限、原有数据表结构和导出格式不变。”

这句话里,“原有数据表结构和导出格式不变”是重点。质检工具的价值在数据,界面可以变,数据不能乱。AI 改完之后,工具自动回编、对齐、签名、校验,产物落在 build 目录,pack.log 记下全过程。

改完怎么验证: 我先在三台平板上装:一台装着 2.6.0,一台装着更老的 2.5.9,一台是干净的。两台旧版都是覆盖安装,成功,照片和记录都在;干净的那台是全新安装,也正常。然后我让李姐用她自己的平板走一遍完整流程:建单、拍照、打分、不合格项、复检、签字、导出报告。导出的报告格式和 2.6.0 一样,只是多了一列“复检结果”。最后核对 pack.log 的证书指纹,和 2.6.0 一致。

三台通过后,才推到十二家店。这次没有发微信群,而是把 APK 放到公司自己的文件服务器,文件名带版本和日期:“净屋质检_2.6.1_261_20261110_signed.apk”。店长点固定链接下载,覆盖安装。十二台平板,一个下午全部完成,没有一台需要卸载,没有一张照片丢失。

十二台平板同时升级,靠的不是手快,是签名和版本都对
十二台平板同时升级,靠的不是手快,是签名和版本都对

这一单,拆成三个问题

以前怎么做:开发发 APK,店长各自装;装不上就远程指导;指导不了就卸载重装;照片和记录丢了再补。整个过程没有交付文档,没有版本记录,也没有回滚包。

现在一句话怎么做:拖入旧包,选公司 JKS,写一段包含功能、版本、数据边界的更新需求;AI 改完自动打包;先在三台平板上验证,再推全量;交付文档和上一版归档一起放进发布目录。

改完怎么验证:在装着 2.6.0 和 2.5.9 的平板上覆盖安装;看照片、质检记录、整改意见是否还在;走一遍新建、拍照、打分、复检、签字、导出;核对证书指纹;十二台平板逐台看关于页版本号。六项都过,才算交付。

交付文档:一张表把签名、版本、回滚写清楚

两次事故之后,我们做了一张交付表。它不是给开发看的,是给所有经手人看的:我、老许、店长、财务、甚至以后接手的人。

字段例子为什么必须有
应用名净屋派单让人知道这是什么
包名com.jingwu.dispatch确认是不是同一个应用
版本名3.2.0给人看的版本
版本代码320给系统看的版本,覆盖安装的关键
最低 SDK23决定签名要不要 v1
签名模式公司 JKS确认用哪把钥匙
密钥别名jingwu换人签包时知道用哪个
证书指纹pack.log 里的 SHA-256核对是不是同一套签名
安装方式覆盖安装明确会不会清数据
回滚包净屋派单_3.1.9_319_signed.apk出问题时知道退到哪
联系人我,尾号 6217出问题时知道找谁
日期2026-11-17知道这一版是什么时候发的

这张表里,证书指纹是最容易被省略的一项,也是最有用的一项。它是一串看起来像乱码的字符,但它是签名的身份证。打包日志里的 verify 输出会打印它,把新旧两版的指纹并排一比,就知道是不是同一套签名。这个动作只要几秒钟,却能挡住“签错了还不知道”的事故。

证书指纹有 MD5、SHA-1、SHA-256 几种,工具打印的指纹里包含 SHA-256。对比的时候要确保两版用的是同一种算法,不要拿 MD5 和 SHA-256 比,那当然对不上。我们交付表里写的是 SHA-256 的前 16 位和后 16 位,中间省略,够用,也不至于太长。

交付表不放口令。文件名、别名、指纹都可以写,keystore 口令和密钥口令不能写。交付表会跟着 APK 一起发给店长,口令只在我和财务手里。这个边界必须清楚:店长需要知道“这个包是谁签的”,不需要知道“怎么签”。

交付表我们打印两份,一份贴在发布目录的文件夹上,一份放在培训室的签到台。纸会丢,但纸也能被看见。群里的消息会被刷走,纸不会。

回滚包也要写清楚。我们的发布目录里,永远保留上一版的签名 APK,文件名带版本代码和日期。新包出问题,先判断是“回滚”还是“出修复版”。正式环境优先出修复版,版本代码更高,用户正常覆盖;只有在测试设备上,才卸载重装旧版。回滚不是把旧包扔回去,而是一套有备份、有版本、有验证的动作。

交付不是把 APK 发出去,而是让用户手机里的旧版能安全地变成新版,并且随时能退回来。
一张交付表,把签名、版本、回滚和联系人都写在一页纸上
一张交付表,把签名、版本、回滚和联系人都写在一页纸上

内测分发的秩序:先小范围,再全量

培训室的事故之后,我们改了内测分发的方式。以前是“出包就发群”,现在是分三圈。

圈层装多少台谁来装验证什么
第一圈1 到 2 台我自己能不能在旧版上覆盖,数据在不在,主流程通不通
第二圈5 到 6 台店长里的志愿者不同机型、不同系统版本,有没有兼容问题
第三圈全部店长自己或统一推送版本号、签名指纹、关键功能、反馈收集

第一圈最关键。它不需要很多人,只需要一台“装着旧版”的设备。很多问题在干净的设备上测不出来:签名冲突、版本降级、数据迁移、登录状态,都只有在旧版上覆盖才会暴露。那天早上如果有两台“第一圈”的手机在八点半先装一遍,九点半的培训就不会变成排障现场。

第一圈我一般放在正式培训的前一天晚上。装一台平时不太用的测试机,装着旧版,装上新包,打开、登录、走一遍主流程,再放一晚上。第二天早上再看一眼,有没有闪退、有没有提示更新、数据还在不在。这个动作花二十分钟,能避免第二天早上十八台手机同时出问题。

第一圈的检查清单只有四项:

  • 旧版能不能被覆盖,原有数据还在不在
  • 登录状态和权限提示是否正常
  • 主流程能不能走通,新功能能不能用
  • 关于页的版本号和交付表是否一致

四项都过,才放进第二圈。任何一项不过,就退回重打,不带着问题往下走。

第二圈看的是机型差异。Android 9 和 Android 13 的权限行为不一样,千元机和旧旗舰的存储空间也不一样。派单工具要拍照、要定位、要读通讯录,这些权限在旧系统和新系统上的提示位置不同,店长找不到“允许”按钮,也会说“装不上”。第二圈的目的,是把这些“不是安装失败、但用不了”的问题提前找出来。

第三圈才是全量。全量的时候,交付表、下载链接、回滚包、联系人必须一起发。链接要带版本号,不要用“最新版”这种目录。因为“最新版”今天指向 3.2.0,明天可能指向 3.2.1,店长装完了你问他哪一版,他说“最新版”,你没法判断。文件名带版本和日期,谁都能对上。

反馈也要有格式。不要只说“装不上”,要给出四样东西:手机型号、Android 版本、原来装的是哪一版、屏幕上带 Failure 的那行字。有了这四样,大部分问题在十分钟内能定位。没有这四样,只能猜。

这套格式还有一个好处:它能把“情绪”变成“信息”。店长说“你们的破应用又装不上”,你只能道歉;店长说“Redmi Note 11,Android 12,旧版 3.1.8,提示 UPDATE_INCOMPATIBLE”,你五分钟就能定位。不是要求店长懂技术,而是给他一个填空的模板,他照着念就行。

事故之后:把“装不上”变成可预防的流程

那次培训之后,我给自己定了五条规矩:

第一,内测包和正式包用同一套 JKS。测试包也是交付,也会装到别人的手机上,也会留下数据。不能因为是“测试”就用默认签名。

第二,版本代码只增不减。每次出包,不管改了什么,版本代码都要比之前高。版本名可以重复,版本代码不行。

第三,改品牌、改图标、改文案,不改包名。包名一改,就是另一个应用,数据不会跟过来,覆盖安装也谈不上。

第四,验收必须在“装着旧版”的设备上做。干净的设备只能证明“能装”,不能证明“能覆盖”。覆盖安装才是内部交付的常态。

第五,留上一版签名包和一张交付表。出问题时,先看表,再看日志,最后才动手。不要在现场凭记忆找文件。

这五条都不难,难的是每次都做到。工具能替你回编、对齐、签名、校验,能替你装到手机、拉起应用、看前台是不是它,但工具不能替你决定“用哪把钥匙”“版本加到多少”“要不要卸载”。这些是人的责任。

那次培训之后,我们把交付表模板发给了老许,也发给了另外两个给我们做内部工具的开发。他们一开始觉得麻烦,后来发现,填表的时间比处理一次装不上的时间短得多。

现在我们的内测群公告只有一句话:先看交付表,再装包;装不上,把带 Failure 的那行发出来。

流程不是用来好看的,是用来在早上九点半救场的
流程不是用来好看的,是用来在早上九点半救场的

常见问题:签名、版本与覆盖安装的十个问答

问:同样的包,为什么有的手机能装,有的不能?

答:因为那些手机上的旧版不一样。有的旧版是公司 JKS 签的,有的是默认签名签的;有的版本代码是 319,有的是 318。包是同一个,手机上的“前任”不是同一个,结果自然不同。先分类,再处理。

问:默认签名能不能用于内测?

答:不建议。默认签名是工具自带的测试钥匙,不是公司的钥匙。用它发内测包,后面换回公司 JKS 时,所有装过测试包的人都要卸载重装。测试包也是交付,也会留下数据,不能将就。

问:JKS 文件丢了怎么办?

答:不能重新生成一套就当没事。新密钥签出来的包,和用户手机里的旧版签名不同,覆盖不上去。只能找回备份;找不回,就要接受“卸载重装、数据丢失”的代价。正式应用应该提前做两份备份,文件和口令分开保管。

问:版本名改了,版本代码没改,会怎样?

答:系统只看版本代码。版本名从 3.1.8 改成 3.2.0,版本代码还是 318,系统认为你没有升级,甚至可能当成降级。覆盖安装会失败,或者需要允许降级的参数。两个都要改,版本代码只能往上加。

问:签名不一致,卸载重装是不是就行了?

答:能装上,但会清掉应用数据。登录状态、草稿、照片、缓存都可能没了。能换回同一套签名重新打包,就不要卸载。实在要卸载,先让用户备份,或者把数据导出。

问:随机签名什么时候可以用?

答:只适合“装一次就卸载”的临时演示。每次打包都会生成新的密钥和证书,签完就删,所以每一版在系统看来都是不同的发布者。需要升级的应用,绝对不能用它。

问:v1 要不要一直开着?

答:最低 SDK 低于 24 的包必须开,否则 Android 7.0 以下的设备装不上。现代设备主要用 v2、v3,但保留 v1 不会有害,反而能兼容老设备。工具默认勾 v1、v2、v3,是有道理的。

问:覆盖安装会不会丢数据?

答:同包名、同签名的覆盖安装,会保留应用数据;卸载重装会清空数据目录。所以“能不能覆盖”不只是方便不方便的问题,它直接关系到用户的数据。内部交付一定要在装着旧版的设备上验证覆盖。

问:怎么确认新包和旧包是同一套签名?

答:看打包日志里的 apksigner verify --print-certs 输出,对比 SHA-256 指纹。两版指纹一致,说明是同一套签名;不一致,就不要发给用户。这个动作几秒钟,能挡住大事故。

问:回滚能不能直接装旧版?

答:正式环境不建议。系统默认不允许降级,硬装旧版要么失败,要么需要特殊参数。更稳妥的做法是发一个版本代码更高的修复包,把旧功能带回来。测试设备可以卸载重装旧版,但要先备份数据。

写在最后:签名是交付的信用

半年前,质检工具丢了两百多张照片,我们以为是意外。这次派单工具在培训室翻车,我们才知道那不是意外,是流程里一直存在的洞。

签名这件事,看起来是技术细节,其实是交付的信用。用户手机里装着的旧版,是你上次交付的承诺;这次的新包,要能盖在旧版上,数据要还在,登录要还在,才叫“升级”。如果每次升级都要卸载重装,用户丢的不只是数据,还有对你的信任。

安卓修改大师电脑版能做的,是把这条链路收进一个窗口:拖入 APK,aapt 读出包信息;写一句中文需求,挂上素材;选好签名,点“立刻修改”;AI 改完自动回编、对齐、签名、校验;产物在 build 目录,日志在 pack.log,需要的话直接装到手机或模拟器上看效果。它把“改包”从一件需要排期的事,变成一件当天能做完的事。

但它不是万能的。它不能替你找回丢失的 JKS,不能替你决定版本代码,不能替你在卸载重装之前备份数据。它能把错误提示翻译清楚,能把证书指纹打印出来,能把失败原因分成几类,但最后按不按规矩来,还是人的事。

如果你也在一家小公司里维护内部应用,也遇到过“培训时一半手机装不上”的场面,可以去 安卓修改大师智改工坊 看看。官网是 www.apkeditor.cn,产品介绍页在 https://www.apkeditor.cn/ai-version.aspx。只需说话,就能让应用变成你想要的样子——包括在培训开始前,把正确的版本装到十八台手机上。

“我不懂什么签名,只知道装不上就耽误接单。那天十点半重新装好,我手机里的派单草稿还在,这个最实在。”
—— 王店长 · 净屋家政城西店
“以前升级最怕两件事:装不上,装上了数据没了。现在至少知道先看版本号,再看签名,出问题能说清楚是哪一种。”
—— 小陈 · 净屋家政派单员
“我以前觉得测试包随便签一下就行,反正只给内部用。经过这次才知道,测试包也是交付,签名从一开始就不能将就。”
—— 老许 · 应用开发
“半年前那次升级,十二台平板全卸载重装,两百多张照片没了,我们补了两天。这次 2.6.1 一台都没卸载,照片和记录都在。”
—— 李姐 · 净屋家政质检主管
“密钥放在保险柜,口令两个人分开保管,一开始觉得麻烦。后来想想,能签包的钥匙,本来就不该一个人拿着。”
—— 周工 · 净屋家政财务
合规提醒
本文实例均为自有应用或已获授权的项目。安卓修改大师电脑版面向自有版权或已获授权的应用,用于学习、研究、内测等合法场景;请勿用于破解他人付费应用、去除他人应用的安全机制或任何侵犯他人权益的用途。
DOWNLOAD
安卓修改大师智能修改安卓版

手机、平板直接安装,导入 APK 后说一句话,自动反编译、修改、回编、对齐、签名;也能把网址打包成应用,成品可装、可存、可分享。

立即下载安卓版 / 查看详情 →

官网 www.apkeditor.cn · 请仅修改自有版权或已获授权的应用