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

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

查看智改工坊产品介绍 →
versionCode 是台阶,versionName 是台阶上的门牌
versionCode 是台阶,versionName 是台阶上的门牌

发布前最常听到的一句话是“版本号加一”。这句话听起来像常识,做起来却经常变形:有人加的是 versionName,从 2.2.0 改成 2.2.1,versionCode 还是 220;有人加的是文件名,把产物改成 _v2.2.1_final.apk,包里的 code 一动不动;还有人两个都加了,但灰度批次的包和正式包用了同一个 code,只是内容不同。这些包都能装,也都能打开,直到需要覆盖、需要灰度、需要回滚时,问题才一起浮出来。

versionCode 的特殊之处在于,它是少数几个“用户看不见、系统却拿它做硬判断”的字段。用户看到的是 versionName,应用商店展示的也是 versionName,客服记录的还是 versionName;但 Android 在决定“这个包能不能盖掉那个包”时,只看 versionCode。你把 versionName 写得再大,code 不变,系统就认为它们是同一版;你把 versionName 写得更小,code 变大,系统仍然允许升级。名字是给人看的,数字是给系统看的,这两件事必须分开管理。

这篇文章只讲版本号这一条线:code 怎么分配、灰度怎么分批、回滚怎么落地、渠道包怎么排矩阵。它不展开讲签名原理,也不讲界面修改;那些内容在别的篇里。这里要解决的是一个很具体的问题:当同一个应用要发给不同批次、不同渠道、不同环境,并且随时可能撤回时,怎样用一套数字规则,让每一台设备都知道自己该升到哪一版、能不能降回去、降回去会丢什么。只需说话,就能让应用变成你想要的样子,这句话管的是“怎么改”;版本号管的是“改完之后怎么发、怎么退”。

版本号不是给用户看的,是给系统做判断的

先纠正一个常见误解:versionCode 不是“版本号的数字部分”,versionName 也不是“版本号的名字”。它们是两个独立字段,写在 Manifest 里,由不同的角色读取,承担不同的职责。

系统读取 versionCode,用来比较新旧。安装器在覆盖安装时,会拿新包的 code 和已安装包的 code 比较:新包更大,允许升级;相等,允许同版本覆盖;更小,判定为降级,默认拒绝。这个判断发生在安装阶段,和应用里的代码无关,和用户点没点“升级”也无关。只要 code 更小,哪怕内容更新、修了紧急 bug,系统也会先拦一道。

用户、商店、客服读取 versionName,用来识别版本。2.3.1 比 2.3.0 新,这是人的直觉;但系统不这么比。系统只看 code。你把 versionName 从 2.3.0 改成 2.3.1,code 仍然是 230,系统就认为这是同一版,覆盖安装不会有任何“升级”的语义,应用商店也可能拒收,因为同一个 code 已经用过了。

安卓修改大师电脑版在导入 APK 时,会用 aapt 解析出版本号和版本名,写进项目信息。项目目录的 config.ini 里能看到这两个值:

[应用]
AppName=设备巡检助手
PackageName=com.internal.inspect
VersionName=1.4.1
VersionCode=42
MinSdk=21
TargetSdk=30

这两个值在项目里只是“记录”,真正决定安装行为的是 APK 里的 Manifest。改包之后,如果只改了 config.ini,包里的 code 不会变;反过来,如果 AI 改了 Manifest,config.ini 也不一定自动跟着变。所以每次出包后,最稳的核对方式是用 aapt 重新读一遍产物,而不是只看项目卡片上的数字。

versionCode 与 versionName 的分工

把两者的差异列成一张表,后面所有策略都从这张表推出来。

维度versionCodeversionName
类型整数字符串
谁读安装器、应用商店、部分服务端用户、客服、商店页面、报表
作用判断升级、降级、同版本覆盖展示、沟通、归档
能否重复同一个包名加签名下不应重复可以重复,但不建议
能否回退不能,现场水位只增不减可以写回旧名字,但不代表降级
常见写法42、230、20261118011.4.1、2.3.0、2.3.0-beta
改动频率每次对外出包都要动随发布节奏动,可不变

versionCode 的关键约束是“单调不减”。对同一个包名、同一套签名来说,一旦某个 code 发到了任何一台设备上,这个 code 就成了水位线的一部分;后面再出的包,code 必须比它大,否则那台设备就装不上。注意,这里说的是“任何一台设备”,不是“当前正式版”。灰度用户手里的 code 往往比正式版高,如果回滚时只盯着正式版的 code,就会漏掉灰度用户,导致他们装不上回滚包。

versionName 没有单调约束,但它有两个实际用途不能忽略。第一,它是人和人沟通的索引。客服说“你是 2.3.1 吗”,用户能看懂;说“你是 code 223 吗”,用户看不懂。第二,部分服务端和第三方统计会解析 versionName,用来做报表或兼容判断。所以 versionName 虽然不参与安装判断,仍然要有规则,不能今天 2.3.1、明天 V2.3.1-final、后天 2.3.1.1。

还有一个进阶字段:Android 9 起支持 versionCodeMajor,和 versionCode 组合成一个长整型,理论上可以突破单个整数的范围。但大多数应用商店、分发渠道、企业内部分发工具并不完整支持它,普通项目不建议用它来绕开降级限制。把它当成“极端情况下的储备”,不要当成日常手段。

先定“谁比较版本”
如果自家的更新接口用 versionName 做字符串比较,迟早会碰到“1.10 比 1.9 小”的问题。正确做法是让服务端下发纯数字版本码,和本机 versionCode 比大小;versionName 只用于展示。

覆盖安装的三个硬条件

一个包能不能盖掉手机上已安装的包,取决于三个条件同时成立:包名相同、签名相同、versionCode 不小于已安装版本。缺一个,安装器就会拒绝,或者要求先卸载。

包名相同是前提。包名不同,系统视为两个应用,可以共存,也可以各自升级,但数据不互通,登录态不共享。很多“渠道包”为了区分渠道去改包名,结果用户换渠道时要重新登录、重新下载数据,运营还以为只是换了个图标。

签名相同是安全边界。Android 要求新旧包的签名证书一致,才允许覆盖。签名不同时,安装器报 UPDATE_INCOMPATIBLE 之类的错误,安卓修改大师电脑版会弹窗询问是否卸载重装。卸载会清掉应用数据,包括登录态、本地缓存、未同步的订单;所以这个询问不是形式,点之前要想清楚。

versionCode 不小于已安装版本是顺序边界。新包 code 更小,安装器报 VERSION_DOWNGRADE,默认拒绝。安卓修改大师电脑版在自动装机时,遇到这个错误会自动改用允许降级的方式覆盖,数据保留,并在结果里说明。这个能力在内测和回滚演练时很好用,但它不是常规发布手段:降级之后,应用的数据库、缓存结构可能还是新版的,旧代码读新数据,轻则报错,重则丢数据。

三个条件里,包名和签名是“身份”,versionCode 是“辈分”。身份不对,系统不认;辈分不对,系统不让。灰度、回滚、渠道矩阵,本质上都是在管理这三个条件,尤其是第三个。

签名相同这一条,还有一个容易被忽略的细节:系统比对的是签名证书的集合,不是某一个签名文件。一个包可以有多位签名者,覆盖安装时要求新旧包的签名者集合一致;少一位、多一位、换一位,都会被判为签名不一致。有些团队早期用调试证书签过一版,后来换成正式证书,以为“都是自己的证书”就能覆盖,实际上系统只认证书本身,不认“是不是同一家公司”。遇到这种情况,只能卸载重装,或者用 v3 的密钥轮换能力做迁移;后者要提前在旧包里埋好新证书,不是临时能补的。

调试证书和正式证书混用,也是同一个问题的变种。调试证书通常由开发工具自动生成,每台机器可能都不一样;用它签出来的包,在开发机上能覆盖,换一台机器就打不上。灰度期间如果某个批次误用了调试证书,这个批次的用户就和其他批次分成了两个“应用”,后面的正式包盖不上去,只能清数据重装。防止办法很简单:出包前看一眼 pack.log 里的证书摘要,和发布单上的摘要对一遍。

包名、签名、versionCode,三个条件同时成立才叫干净覆盖
包名、签名、versionCode,三个条件同时成立才叫干净覆盖

五种进位策略与适用边界

versionCode 怎么加,没有唯一正确答案,但有几种常见策略。选哪种,取决于团队规模、发布频率、渠道结构和回滚要求。下面五种,从简单到复杂排列。

每次加一

最简单:每次对外出包,code 加一。220、221、222,依次递增。优点是不用想,永远不会重复;缺点是和 versionName 没有直观映射,时间久了没人记得 code 223 对应哪个版本。

适合小团队、发布频率不高、渠道单一的项目。只要坚持“每次出包都加”,它就够用。真正的问题不是策略太简单,而是有人忘记加:测试包加了,正式包忘了;A 渠道加了,B 渠道没加。所以用这种策略,必须把“加一”写进发布检查单,而不是靠记忆。

语义映射

把 versionName 的数字映射成 code,比如 major 10000 + minor 100 + patch。versionName 1.4.1 对应 10401,2.3.0 对应 20300。优点是看到 code 就能大致反推版本;缺点是预留位宽有限,minor 或 patch 超过 99 就会撞车,而且大版本之间的跳跃很大,灰度批次不好插。

适合版本节奏稳定、每个大版本改动较多的产品。用这种策略要提前定好位宽,比如 major 两位、minor 两位、patch 两位,并规定任何一段不得超过 99。一旦某次 hotfix 超过 99,就得换规则,换规则又会让旧设备的 code 水位对不上,所以不如一开始就留足空间。

日期加序号

用年月日加两位序号,比如 2026 年 11 月 18 日的第一版写成 2026111801,第二版写成 2026111802。优点是天然按时间排序,出包日期一目了然;缺点是和 versionName 完全脱钩,而且依赖“当天序号不超过 99”。

这种写法适合内部工具、频繁出包、需要按日期归档的项目。它有一个隐含风险:如果团队跨时区协作,或者构建机时间不准,日期可能回退,code 也跟着回退。用之前先统一构建机的时间和时区,或者干脆用 UTC 日期。

构建号

把持续集成系统的构建号直接当 versionCode。每次构建,构建号自动加一,永远单调。优点是彻底免去手工维护,适合每天多次出包的团队;缺点是本地临时构建不在序列里,容易出现“本地包 code 比线上高”的情况,测试机装过本地包之后,再装线上包就会被判降级。

用构建号的前提是:所有对外包都走同一条构建流水线,本地包不对外。只要有人绕过流水线手工出一个包,水位线就乱了。

渠道分段

把 code 分成若干段,不同渠道用不同段位,比如 A 渠道 1000 到 1999,B 渠道 2000 到 2999。听起来很整齐,实际上最容易出事。

原因很简单:分段只适用于“不同包名”的渠道。如果两个渠道共用同一个包名,它们就是同一个应用,code 必须放在同一条单调序列里;你给 A 渠道 1001、B 渠道 2001,用户从 A 渠道换到 B 渠道时,code 变大,能升级;从 B 换回 A,code 变小,立刻降级失败。更糟的是,如果两个渠道的包签名还不一样,连覆盖都做不到。

所以渠道分段的正确用法是:一个包名一条序列,各段互不干扰。比如 com.company.app.a 用 1000 段,com.company.app.b 用 2000 段,两个应用可以共存,各自升级。只要共用包名,就必须共用一条全局序列。

策略示例优点风险适用
每次加一220、221、222简单、不重复容易忘记、与名字脱钩小团队、单渠道
语义映射1.4.1 对应 10401可反推、直观位宽溢出、跳跃大版本节奏稳定
日期加序号2026111801按时间排序依赖日期与序号内部工具、频繁出包
构建号构建系统自增全自动、单调本地包破坏水位流水线成熟
渠道分段A 段 1000、B 段 2000渠道隔离清晰共用包名时必冲突独立包名渠道

给未来留多少空位

versionCode 是整数,理论范围到二十一亿多,但应用商店会设上限,比如 Google Play 的上限是 2100000000;国内渠道还有各自的审核规则。数字空间看起来用不完,实际分配时仍然要留余量,因为 code 一旦发出去就收不回来,而发布计划总会变。

最实用的做法是“按发布周期预留号段”。比如 2.3.0 这一轮预留 220 到 229,内测、试点、扩大、全量各占一个,中间留几个给紧急修复;下一轮 2.4.0 从 230 开始,不回头用 22x。这样即使一轮里多发了几个 hotfix,也不会和下一轮撞车,更不会出现“修完发现没号可用”的尴尬。

另一种做法是“按年预留”。每年从整千开始,比如 2026 年用 26000 到 26999,2027 年用 27000 起。好处是看到 code 就知道大概年份,坏处是每年只能出九百多版,对高频出包的团队不够。无论哪种,关键不是号段大小,而是把“号段归谁、什么时候可以用下一个”写进发布规则,别让每个人都能随手取号。

还要注意“换方案只能往上换”。你可以在某一天从“每次加一”切换到“日期加序号”,code 从 380 跳到 2026111801,系统会认为这是一次巨大的升级,没问题;但不能反过来,从日期码切回 380,那会让所有设备都变成降级。所以换方案之前,先确认新方案产生的最小值大于当前水位,否则就等到水位涨上来再换。

不管选哪种,有三条底线不能破:同一个 code 不能对应两份不同内容的包;code 不能回退;灰度批次的 code 必须高于当前所有在网设备的 code。这三条守住了,后面的灰度与回滚才有讨论的基础。

灰度:批次、比例与观察窗

灰度不是“把包发给几个人试试”,而是一套有批次、有水位、有退出条件的发布方法。它的目标不是省钱,而是把故障限制在可控范围内,同时保证随时能撤回。

先定义批次。一个批次至少要有四个属性:批次名、versionCode、versionName、覆盖范围。比如“内测批”code 221、versionName 2.3.0、覆盖 5 台测试机;“试点批”code 222、覆盖 1 个仓库;“扩大批”code 223、覆盖 3 个仓库;“全量批”code 224、覆盖全部 12 个仓库。每个批次的 code 必须比前一批大,不能平行,更不能倒挂。

为什么要这样排?因为设备一旦装了 223,就再也装不回 222。你可以在服务端关掉新功能,让 223 表现得像 222,但不能把 code 降回去。所以灰度的“撤回”通常不是“装回旧包”,而是“关开关”或“发一个 code 更高的修复包”。理解这一点,才不会在出事时手忙脚乱地去找旧 APK。

批次versionNameversionCode覆盖范围观察重点退出条件
内测2.3.0-rc12215 台测试机启动、登录、核心流程无阻断问题
试点2.3.02221 个仓库真实网络、扫码枪、打印一个完整业务日无异常
扩大2.3.02233 个仓库并发、数据量、机型差异关键链路稳定
全量2.3.022412 个仓库客服反馈、崩溃、性能观察期结束

观察窗不是越长越好,而是要有明确的检查项。每个批次至少看四件事:应用能不能正常启动和登录;核心业务能不能走通;崩溃和错误日志有没有新增;客服与现场有没有集中反馈。四项都过,才进下一批。任何一项出现阻断,先停批次,再决定是关开关还是发修复包。

批次命名与共存期

批次名要能一眼看出顺序。推荐用 versionName 加批次后缀,比如 2.3.0-g1、2.3.0-g2、2.3.0,同时在发布单里写死对应的 code。不要用“最新”“测试版”“最终版”这种会随时间失效的词,也不要在批次名里省略 code;文件名、发布单、矩阵表三处的 code 必须一致。

灰度期间,旧客户端和新客户端会同时在线,这是和普通发布最大的区别。服务端接口必须向后兼容:新增字段可以让旧客户端忽略,不能把旧字段删掉或改语义;数据库迁移要能向前兼容,先加列、再双写、最后清理,不要在一次发布里做“重命名加删除”。否则灰度用户升级后正常,未升级的用户一调接口就报错,而你很难在第一时间判断是客户端问题还是服务端问题。

功能开关也要按“默认关闭、按批次打开”来做。新功能藏在开关后面,灰度批次先打开,观察通过再扩大;出问题时关掉开关就能回到旧逻辑,不用等回滚包。开关的粒度不要太粗,一个开关控制半个应用,关掉等于全挂;也不要太细,几十个开关没人记得住。按业务能力分,一个能力一个开关,足够。

灰度比例与分发节奏

比例怎么定,取决于分发单位。按仓库、按门店、按班组分发时,用“几个单位”比百分比更好操作:先 1 个、再 3 个、最后全部。按人分发时,才用百分比。无论哪种,批次之间的 code 必须递增,不能因为“这批只发一成”就复用上一批的 code。

分发节奏要和业务节奏对齐。仓库应用最好在上班前发,留出验证时间;门店应用最好在打烊后发,避免影响营业;对外应用最好避开节假日和促销期。发得太晚,出问题没人处理;发得太早,现场还没进入真实业务,观察窗等于没开。

分发方式也要统一。安卓修改大师电脑版的循环打包可以按轮次出包,产物可以按规则命名,然后上传到九种云存储中的一种;固定文件名会覆盖,带时间戳或数字后缀的文件名会保留历史。灰度期间建议用“带版本号的文件名”,每个批次一个目录,别用 latest.apk 这种固定名,否则后一批会把前一批覆盖掉,现场想回退都找不到包。

灰度不是把包随便发几个人,而是让每一批都有编号、有范围、有退出条件
灰度不是把包随便发几个人,而是让每一批都有编号、有范围、有退出条件

还有一条容易被忽略:灰度包和正式包必须用同一套签名。有些团队为了“区分环境”,给灰度包换了证书,结果灰度用户升正式包时签名不一致,只能卸载重装。灰度是版本策略,不是身份策略;身份一旦变了,覆盖安装和 SDK 绑定都会跟着出问题。

回滚:四种手段与代价

回滚是版本管理里最考验预案的部分。真正出事时,最不该做的就是“把上一个 APK 找出来发下去”。因为上一个包的 code 更小,装上去大概率报降级失败;即使强行降级成功,数据也可能不兼容。

下面四种手段,按速度从快到慢、代价从小到大排列。

服务端开关

如果新功能是通过服务端配置控制的,回滚最快的方式是关开关,而不是动包。用户手里的 code 不变,功能回到旧逻辑,数据不动,覆盖范围即时。这是首选手段,但前提是你在开发时就把高风险功能做成了可开关的。

开关回滚的局限是:它只能回滚“行为”,不能回滚“客户端代码”。如果问题出在启动、签名、权限、SDK 初始化这些包内环节,开关关不掉,只能发新包。

回滚版:旧代码加新 code

这是最稳妥的包内回滚。把上一版稳定的代码重新打包,versionCode 改成比当前水位更高的数字,versionName 标成回滚版或修复版,用同一套证书签名,然后按灰度批次发下去。用户看到的是升级,系统也认为是升级,数据保留,覆盖正常。

关键在 code 怎么取。不是“上一版的 code 加一”,而是“当前所有在网设备的最大 code 加一”。如果灰度用户已经装了 223,正式用户还在 222,那么回滚包的 code 至少是 224。取 223 加一,会让灰度用户装不上;取 222 加一,正式用户能装,灰度用户装不上。水位线要按最大值算。

允许降级的覆盖安装

安卓修改大师电脑版在自动装机时,遇到 VERSION_DOWNGRADE 会自动改用 -d 的方式覆盖,数据保留。这个能力适合内测机、自有设备、现场应急,不适合大规模分发给外部用户。原因有三:不是所有安装器都支持降级;降级后新数据可能旧代码读不懂;用户看到“版本变旧”会困惑。

即使用 -d,也要先确认签名一致。签名不一致时,降级也装不上,只能卸载重装。所以“允许降级”解决的是辈分问题,不解决身份问题。

卸载重装

最后手段。能解决签名不一致、数据损坏、升级卡死等问题,代价是清空应用数据。登录态、本地缓存、未同步的记录都会丢;如果应用有本地数据库,用户的历史数据可能永久丢失。用之前必须通知到人,能备份的先备份。

手段生效速度数据覆盖范围适用
服务端开关立即不动全部功能级问题、有开关
回滚版一个分发周期保留按批次代码级问题、需长期
允许降级快通常保留内测、自有设备应急、演练
卸载重装快清空单台或小范围签名不一致、数据损坏

回滚要演练,不能只写在文档里。建议每个季度做一次:找一台测试机,装上当前灰度批次的 code,再装一次回滚包,记录从“决定回滚”到“设备可用”花了多久,中间卡在哪一步,数据有没有丢。演练时故意把回滚包的 code 写小一次,看看安装器报什么错、现场人员能不能看懂;再故意用错一次签名,看看提示是否清楚。这些错误在演练里出现,比在事故现场出现便宜得多。

演练还要覆盖“服务端开关”这条路径。找一个有开关的功能,关掉,确认旧逻辑恢复、新数据不被破坏;再打开,确认新逻辑回来。如果关掉开关后应用直接崩,说明开关的位置不对,或者新旧数据结构不兼容,这比回滚包本身更值得修。

回滚包要提前准备,不要等出事再打。准备内容包括:上一版稳定代码、同一套签名、一个高于当前水位的 code、一份回滚说明、一条分发路径。回滚说明里写清“这次回滚了什么、用户需不需要做什么、数据会不会受影响”,现场人员照着念就行。

回滚不是“回到过去”
版本只能往前走。所谓回滚,是用一个更高的版本号,把旧的行为重新发出去。理解这一点,才不会在事故现场去找那个“上一个 APK”。

渠道包版本矩阵

渠道一多,版本号就容易乱。乱的根源通常不是 code 本身,而是“哪些渠道共用一个包名”这件事没定清楚。先定身份,再定序列,矩阵才排得出来。

如果所有渠道共用一个包名,那就是一个应用、一条 code 序列、一套签名。渠道差异只能放在应用名、服务端参数、登录账号、产物文件名里,不能靠 code 区分。这种模式维护成本最低,升级最顺,适合渠道之间只是供货关系、用户可能互换的场景。

如果每个渠道一个包名,那就是多个应用、多条 code 序列、可以共用一套签名,也可以各用各的。它们能共存,数据不互通,推送和统计要分开配。code 序列各自独立,A 渠道从 100 开始、B 渠道从 200 开始都没问题,因为系统不会拿两个不同包名的 code 做比较。

最怕的是“半独立”:包名相同,签名不同;或者包名不同,却共用一条 code 序列;或者渠道 A 的包能覆盖渠道 B 的包,但数据对不上。这些组合会在现场制造大量无法解释的安装失败。

渠道包名当前版本当前 code目标 code签名状态回滚目标
直营com.internal.order3.7.2372380同一套 JKS全量372 的回滚版
A 经销商com.internal.order3.7.2372380同一套 JKS灰度中372 的回滚版
B 经销商com.internal.order3.7.1371380同一套 JKS待发371 的回滚版
新品牌com.internal.order.newbrand1.2.0120130同一套 JKS独立序列120 的回滚版

这张表要跟着每次发版更新。更新时重点看三列:当前 code、目标 code、回滚目标。目标 code 必须大于该包名下的所有在网 code;回滚目标不能只写“上一版”,要写清那一版的 code 和签名,方便现场核对。

同一版本在多个渠道同时发时,code 可以相同,因为包的内容相同;渠道之间只是可见范围不同,由服务端账号或渠道参数控制。code 只在内容变化时递增,不要为了“给某个渠道单独一个号”而复制出两份内容不同的同 code 包。这是渠道矩阵和灰度批次的分界线:灰度是“同一内容逐步放量”,渠道是“同一版本分人群可见”。

渠道矩阵还要和产物命名对齐。推荐用“应用名_版本名_c版本码_渠道_日期.apk”,例如 订货助手_v3.8.0_c380_direct_20261118.apk。这样即使矩阵表丢了,从文件名也能看出它属于哪个渠道、哪个 code。固定文件名只用于“最新内测”,不要用于多渠道路径,否则后上传的会把先上传的覆盖掉。

渠道矩阵的核心不是表格好看,而是每一行都能回答“这一版给谁、能不能回”
渠道矩阵的核心不是表格好看,而是每一行都能回答“这一版给谁、能不能回”

实例一:仓库盘点助手的灰度与回滚

第一个例子是自家的仓库盘点助手。这个应用给 12 个仓库的盘点班组使用,包名 com.internal.stock,长期用一套 JKS 签名,版本节奏是每月一到两版。2.3.0 要换一套扫码引擎,改动集中在扫码和数量输入,风险中等,但仓库现场的网络和设备型号很杂,一旦出问题会影响当天盘点。

以前怎么做

以前的发布方式很粗:开发在本地打完包,code 随手加一,先装到自己手机上点一遍,然后发到群里,让 12 个仓库“有空就更新”。没有批次,没有观察窗,也没有回滚包。出过一次事:新版本在某一款扫码枪上会把数量输入框顶到屏幕外,仓库只能盲打。当时想回退,翻出上一版 APK 发下去,结果装不上,报版本降级;最后让 12 个仓库卸载重装,登录态全丢,盘点数据也重新同步了一遍。

那次事故之后,我们才意识到:版本号不是发布时随手写的数字,而是回滚预案的一部分。你把 code 加到哪里,决定了他能不能退回来。

现在怎么做

现在 2.3.0 拆成四批,code 从 221 到 224,全部用同一套 JKS 签名:

  1. 内测批 221,versionName 2.3.0-rc1,只发 5 台测试机,覆盖三种扫码枪和两种系统版本。
  2. 试点批 222,versionName 2.3.0,发 1 个仓库,跑一个完整业务日。
  3. 扩大批 223,发 3 个仓库,重点看并发和数据量。
  4. 全量批 224,发剩余仓库。

每个批次的包都用电脑版出:导入源包,在需求框里写“把 versionCode 改成 222,versionName 改成 2.3.0,其他不动”,签名沿用项目里的 JKS,打包四步走完看 pack.log。产物按 盘点助手_v2.3.0_c222_whA_20261118.apk 命名,放到云存储的批次目录里;固定名 latest.apk 只放在试点目录,方便现场下载,不用于归档。

试点批真的出了问题:222 在 A 仓库的一台老设备上,扫码后键盘弹出会遮住数量框。这个问题在测试机上没复现,因为测试机屏幕更高。按照以前的习惯,可能会直接发 223,赌其他仓库没这个问题;这次我们停批,先确认影响范围。

处理方式分两层:先在服务端把“新扫码界面”的开关关掉,让 222 回到旧界面,仓库当天能继续作业;同时准备修复包。修复包没有回退到 221,而是基于 2.3.0 修好键盘遮挡,code 定为 224,versionName 2.3.1。原因是:222 已经发到 A 仓库,223 也发到了三个仓库,现场水位是 223;回滚包如果写 223,装不上去;写 222 更不行。只有 224 能覆盖所有已发设备。原定 224 的全量表还没有发出,这个号段直接让给修复包,不算复用。

修复包先发 A 仓库验证,再按 223 的范围发三个仓库,最后全量。原来的 224 全量计划顺延,code 改成 225,versionName 2.3.1。这样既没有让任何人降级,也没有丢数据。

改完怎么验证

每个批次发出后,按固定动作验收:

  • 在设备上执行 adb shell dumpsys package com.internal.stock | findstr versionCode,确认实际安装的 code 与批次表一致,不看应用内显示的名字。
  • 打开应用的“关于”页,确认 versionName 与批次表一致;如果关于页读的是缓存,重启一次再看。
  • 用同一台设备覆盖安装下一批,确认不报降级、不丢登录态;再从下一批装回上一批,确认会报降级,证明水位线生效。
  • 让仓库跑一笔真实盘点,确认扫码、数量、提交、同步四条链路都通;重点看那台出过问题的老设备。
  • 在服务端按 code 统计在线设备,确认批次覆盖范围与计划一致,没有漏发或错发。
  • 把回滚包放在随时可取的位置,确认它的 code 高于当前所有在网设备。

这轮灰度最大的收获不是修好了键盘,而是把“水位”变成了团队共同的概念。现在每次发版前,发布负责人会在群里贴三行:当前最大在网 code、本批目标 code、回滚 code。三行对齐,才允许出包;有一行对不上,就停下来先查。这个动作只花两分钟,却能挡掉大部分“发出去才发现装不上”的事故。

“以前我最怕半夜接到仓库电话,说新版本用不了。现在我先问是哪个批次、code 多少,然后看能不能关开关。回滚包提前备好,心里就不慌。”
—— 老彭 · 仓储信息化负责人
“验证版本号不要看应用里写的字,要看系统里的 code。应用可以骗你,安装器不会。”
—— 小丁 · 测试工程师

实例二:经销商订货端的渠道版本矩阵

第二个例子是自家的经销商订货端。这个应用给 6 家经销商下单用,包名统一是 com.internal.order,渠道差异通过登录账号和服务端参数区分,不换包名。今年新品牌独立,另起了一个包名 com.internal.order.newbrand,需要和旧应用共存。

以前怎么做

以前的渠道管理是一团乱麻。6 家经销商共用包名,但有人为了“区分渠道”,用不同的证书签名;有人把 code 按渠道分段,A 经销商从 1000 开始,B 经销商从 2000 开始。结果用户换经销商登录时,装不上对方的包;两个经销商的包互相覆盖失败;客服让他们卸载重装,登录态和购物车全丢。

更麻烦的是版本号复用。同一个 code 380,上午给直营发了一版,下午给 A 经销商发了一版,内容不同,文件名都叫 订货助手_3.8.0.apk。出了问题时,谁也说不清现场装的是上午那版还是下午那版。渠道矩阵表倒是有,但只记了 versionName,没有记 code 和签名,等于没有。

现在怎么做

现在先定身份:6 家经销商共用 com.internal.order,一套 JKS 签名,一条全局 code 序列;新品牌用 com.internal.order.newbrand,独立序列,但尽量共用同一套签名,方便维护。渠道不再靠 code 区分,而是靠登录账号、服务端渠道字段和产物文件名。

版本矩阵这样维护:

渠道包名版本名code签名分发方式回滚目标
直营com.internal.order3.8.0380JKS-A全量3.7.2 内容,code 381
A 经销商com.internal.order3.8.0380JKS-A全量3.7.2 内容,code 381
B 经销商com.internal.order3.8.0380JKS-A灰度 1 店3.7.2 内容,code 381
C 经销商com.internal.order3.7.2372JKS-A待发未发 380,暂不需要
新品牌com.internal.order.newbrand1.3.0130JKS-A独立发布1.2.1 内容,code 131

每次发版,先更新矩阵,再出包。出包时在需求框里写清 code 和 versionName,产物按 订货助手_v3.8.0_c380_B_20261118.apk 命名,上传到对应渠道目录。循环打包只用于“同一版本多轮出包”的场景,每轮的 code 必须在需求里明确,不能让工具猜;固定文件名只用于各渠道的 latest.apk,历史版本一律带 code。

新品牌因为包名不同,code 从 100 起独立算,不和旧品牌比大小。两个应用可以同时装在店长的手机上,各自升级,互不影响。代价是后台多一套推送、统计、地图配置;这部分在依赖盘点里单独列了一行,避免发版时漏改。

改完怎么验证

渠道版本的验证,重点是“同一包名的渠道之间不能互相打架”:

  • 从直营包覆盖到 A 经销商包,确认能升级、登录态保留;再从 A 经销商包装回直营包,确认同样能升级,不报降级。
  • 用 B 经销商的账号登录,确认订单、价格、库存属于 B 经销商,不串到其他渠道。
  • 检查产物文件名与矩阵表一致,code、渠道、日期三项都能对上;随便抽一个包,用 aapt 读出的 code 与文件名一致。
  • 让 B 经销商的一台设备装灰度包,另一台装正式包,确认两台的推送、统计、订单都落在正确渠道。
  • 新品牌与旧品牌同时安装,确认桌面图标、应用名、登录账号都能区分,互不覆盖。
  • 准备一个基于 3.7.2 的回滚包,code 用 381,确认它高于当前所有在网设备;在一台测试机上演练一次覆盖,确认不丢数据。
回滚包不是旧文件,而是一个 code 更高的“旧行为”
回滚包不是旧文件,而是一个 code 更高的“旧行为”
“我以前只看版本名,觉得 3.8.0 就是 3.8.0。现在我知道,同一个 3.8.0 可能有两个 code,发错一个,现场就装不上。矩阵表救过我好几次。”
—— 阿凯 · 渠道运营

打包链路里的版本核对

版本号这件事,工具能替你读、替你改、替你签,但不能替你判断“这个数字该是多少”。把打包链路里的每个接触点列出来,能少掉很多“以为改了其实没改”的情况。

导入时,aapt 解析出版本号和版本名,写进项目信息。这个时候的值是源包的值,不是你这次要发的值。很多人看到项目卡片上写着 3.7.2,就以为这次出包也是 3.7.2,忘了在需求里改。

改包时,versionCode 和 versionName 写在 Manifest 里,AI 按需求修改。需求要写具体数字,不要写“版本号加一”,因为它不知道当前是多少,也不知道你指的是哪个字段。写“把 versionCode 改成 381,versionName 改成 3.8.1”,比写“升个版本”可靠得多。

打包时,四步是回编、对齐、签名、校验,全过程写进 pack.log。产物默认命名是“应用名_版本号_signed.apk”,这里的版本号是 versionName,不含 code。所以文件名相同不代表包相同;同名覆盖时,code 可能已经变了。归档时最好把 code 也写进文件名。

打包后,可以自动装机。遇到 VERSION_DOWNGRADE,工具会自动用允许降级的方式覆盖;遇到签名不一致,会询问是否卸载重装。这两个行为在版本演练时很有价值:你可以故意装一个低 code 的包,确认工具提示降级;也可以故意换一套签名,确认它提示不兼容。但不要把它们当成发布流程的一部分。

出包后,用 aapt 再读一遍产物:

aapt dump badging signed.apk | findstr versionCode

确认输出的 code 与你的发布单一致。再看一眼 pack.log 里的签名模式和证书摘要,确认没有用错证书。最后把产物、发布单、矩阵表三样放在同一个目录,才算一次完整的交付。

三个地方别只改一个
项目配置里的 VersionCode、Manifest 里的 versionCode、发布单上的 code,是三件事。改包时至少确认前两个一致,交付时确认第三个与前两个一致。只改一个,后面一定有人被坑。

常见坑与排查

版本号相关的坑,大多不是技术难题,而是流程漏洞。下面这些,几乎是每个团队都会踩一遍的。

现象最可能的原因处理
改了 versionName,装上去还是旧版code 没变,系统认为是同一版改 code,重新出包
覆盖安装报降级新包 code 小于已安装 code提高 code,或确认是否要降级
灰度用户装不上回滚包回滚包 code 没超过灰度水位按最大在网 code 加一
同一个 code 出现两个包出包时复用了 code建立发布单,出包前查重
渠道之间互相装不上包名相同但签名不同统一签名,或改包名
应用商店拒收code 重复或超过上限查重、留足增长空间
降级后应用崩溃新数据被旧代码读取避免常规降级,回滚发新 code
服务端提示“已是最新”服务端用字符串比较 versionName改用数字 code 比较
测试机装过本地包后装不上线上包本地包 code 更高本地包单独包名,或统一流水线
文件名相同但内容不同固定文件名覆盖,code 已变文件名带 code,归档留历史
回滚包找不到只留了 latest,没有历史每版归档,云存储分目录
多品牌 code 互相比较包名不同却共用序列一个包名一条序列

最隐蔽的是“服务端用字符串比较版本名”。1.10 和 1.9 按字符串比,1.10 反而更小;2.3.0 和 2.3.0-beta 比,后缀又会干扰。正确做法是服务端下发纯数字 code,客户端拿本机 versionCode 比大小;versionName 只用于展示。这个改动不大,但能避免大量“明明发了新版,用户却收不到更新”的投诉。

第二隐蔽的是“本地包水位”。开发为了方便,用 Android Studio 直接装了一个 code 9999 的调试包到测试机;后来测试机装线上 code 380 的包,系统报降级。于是有人用 -d 强行装,数据留下,但应用行为开始诡异。解决办法是给调试包单独的包名后缀,或者规定测试机只装流水线包。水位线一旦被本地包抬高,后面所有灰度判断都会失真。

第三隐蔽的是“回滚包复用旧 code”。很多人觉得“回滚就是回到上一版”,于是把上一版的 APK 原样发出去。结果现场一半设备装得上、一半装不上,因为装过灰度版的设备水位更高。回滚包必须重新打、重新签名、code 取最大值加一,这不是形式主义,是安装器的硬规则。

水位线不是当前正式版,而是所有在网设备里最高的那个 code
水位线不是当前正式版,而是所有在网设备里最高的那个 code

谁来定规则,以及什么时候改

版本号规则不需要复杂,但需要有人负责。最常见的分工是:产品定 versionName 的语义,开发定 versionCode 的分配,测试核对水位,发布负责人维护矩阵表。四个人各管一段,交接时就不会出现“我以为他改了”。

规则要写下来,放在项目目录里,和盘点表、发布单放在一起。至少写清五件事:采用哪种进位策略;code 的唯一来源是什么;灰度批次怎么命名;回滚包的 code 怎么取;渠道包是共用包名还是独立包名。写下来之后,每次发版照着做,不要凭记忆。

什么时候需要改规则?换发布系统、换签名、开新渠道、引入独立品牌、应用商店改上限,这几种情况要重新评估。改规则之前,先确认旧设备的 code 水位,别让新规则产生比旧 code 更小的值。规则可以演进,但不能倒退;一旦倒退,所有在网设备都会变成“装不上”的状态。

工具在这件事里的角色,是把重复动作做稳:导入时读版本、改包时写版本、打包时签名校验、装机时处理降级。安卓修改大师智改工坊把这套链路收进一句中文需求里,让你不用手工敲 apktool 和 apksigner;但 code 派给谁、灰度分几批、回滚包什么时候备,仍然要人来定。只需说话,就能让应用变成你想要的样子,这句话解决的是“怎么改”;版本规则解决的是“改完之后,怎么发、怎么退、怎么证明”。两件事都做好,发布才不是一次赌博。

本文所有实例均为自有版权或已获授权的内部应用,仅用于学习、研究与内部测试。请勿将文中方法用于破解他人付费应用、绕过安全机制或侵犯他人知识产权。应用商店与分发渠道的版本规则可能调整,发布前请以对应平台的官方说明为准。

“我现在发版只认三样:发布单、矩阵表、回滚包。三样齐了才点发送。版本号不是数字游戏,是事故时的退路。”
—— 老魏 · 发布负责人

安卓修改大师智改工坊的产品介绍与下载入口在 https://www.apkeditor.cn/ai-version.aspx,官网是 www.apkeditor.cn。如果你也在为灰度批次和回滚包发愁,先把那张渠道矩阵表补全,再谈出包。

DOWNLOAD
安卓修改大师智能修改安卓版

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

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

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