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

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

查看智改工坊产品介绍 →
一个 APKS 在桌面上是一个文件,在 Android 眼里却是一组 APK
一个 APKS 在桌面上是一个文件,在 Android 眼里却是一组 APK

把 APKS 拖进安卓修改大师电脑版的人,很多人会先问同一个问题:为什么项目建起来了,包名和应用名却是空的?还有人更困惑:明明只改了一个图标,装到手机上还是旧图标;或者 adb 回一句 INSTALL_FAILED_INVALID_APK,连装都装不上。问题通常不在改包这一步,而在更前面:手里的文件根本不是“一个 APK”,而是一组 APK 的容器。

Android App Bundle 把“一次构建、按设备下发”做成了默认。开发者上传的是 AAB,商店或分发工具再把它切成 base 和若干 split:屏幕密度高的设备拿高密度资源,arm64 设备拿 arm64 的 so,中文环境拿中文资源。用户装完看到的仍是一个应用,但安装器实际提交的是一个 session,里面有一份 base 和若干份 split。改包工具如果只看见 base,就会误以为那就是全部。

这篇文章只讲分包:APKS、XAPK、APKM 三种容器分别是什么,base 与 split 各自承担什么,设备怎样挑选 split,合并成完整 APK 有哪几条路,只改 base 会付出什么代价。最后用两个自家应用把“以前怎么做、现在怎么做、改完怎么验证”完整走一遍。只需说话,就能让应用变成你想要的样子,但前提是先把“一个文件”还原成“一个应用”。

三种容器:APKS、XAPK、APKM 各是什么

先分清容器。APKS 是 Google 官方路线:AAB 经过 bundletool 处理后得到的 .apks 文件,本质是一个 ZIP。里面有 toc.pb,描述这个包包含哪些 split、各自面向什么配置;有 splits/ 目录,常见的是 base-master.apk、base-arm64_v8a.apk、base-xxhdpi.apk、base-zh.apk 这类文件。用 universal 模式生成的 APKS 里还会多一个 universal.apk,它把所有配置合在一起,体积大,但一台机器就能装。

XAPK 是第三方分发里常见的容器。它同样是 ZIP,里面通常有 manifest.json、icon.png、base APK、若干 config split,有些还带 OBB 数据包。XAPK 不是 Android 系统原生格式,不同站点、不同打包器写出来的字段并不完全一致。安装它需要支持 XAPK 的安装器,或者自己解压之后用 adb install-multiple 把 base 和 split 一起提交。

APKM 是另一类分发容器,常见结构是 ZIP 里放 info.json、base.apk、split_config.*.apk。它也不是系统原生格式,安装器往往会做额外校验。不同来源的 APKM 在封装细节上可能有差别,通用工具不一定能把它当成普通 APK 直接打开。遇到打不开的 APKM,先确认它是不是需要专用安装器,再考虑合并。

容器典型来源内部结构安装方式对改包的影响
APKSAAB 经 bundletool 生成toc.pb + splits/base-*.apk,universal 模式含 universal.apkbundletool、安装器、adb install-multiple官方结构清晰,适合按设备选 split 或转 universal
XAPK第三方分发、站点打包manifest.json + base + split,可能带 OBB支持 XAPK 的安装器、解压后多包安装字段不统一,先解压看清 base 与 split
APKM第三方分发info.json + base + split_config.*专用安装器、解压后多包安装可能有额外校验,通用工具未必直接可读

三者的共同点比差异更重要:它们都是 base 加 split 的组合,都要求同一个包名、同一套签名、同一个 versionCode。差别主要在元数据文件、文件命名和安装器。改包时如果只盯着扩展名,很容易把“容器”当成“安装包”,然后在反编译或安装环节反复碰壁。

导入支持不等于直接可改
安卓修改大师电脑版支持导入 APK、JAR、APKS、XAPK、APKM、CLASS。但 aapt 解析的是单个 APK,集合包往往读不出包信息,界面会以文件名继续建项目并给一句说明;反编译也可能因为没有可识别的清单而失败。能建项目,不等于能顺顺利利地改。要把分包当普通 APK 改,最稳的前置动作是先合并。

容器格式的选择,往往不是改包的人决定的,而是应用的构建与分发方式决定的。走 Google Play 的团队,手里多半是 AAB 或 APKS;做国内第三方分发的团队,常见 XAPK、APKM;还有团队两者都有,内测发 APKS,外部合作发 XAPK。改包之前先问一句“这个文件是从哪来的”,比直接拖进工具更有用。来源决定了它有没有 toc、有没有 manifest.json、split 命名是什么,也决定了合并工具能不能识别。

APKS、XAPK、APKM 的外壳不同,里面都是 base 与 split 的组合
APKS、XAPK、APKM 的外壳不同,里面都是 base 与 split 的组合

base 与 split:一个应用被拆成哪些角色

base 是主包。它带 AndroidManifest.xml,声明包名、版本、权限、启动 Activity、应用图标、主题;它通常还带核心代码 dex、默认资源和一个 resources.arsc。没有 base,应用就没有身份,split 也无法单独安装。很多人把 base 当成“完整应用”,这是误解的起点。

config split 是按设备配置拆出来的资源包。ABI split 带 lib/arm64-v8a/、lib/armeabi-v7a/ 这类 native 库;密度 split 带 res/mipmap-xxhdpi/、drawable-xxxhdpi/ 这类图片;语言 split 带 values-zh/、values-en/ 这类字符串。它们的清单里通常有 split="config.arm64_v8a" 这样的属性,资源型 split 还常见 android:hasCode="false",表示自己不带代码。

feature split 是按功能拆的模块。它可能带自己的 dex、资源、甚至 native 库,清单里会出现 android:isFeatureSplit="true";它的配置 split 会用 configForSplit 指向这个功能模块。feature split 的入口在 base,实际内容在 split;只装 base 时,入口可能还在,点进去就崩。

角色常见文件名装了什么缺失后的表现
basebase-master.apk、base.apk清单、核心 dex、默认资源、启动入口根本装不上,或没有应用身份
ABI splitbase-arm64_v8a.apk、config.arm64_v8a.apklib/arm64-v8a/*.soUnsatisfiedLinkError、native 功能失效
密度 splitbase-xxhdpi.apk、config.xxhdpi.apk对应密度图片、部分 drawable图标模糊、图片缺失、界面错位
语言 splitbase-zh.apk、config.zh.apkvalues-zh 等语言资源文案回退到默认语言,或显示旧文案
feature splitfeature-*.apk功能模块的 dex、资源、so入口在但点开崩溃,或功能不可用

资源 ID 在同一个 bundle 里是统一分配的,所以 base 清单里的 android:icon 指向的那个 ID,可能在密度 split 里有更适合当前屏幕的版本。应用名、主题、字符串也是一样:base 里有一份默认值,语言 split 里可能有一份更匹配当前 locale 的值。运行时资源解析会按配置挑最合适的那份,而不是只看 base。

安装器并不逐个理解这些 APK 的业务含义,它只做一致性检查:包名相同、versionCode 相同、签名相同、split 名称不重复,然后把它们放进同一个安装会话。会话提交成功后,系统把它们当成一个 package,资源解析、类加载、so 加载都按这个 package 来。所以 split 不是“外挂插件”,而是同一个应用被切开的几块。你改其中一块,其他块仍然按原来的内容参与解析;你给其中一块换签名,整个会话就不成立。

这也是为什么“只改 base”经常看起来能运行、实际却处处不对劲。系统不会告诉你“这个资源来自 split”,它只会按配置选出它认为最合适的那份。你以为改的是唯一一份,系统眼里只是改了兜底的那份。

这就是“base 是骨架,split 是外设”的意思。骨架决定这个应用是谁,外设决定它在某台设备上长什么样、说哪种语言、跑哪种指令集。改包时只改骨架,外设还是旧的,设备就会用旧的外设把新骨架盖住。理解这一点,后面所有“为什么改了没生效”的问题都能对上号。

base 不是完整应用
base 单独存在时,可能能装上,也可能装不上;即使装上,缺少 ABI、密度、语言或 feature split,运行起来也可能崩。把 base 当完整 APK 改,等于把应用的一条腿当成整个人。
base 管身份与入口,split 管某类设备配置下的资源与代码
base 管身份与入口,split 管某类设备配置下的资源与代码

设备怎么挑 split:ABI、密度、语言三张筛子

商店下发时,split 是平台替设备挑的。做内测分发、或者要自己合并时,这一步得自己来。挑错的后果很直接:ABI 选错,装上了也加载不了 so;密度选错,图标和图片不是最合适的那一档;语言选错,用户看到的是默认语言而不是本地语言。

先读设备,不要凭型号猜。ABI 看 adb shell getprop ro.product.cpu.abilist,它会按优先级列出设备支持的指令集,常见的是 arm64-v8a,armeabi-v7a,armeabi。屏幕密度看 adb shell wm density,得到的数值对应 ldpi、mdpi、hdpi、xhdpi、xxhdpi、xxxhdpi 这些档位。语言看 adb shell getprop persist.sys.locale,或者 adb shell settings get system system_locales,后者在新系统上更常见。

设备画像应选的 split不该带的 split说明
arm64、420dpi、中文arm64_v8a、xxhdpi、zharmeabi_v7a、mdpi、en典型国产中高端机
32 位、320dpi、英文armeabi_v7a、xhdpi、enarm64_v8a、xxxhdpi、zh老设备或低端机
公开下载、未知设备universal,或完整 split 集不要只带一套 ABI兼容优先,体积其次
固定车队、型号统一按车队设备 spec 选不要带无关语言与大图体积小,分发快

bundletool 提供了设备 spec 这条路:bundletool get-device-spec --output=device-spec.json 可以从连接的设备生成配置,再用 bundletool build-apks --device-spec=device-spec.json 生成只面向这类设备的 APKS,最后 bundletool install-apks 安装。这样做出来的包小,适合内测车队;但换一台不同 ABI 或不同密度的设备,就可能装不上。

universal 则是另一个极端:所有 ABI、所有密度、所有语言都放进一个 APK。它不挑设备,兼容性最好,代价是体积。对于要交给改包工具处理、然后再分发给一群设备型号不明的同事的场景,universal 往往更省事。对于只发给一个固定型号的车队,设备专用包更合适。选择的标准不是“哪个高级”,而是“这批设备能不能覆盖”。

还有一个容易忽略的细节:64 位设备的 ABI 列表通常同时包含 arm64-v8a 和 armeabi-v7a,系统会优先选主 ABI,但不是所有 so 都同时提供两套。有些应用只在 arm64 split 里放了新库,32 位 split 还是旧库;合并时如果只带一套,另一类设备就会出现“界面能开、功能一用就崩”。判断方法不是看设备是不是 64 位,而是看它的 abilist 里到底有哪些值,以及包里的 lib/ 目录是否覆盖这些值。

adb shell wm density 拿到的是当前逻辑密度,adb shell wm size 拿到的是分辨率;两者结合才能判断设备实际会取哪一档图片。语言也一样,系统语言、应用内语言、地区设置可能不是一回事。应用如果自己做了语言切换,设备 locale 只是默认值,最终读哪套资源还要看应用把 Configuration 改成了什么。合并前把这些变量列清楚,比合并后一台台试要快。

不要用一台机器代表全部
开发机上跑的是 arm64,测试机上可能是 32 位;模拟器默认密度和真机也不一样。内测分发前先盘点设备,至少覆盖一个 arm64、一个 32 位、一个高密度和一个低密度。

合并的四条路:从最稳到最险

把分包变成完整 APK,有四条路。第一条最稳:手里有原始 AAB,用 bundletool 的 universal 模式重新出包。命令不复杂,关键是签名参数要和原应用一致,否则出来的包不能覆盖升级。

java -jar bundletool.jar build-apks ^
  --bundle=app.aab ^
  --output=app-universal.apks ^
  --mode=universal ^
  --ks=company.jks ^
  --ks-key-alias=company ^
  --ks-pass=env:KS_PASS

生成的 APKS 仍是 ZIP,解压后取 universal.apk。这个 APK 已经把 base 和所有 split 合在一起,可以当普通 APK 导入安卓修改大师电脑版。它的体积会比设备专用包大,但结构完整,不会出现“只改了 base”的那些问题。

第二条路是合并工具。手里只有 APKS、XAPK 或 APKM,没有 AAB,就把容器解压,确认 base 与 split 的包名、versionCode、签名一致,再交给支持 split 合并的工具输出完整 APK。合并会改变文件内容,所以输出后必须重新签名;签名要用同一套密钥,否则覆盖安装会被拒。合并工具的选择要看它是否能处理资源表、manifest 合并和重复资源,不要只看它能不能把文件拼成一个 ZIP。

第三条路是手工用 apktool 合并。解码 base 和每个 split,把 split 的 res/、lib/、assets/ 按目录合并进 base,处理重复资源和 manifest,再回编、对齐、签名。这条路只适合资源结构简单、split 数量少的包。资源表合并是难点:同名资源、不同配置、资源 ID 冲突,任何一处处理不好,回编能过,运行就崩。没有把握时不要把它当常规路径。

手工合并如果一定要做,按下面的顺序走,能把大部分低级错误挡在前面:

  1. 解压容器,列出 base 与所有 split,记录每份的包名、versionCode、split 名称和证书指纹;任何一项不一致,先停下来查来源。
  2. 用 apktool 分别解码 base 和需要合并的 split,输出到不同目录;不要在一个目录里反复覆盖,否则后面分不清哪份资源来自哪里。
  3. 合并 lib/:按 ABI 目录把 split 里的 so 拷进 base 对应目录,同名文件先比对大小与哈希,确认不是不同版本。
  4. 合并 res/:按资源类型和配置限定符放置,遇到同名资源先看是不是同一配置;不同配置的同名资源应该共存,不是互相覆盖。
  5. 合并 assets/:按原路径放入,注意大小写;Android 的 assets 在某些文件系统上大小写敏感,合并后要在设备上实际打开一次。
  6. 合并清单:去掉 split 相关的 split 属性,保留 base 的 application,把 feature 的组件、provider、service 按需并入,避免重复声明。
  7. 回编、对齐、签名,再用 aapt dump resources 对比关键资源 ID 和值;最后在干净设备上安装并跑主流程。

这套步骤里,第 4 步和第 6 步最容易出错。资源表不是普通文件夹,改错一个 ID 可能回编成功、运行时才崩;清单合并则容易出现重复的 provider authority、重复的权限声明或者 exported 属性不对。没有工具辅助时,尽量只合并资源型 split,不要轻易合并带 dex 的 feature split。

第四条路是不合并,保留 split 结构。解码每个 split,只改要改的那一份,回编后用同一套签名重签所有 split,versionCode 保持一致,再用 adb install-multiple 或安装器一起装。这条路适合必须保留动态功能模块、或者要继续走商店分发的团队。安卓修改大师电脑版的打包链路产出的是单个 signed.apk,不产出 split 集;要走这条路,得用命令行或其他流水线。

路径需要的材料产物风险适合谁
AAB + universal原始 AAB、签名密钥完整 APK低,前提是签名一致有源码或构建产物的团队
合并工具APKS/XAPK/APKM完整 APK中,取决于工具对资源表的处理只有分发包、要快速改
apktool 手工合并base 与各 split完整 APK高,资源与清单容易出错结构简单的小包、研究用途
保留 split 集每个 split、统一签名多 APK 安装集中高,签名与版本必须全对齐动态功能、商店分发
合并后是另一种安装形态
完整 APK 和 split 集在系统里不是同一种安装形态。用完整 APK 覆盖一个 split 安装,可能被系统拒绝;反过来也一样。内测分发要统一形态,必要时先卸载再装,但卸载会清掉应用数据,提前备份。
只改 base 时,split 里的资源、so 与签名仍然按旧的那套走
只改 base 时,split 里的资源、so 与签名仍然按旧的那套走

只改 base 的五个后果

第一个后果是资源被 split 覆盖。你改了 base 里的 res/mipmap-xxxhdpi/ic_launcher.png,但密度 split 里还有一份 xxhdpi 图标,设备按密度选中 split,桌面还是旧图标。你改了 base 的 values/strings.xml,语言 split 里有 values-zh,中文设备读 split,文案没变。改的那份不是设备实际使用的那份,这是最常见、也最隐蔽的坑。

第二个后果是 native 库缺失。ABI split 带 lib/arm64-v8a/*.so,base 里可能一个 so 都没有。只装 base,应用启动时 System.loadLibrary 找不到库,直接 UnsatisfiedLinkError。有些应用把 so 放在 base 里,有些放在 split 里,不能凭经验假设。

第三个后果是签名不一致。你改了 base,重新签了 base,split 还是旧签名;安装器把 base 和 split 当成同一个包的不同部分,签名必须一致,否则整个 session 被拒。只改 base 不重签也不行,签名校验过不了。换句话说,改 base 之后,要么所有 split 一起重签,要么这个包根本装不进去。

第四个后果是 versionCode 不一致。你为了发新版本,把 base 的 versionCode 从 101 改成 102,split 还是 101;安装器会认为这组 APK 不属于同一个版本,安装会话失败。分包集里的版本号必须整体一致,不能只动 base。

第五个后果是 feature split 入口崩溃。base 里有功能入口,代码和资源在 feature split 里;只装 base,入口还在,点进去找不到类或资源,直接崩。用户看到的是“这个按钮一点就闪退”,日志里是 ClassNotFoundException 或 Resources$NotFoundException。

只改 base 的动作表面现象根因正确做法
只换 base 图标桌面还是旧图标密度 split 覆盖合并后改,或改对应密度 split
只改默认 strings中文界面没变语言 split 覆盖同时改 values-zh,或合并后改
只重签 base安装失败split 签名不一致所有 split 用同一密钥重签
只升 base 版本号安装会话失败split 版本号没跟上整组版本号一起升
只装 base点功能闪退feature split 缺失装完整 split 集或合并

这五个后果的共同点是:问题不在你改的那一行,而在你没改的那几份。只改 base 看起来省了合并的步骤,实际上把风险挪到了安装之后。测试机上可能刚好命中了 base 的那份资源,看起来正常;换一台密度不同、语言不同、ABI 不同的设备,问题才冒出来。

省一步,赔一串
合并要花几分钟,只改 base 可能省下这几分钟,但后面要用安装失败、图标不换、文案不回、闪退来还。分包场景里,先合并再改,通常是总耗时最短的路。

签名、toc 与安装会话:三个容易忽略的细节

先说签名。分包集里的每一份 APK 都带签名,而且必须来自同一套密钥。Android 在安装会话里会校验这一点:base 和 split 的证书不一致,整个会话直接失败。很多人只重签了改过的那一份,其他 split 没动,结果安装器报签名不一致;还有人把 base 重签了、split 保持旧签名,以为“反正只装 base”,最后要么装不上,要么装上了但系统里留着两套身份。

签名的版本也要留意。v1 是 JAR 签名,v2 是对整个 APK 的签名块,v3 支持密钥轮换,v4 用于增量安装。安卓修改大师电脑版默认开 v1、v2、v3,v4 默认关;这套组合覆盖绝大多数设备。分包集重签时,每一份都要用同样的版本组合,不要 base 开 v3、split 只开 v1。签完还要用 apksigner verify --print-certs 逐份验一遍,确认证书指纹一致。

再说 toc。APKS 里的 toc.pb 是一张目录,告诉 bundletool 这个包有哪些 split、各自面向什么配置、安装时怎么选。bundletool install-apks 会读它;adb install-multiple 不读它,只按命令行给的 APK 列表提交会话。这意味着:如果你改了 APKS 里的某份 split,却没有重建 toc,用 bundletool 安装可能因为目录对不上而失败;用 adb install-multiple 反而能绕过 toc,但前提是你自己把该带的 split 都列全了。

XAPK 和 APKM 没有 toc,它们靠 manifest.json 或 info.json 描述内容。改完这类容器,元数据文件也要同步更新,否则安装器可能按旧清单去找已经不存在的 split。很多人只替换了 base,忘了改元数据,安装器仍然按旧清单装旧 split,表现就是“改了等于没改”。

最后说安装会话。adb install-multiple 不是简单地把几个 APK 拷进去,它会先创建一个 session,把 base 和 split 逐个写进会话,最后统一提交。系统在提交时做一致性校验:包名、版本号、签名、split 名称。任何一项不一致,会话回滚,设备上不会留下半个应用。手工调试时可以用 pm install-create、pm install-write、pm install-commit 分步走,但日常排查用 install-multiple 就够了。

细节出错时的表现检查方法处理
签名不一致安装会话失败、证书错误逐份 apksigner verify --print-certs全部用同一密钥重签
签名版本不齐新系统能装、老系统不能装看每份的 v1/v2/v3 结果统一签名参数
toc 过期bundletool 安装失败对比 toc 与 splits 列表重建 APKS 或改用 universal
元数据过期安装器装错 split看 manifest.json / info.json同步更新元数据
会话缺 splitINSTALL_FAILED_MISSING_SPLIT看安装命令的 APK 列表补齐 split 或合并
签名之后再改,等于白签
签名是对文件内容的校验。签完再改 ZIP 里的任何字节,签名都会失效;改完再签,顺序不能反。分包集里每一份都要遵守这个顺序,不要只对改过的那份重签就以为完事。

自家实例一:巡检助手的 APKS 换名换图标

第一个例子是自家的巡检助手。这个应用用 AAB 构建,内测时分发 APKS,里面有 base、arm64、armeabi-v7a、xxhdpi、zh 五份。二期试点要把桌面名称改成“巡检助手·二期”,图标换成新 logo,包名、版本号、启动页都不动。

以前的做法的第一条路是找开发重新出包:改 strings.xml 里的应用名,换 mipmap 里的图标,升 versionCode,重新构建 AAB,再用 bundletool 出 APKS,最后签名分发。流程本身没错,但排期要等开发,改一次图标也要走一遍完整构建。第二条路是拿 base 单独开刀:apktool 解码 base,改名称和图标,回编,签名,然后 adb install-multiple 把新 base 和旧 split 一起装。结果安装器报签名不一致,因为 base 换了新签名,split 还是旧签名。第三条路更省事:只装新 base。装是装上了,桌面图标却还是旧的,因为设备密度是 xxhdpi,读的是密度 split 里的图标。

现在的做法是先合并,再改。第一步,从开发那里拿到原始 AAB,或者拿到用 universal 模式生成的 APKS;用 bundletool 的 universal 模式出 universal.apk,确认它包含 base、arm64、armeabi-v7a、xxhdpi、zh 的全部内容。第二步,把 universal.apk 拖进安卓修改大师电脑版,等 aapt 读出包名、版本、启动页,确认这些信息和原包一致。第三步,在需求框里写清楚:只改应用名和图标,包名、版本号、启动页不动;图标用附件里的 1024×1024 PNG,按原有密度目录替换,保留自适应图标的前景和背景结构。第四步,在「设置签名」里选公司 JKS,打包,得到 signed.apk。

改完怎么验证?先用 aapt dump badging 看 application-label 和 application-icon,确认名称和新图标路径都在;再用 apksigner verify --print-certs 看证书指纹,确认和公司 JKS 一致;然后装到三台设备上:一台 arm64 高密度、一台 32 位中密度、一台模拟器。每台都看桌面名称、图标、启动页、关于页,最后用 adb shell dumpsys activity activities 看前台是不是巡检助手的主界面。因为签名换成了公司 JKS,覆盖安装旧包会被拒,所以车队里先通知备份本地巡检草稿,再卸载重装。

还有两个细节值得记录。第一,包体变大了:universal 把两套 ABI、多个密度和两套语言都装进来,体积比设备专用包大了一截,但内测群里的手机型号太杂,这个代价可以接受;如果只发车队里那批统一型号,就按设备 spec 出专用包,再合并成只含目标配置的 APK,体积能收回来。第二,pack.log 要看:回编、对齐、签名、校验四步都有记录,哪一步的退出码不对,日志里能直接看到;签名指纹也会打印出来,和公司 JKS 对一下就知道有没有签错。

回滚也要提前想好。签名换掉之后,旧包不能直接覆盖新包,新包也不能直接覆盖旧包;一旦试点发现问题,回滚意味着卸载再装旧包,本地数据会丢。巡检助手的做法是先把草稿数据做成可导出的文本,再发新包;试点群里只发一台设备先验证,确认登录、同步、拍照上传都正常,再扩大到整个车队。这个顺序比“一次全发、出问题再救”稳得多。

这个例子的教训很直接:分包的第一刀是合并,第二刀才是改。合并之后,base 和 split 已经是一个完整 APK,图标、语言、so 都在同一个包里,改哪份就是哪份,不会出现“改了 base、split 把它盖住”的情况。安卓修改大师电脑版的价值在这里不是替你决定 split,而是把合并后的完整包接住,用一句话完成改名换图标,再把回编、对齐、签名、校验跑完。

自家实例二:门店培训的语言 split 与 ABI split

第二个例子是自家的门店培训。这个应用有中文和英文两套文案,有 arm64 和 armeabi-v7a 两套 so,内测分发包是 APKS。区域团队要求把中文课程名“门店陈列基础”改成“门店陈列实战”,同时替换 assets/course.pdf 里的讲义;英文文案不动,包名和版本号不动。

以前的踩坑过程很有代表性。第一次只改了 base 的 values/strings.xml,把默认语言里的课程名改了,中文测试机上还是旧名字。原因是中文设备读的是语言 split 里的 values-zh,base 的默认值只是兜底。第二次改成解码语言 split,只改 values-zh,回编后只重签了这一份 split,结果安装时报签名不一致,因为 base 和 ABI split 还是旧签名。第三次把 base、语言 split、ABI split 全部重签,版本号又只升了 base,安装会话还是失败。一个课程名,来回折腾了三轮。

现在的做法是先把 APKS 合并成完整 APK,再进工具改。合并后的包里,默认资源、values-zh、两套 so 都在同一个 APK 里,不存在“改哪份、哪份覆盖”的问题。把完整包导入安卓修改大师电脑版,需求里写清楚三件事:默认语言和中文资源里的课程名都要改,英文资源保持原样;附件是新的讲义 PDF,路径按 assets/course.pdf 替换;包名、版本号、签名都不动。打包时用原来的公司 JKS,保证能覆盖升级。

验证分三层。第一层看资源:在中文设备上打开课程列表,确认课程名是新名字;把系统语言切到英文,确认英文文案没有被误改;再切回中文,确认中文资源还在。第二层看文件:打开讲义,确认是新 PDF,页数和封面正确;用 unzip -l 看 assets/course.pdf 的大小和原文件一致。第三层看 ABI:在 arm64 真机和 32 位模拟器上各装一次,启动应用,进入需要加载 so 的课程播放页,确认没有 UnsatisfiedLinkError。最后用 aapt dump badging 和 apksigner verify 复核包名、版本号和证书指纹。

还有一个容易漏的验证点:课程播放页只在加载 so 的时候才会暴露 ABI 问题,首页和列表页可能完全正常。所以不能只点首页,要走到真正调用 native 库的那一步。32 位模拟器上如果装的是只含 arm64 的包,安装阶段就会报 INSTALL_FAILED_NO_MATCHING_ABIS;如果包里有 32 位 so 但版本旧,安装能过,播放时才崩。两种失败要分开看,前者查包内 lib/,后者查 so 版本与业务日志。

版本号也要在这时确认。合并后的完整 APK 如果 versionCode 和旧包一样,覆盖安装可能被当成同版本重装,行为取决于设备和安装参数;如果低于旧包,直接触发降级保护。区域团队的要求是“能覆盖、数据不丢”,所以打包前把 versionCode 升一位,签名保持公司 JKS,装上去之后确认旧课程缓存还在、登录态还在,再开始改文案。

这个例子的教训是:语言 split 和 ABI split 不是“附属文件”,它们就是应用在当前设备上的实际内容。只改 base 的默认值,中文设备不一定读;只重签一份 split,安装器一定不认;只升 base 的版本号,安装会话一定失败。合并成完整 APK 之后,这些问题一次性消失,剩下的就是资源改得对不对、签名是否一致、设备是否覆盖。

合并之后先看身份、再看结构、再看资源,最后才装机
合并之后先看身份、再看结构、再看资源,最后才装机

合并后的验收:四看一装

合并完成不等于可以发。验收要按“四看一装”走:看身份、看结构、看资源、看安装,最后装上去跑一遍。顺序不要反,先把包的底子看清楚,再去设备上找感觉。

看身份,就是看包名、versionCode、签名。aapt dump badging 能读出 package、versionCode、versionName、application-label;apksigner verify --print-certs 能读出证书指纹。包名必须和原应用一致,否则不是升级而是另一个应用;versionCode 必须大于等于设备上的旧版本,否则覆盖安装会被拒;签名必须和旧包一致,否则只能卸载重装。

看结构,就是确认它真的是完整 APK,而不是“base 改了个名字”。用 unzip -l 看里面还有没有 split_config..apk、base-.apk 这类嵌套包;用 aapt dump xmltree 看清单里的 split 属性是不是空,android:isFeatureSplit 是不是不存在。完整 APK 的清单不应该再声明自己是某个 split,也不应该依赖外部 split 才能运行。

看资源,就是看图标密度、语言资源、native 库、assets。unzip -l 里应该有 res/mipmap-*、lib/arm64-v8a/、lib/armeabi-v7a/、assets/;如果目标设备是中文,确认 resources.arsc 里有 values-zh 的内容。图标至少检查 xxxhdpi 和 xxhdpi 两档,语言至少检查默认和中文两套,ABI 至少检查目标设备那一套。

看安装,就是真装。先在一台干净的设备上装,确认能装、能启动;再在装了旧版本的设备上覆盖装,确认版本号、签名、数据保留都符合预期;最后看 adb shell dumpsys activity activities 里的前台应用,确认不是“装上了但没打开”。如果打包时勾了「打包后自动运行」,电脑版会走 adb 装机、am start 拉起、dumpsys 复核这条链路,pack.log 里能看到每一步。

验收项命令或动作通过标准证据
身份aapt dump badging、apksigner verify --print-certs包名一致、版本不降、证书指纹正确命令输出截图
结构unzip -l、aapt dump xmltree无嵌套 split、清单 split 为空文件列表
资源看图标、切语言、看 so、开附件目标资源都在,且是新的设备截图
安装干净安装、覆盖安装都能装,数据符合预期安装结果
启动am start、dumpsys前台是目标应用,无闪退日志与截图

验收记录不要只留在聊天里。把 aapt dump badging 的关键行、apksigner verify 的证书指纹、三台设备的桌面截图、覆盖安装前后的版本号,整理成一条记录,和这一版的 signed.apk 放在一起。下一次有人问“这个包到底改了什么、能不能装”,你不用重新跑一遍命令,直接看记录。分包合并的验收尤其需要这个习惯,因为它的失败往往不是“功能不对”,而是“包的结构不对”,而结构问题在截图上通常看不出来。

verify 不是多余的一步
回编、对齐、签名三步只看退出码,签名到底有没有签上、证书是不是你以为的那张,要靠 apksigner verify --print-certs。分包合并后尤其要看,因为合并、重签、覆盖这几个动作最容易把证书换掉。

常见坑与排查顺序

分包相关的报错看起来多,归因其实就几类。第一类是签名不一致:INSTALL_FAILED_INVALID_APK、INSTALL_PARSE_FAILED_INCONSISTENT_CERTIFICATES、INSTALL_FAILED_UPDATE_INCOMPATIBLE 都可能出现,具体看系统版本和安装方式。先对 base 和每个 split 跑 apksigner verify --print-certs,证书指纹不一致就全部重签,不要只补其中一份。

第二类是版本号不一致:base 升了,split 没升;或者合并后 versionCode 比设备上的旧版本低。前者表现为安装会话失败,后者表现为 INSTALL_FAILED_VERSION_DOWNGRADE。前者把整组版本号对齐,后者把 versionCode 升上去;如果确实要降级覆盖,只能用允许降级的安装参数,并且清楚数据风险。

第三类是 split 缺失:INSTALL_FAILED_MISSING_SPLIT、INSTALL_FAILED_NO_MATCHING_ABIS、Resources$NotFoundException、UnsatisfiedLinkError。这类问题的共同点是“装进去的东西不全”。先看设备 ABI 和密度,再看安装的是不是完整包;如果是 split 集,确认该带的 split 都带了;如果是合并包,确认 lib/ 和 res/ 里确实有目标配置。

第四类是解析失败:aapt 读 APKS 报错、apktool 解码失败、项目建起来但没有包信息。这不是工具坏了,而是输入本来就不是单个 APK。先解压看结构,确认是 APKS、XAPK 还是 APKM,再决定是走 universal、合并工具还是手工合并。不要把“能建项目”当成“能改”,也不要在没有清单的工程里让 AI 硬改。

如果应用已经装上了,但一启动就闪退,先抓 adb logcat 里的第一条异常,不要从最后一行往上看。Resources$NotFoundException 通常指向缺失的资源 split 或错误的资源 ID;UnsatisfiedLinkError 指向缺失的 ABI 库;ClassNotFoundException 指向缺失的 feature split 或 dex。三条异常对应三种缺法,定位方向完全不同。抓到第一条之后,再去 unzip -l 里找对应的资源、so 或 dex,比盲猜快得多。

排查顺序建议固定下来:先看安装错误码,判断是签名、版本还是缺 split;再看签名指纹;再看 split 完整性;再看资源和 ABI;最后才看代码和业务逻辑。这个顺序能避免一上来就怀疑 AI 改错,结果查了半天发现是包根本没合并。

报错或现象最可能的原因先查什么处理
INSTALL_FAILED_UPDATE_INCOMPATIBLE签名和旧包不一致两边证书指纹用同一密钥重签,或卸载重装
INSTALL_FAILED_VERSION_DOWNGRADE新包 versionCode 更低aapt dump badging升 versionCode
INSTALL_FAILED_MISSING_SPLIT只装了 base安装命令与 split 列表装完整集或合并
INSTALL_FAILED_NO_MATCHING_ABIS缺少设备 ABI 的 so设备 abilist 与包内 lib补 ABI split 或换 universal
Resources$NotFoundException资源 split 缺失或被覆盖资源目录与语言配置合并后改,或补 split
UnsatisfiedLinkErrornative 库缺失包内 lib/ 目录补对应 ABI
aapt 读不出包名输入是集合包,不是单 APK文件头与解压结构先合并再导入
先怀疑包,再怀疑改
分包场景里,大多数“改了没生效”都不是 AI 没改,而是设备读的不是你改的那一份。先确认包的结构和安装形态,再去讨论改动内容,能省掉大量无效排查。

谁该合并,谁该保留 split

该合并的场景很明确:内测分发、侧载安装、白标交付、只改一个包就要发给一群人、没有继续走商店更新、需要用桌面工具做资源级修改。这些场景的共同点是“一个 APK 走天下”,合并后的包结构简单,安装、验证、分发都省心。

该保留 split 的场景也同样明确:继续通过商店更新、依赖动态功能模块、对安装体积敏感、需要按 ABI 或密度精细下发、团队有完整的 bundle 构建流水线。这些场景里,合并会破坏原有的分发结构,甚至让后续更新对不上。保留 split 不是保守,而是尊重原来的构建方式。

场景建议理由
内测群、车队、门店侧载合并成完整 APK设备杂,装得上比体积重要
白标交付、换名换图标合并后改资源只有一份,不会互相覆盖
商店持续更新保留 split,走 AAB维持原有下发与签名体系
动态功能模块保留 feature split合并后模块边界和按需下载会变
只改语言资源合并后改,或改对应语言 split避免只改默认值不生效

安卓修改大师电脑版的定位是“完整 APK 的改包与出包”:导入、反编译、AI 修改、回编、对齐、签名、校验、装机预览,一条链路围绕一个 signed.apk。它能把 APKS、XAPK、APKM 建进项目,但不会替你做 split 合并,也不产出 split 集。把它放在“合并之后”的位置,流程最顺;把它当成“分包合并器”,就会失望。

还要提醒一条版本线的事。合并包一旦发出去,它就是这个应用的“完整形态”;后续如果又发一个 split 集,或者反过来,设备上的安装形态就会打架。内测群、车队、门店最好固定一种形态:要么一直发完整 APK,要么一直发 split 集。混着发的结果是,用户装不上时你说“卸载重装”,用户重装后数据没了,问题就从技术问题变成了信任问题。版本号、签名、安装形态三件事,最好在第一次分发前就定下来,写进内测说明里。

收尾:把“一个文件”还原成“一个应用”

分包不是新概念,但它是改包路上最容易低估的一步。APKS、XAPK、APKM 只是外壳,真正决定应用行为的是 base 与 split 的分工:base 管身份和入口,ABI split 管指令集,密度 split 管图片,语言 split 管文案,feature split 管功能模块。只改 base,等于只改了骨架,外设还是旧的,设备就会用旧的外设把新骨架盖住。

合并的四条路里,有 AAB 就走 universal,没有 AAB 就用合并工具,结构简单才考虑手工 apktool,必须保留动态功能就维持 split 集。合并后按“四看一装”验收:看身份、看结构、看资源、看安装,最后装上去跑一遍。签名、版本号、包名这三件事,任何一个不一致,都会在安装器那一关被拦下。

安卓修改大师智改工坊把合并后的完整包接住,用一句中文需求完成改名、换图标、改文案、换启动页,再自动回编、对齐、签名、校验。官网 www.apkeditor.cn 上有产品介绍,具体入口是 https://www.apkeditor.cn/ai-version.aspx。只需说话,就能让应用变成你想要的样子,但请先确认你改的是自己的应用,或者已经拿到授权。

常见问题

问:APKS 能不能直接拖进电脑版改? 可以导入并建项目,但 aapt 解析的是单个 APK,集合包往往读不出包信息,界面会以文件名继续;反编译也可能不完整。能建项目不等于能改,稳妥做法是先合并成完整 APK 再导入。

问:universal 包为什么大这么多? 因为它把所有 ABI、所有密度、所有语言的资源都装进了一个 APK。设备专用包只带当前设备需要的那一份,当然小。内测设备杂就用 universal,设备统一就按设备 spec 出专用包。

问:合并后还能收到商店更新吗? 看你走哪条分发渠道。侧载的完整 APK 不在商店更新链路里;同包名、同签名、更高 versionCode 的商店包通常能覆盖,但完整 APK 与 split 安装形态不同,覆盖时可能被系统拒绝。内测分发要统一形态,别一半人装完整包、一半人装 split 集。

问:只改一个语言,能不能只改语言 split? 可以,但要满足三个条件:所有 split 用同一套签名重签、versionCode 保持一致、安装时把 base 和所有 split 一起提交。电脑版的打包链路产出单个 signed.apk,不产出 split 集,所以这条路要用命令行或其他流水线。

问:装了完整包还是闪退,先看哪里? 先看 adb logcat 第一条异常。资源缺失看 Resources$NotFoundException,so 缺失看 UnsatisfiedLinkError,类缺失看 ClassNotFoundException。然后回到包里找对应的 res/、lib/、classes*.dex,确认合并时有没有漏。

问:合并后桌面图标还是旧的怎么办? 先确认新图标进了正确的密度目录,再确认自适应图标的前景、背景和 roundIcon 都换了;最后卸载重装,排除启动器缓存。只在 base 里换一张图,密度 split 仍然可能把旧图顶上去。

问:XAPK 里的 OBB 要不要一起合并? OBB 是外置数据包,不属于 APK 的 split,合并工具通常不会把它塞进 APK。改完 APK 后要把 OBB 按原路径放回设备的 Android/obb/包名/,或者确认应用能自行下载;只装 APK 不装 OBB,应用可能启动后提示资源缺失。

用户评价

“以前改 APKS 只改 base,装到测试机上图标还是旧的,查了一下午才知道是密度 split 覆盖了。现在先合并再改,一次过。”
—— 老魏 · 企业安卓开发
“bundletool 的 universal 包体积大,但内测分发省心;电脑版拖进去一句话改完,比让开发重新出 AAB 快多了。”
—— 林工 · 移动端测试负责人
“语言 split 是最容易漏的。中文文案改在 base 里,中文设备根本不读,必须在合并后的 values-zh 里再改一遍。”
—— 阿珍 · 本地化运营
“签名不一致导致 install-multiple 失败,报错还不直观。现在打包前先用 verify 看一眼证书,省了很多来回。”
—— 小陈 · 安卓逆向爱好者
“我们车队设备杂,既有 arm64 也有 32 位。合并成 universal 虽然大一点,但不会出现装上了打不开。”
—— 周师傅 · 巡检项目负责人

合规提醒:本文的改包方法与实例仅用于自有版权或已获授权应用的学习、研究与企业内测,请勿用于破解他人付费应用、绕过安全机制或侵犯他人知识产权。分发前请确认签名、包名与内容变更均已获得相应授权。

安卓修改大师智改工坊 · https://www.apkeditor.cn/ai-version.aspx

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

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

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

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