安卓修改大师 · 智改工坊

包名不是想改就改：一份改包名前的评估与验证手册

联动清单 · 风险地图 · 三段式验证 · 源包与历史兜底

在智改工坊里改包名，操作上很简单：拖入安装包建项目，在需求里写一句"包名从 A 改成 B"，剩下的交给 AI。 难的是另外三个问题：该不该改、改了会不会坏、怎么证明没坏。包名是 Android 用来区分应用身份的根标识， 权限、组件、数据目录、三方登记都挂在它身上，动它等于换一次身份证。

一、包名牵动哪些东西：一张联动清单

包拖进智改工坊后，程序用工作目录里的 aapt 解析出图标、应用名、包名、版本号、SDK 版本与启动页，自动建项目、拷一份原始包（source.apk）并完成反编译。包名会出现在下面这些位置，改之前先过一遍。

最后一行最容易被忽略：包名不只是包内的技术标识，还是对外登记项——包外的登记要你自己同步，否则改完会收到一串"看着像网络问题"的报错。

二、什么情况下才该动包名

多数"改包名"的翻车不是技术没做到，而是一开始就不该改。先看值得动的，再看不该动的。

值得动：共同点是"要让新旧并存"

• 内测版与线上版同机共存。测试同事手机上已有线上版，数据不能互相污染、图标要分得清，换包名是最干净的隔离。
• 客户定制 / 白标交付：同一套自有产品按客户品牌交付多份，独立安装、独立升级。
• 自己产品线的多品牌并行，或拿自己的 demo 做多版本对比。

不该动：多数是"想歪了"

• 只想改桌面显示名——那是应用名（label）的事，改一行字符串就够。
• 只想换图标或启动图——用附件把图片连用途一起交给 AI，包名一动不动。
• 任何想绕过他人平台校验、绕过付费或安全机制的目的——这是红线，本工具面向自有版权或已获授权的应用，没有讨论空间。

一句话判断法：改包名是为了让它和"原来的自己"并存，还是为了让"别人认不出它"？前者通常是正当需求，后者基本是红线。

三、三处最容易翻车的地方

还有一个"看不见"的风险：smali 里硬编码的包名字符串。它不在清单和资源里，平时不发作，某条路径走到那行才以闪退暴露，而且往往发生在你验收之后——这正是第三段验证要"把手点一遍"的原因。

四、动手前：把需求写成一份可执行的清单

详情页中间的输入框就是 AI 的入口，点「立刻修改」后需求原文连同日期写进项目的 history.ini，正文送进右侧 AI 窗口执行。你写的那段话，就是这次改动的全部依据：写得含糊，AI 只能猜；写得清楚，改动才有边界。话术库里每条指令都把"要做什么 / 细节要求 / 参数参考 / 范围 / 验收"写全了，照这个骨架写包名需求：

联动清单长的时候别硬挤进这段话：点「选择附件」把清单 txt 一起丢进去，给每个文件写一句用途说明（不少于 10 个字），提交时会拼成「序号. 文件路径 —— 用途说明」跟着需求发出。注意需求原文会进历史、附件说明不进，范围与验收最好在正文里也写一遍。

五、改完必须验证：三段式验证法

AI 改完会在项目目录留一个标志文件，主窗口每 2 秒轮询，读到就自动弹打包窗口跑：回编、对齐、签名、校验。等打包的同时就能做第一段验证。

第一段 · 静态对账：还有没有旧包名

• 在项目的 apktool 目录里搜一次旧包名，重点看清单里还有没有残留；
• 专门确认 Provider authorities、自定义权限、自定义 action 三处是否已跟着改；
• 还有命中就判断是"该改没改"还是"本该保留"，拿不准就带着具体位置问 AI。

第二段 · 打包链路：这个包合不合格

产物在项目目录 build 下：unsigned.apk、aligned.apk、signed.apk，全过程写进 pack.log。前三步只看退出码，只有最后一步 verify 会明确告诉你"签名到底签上没有"——四步全打勾、verify 通过才算过关。跑完可「保存 APK」（默认名 应用名_版本号_signed.apk）或「打开所在文件夹」；打包时窗口不给关是有意为之，避免你以为它没在跑。

第三段 · 真机验证：装上去是不是活的

1. 装：勾上"打包后自动运行"，程序用 adb 找手机或模拟器，装完自动拉起；
2. 认身份：装完用 dumpsys 看一眼前台应用——改包名场景里这一步格外有用，你要确认的正是跑起来的到底是哪个包名；
3. 共存测试：把原包也装到同一台设备，两个都能装、都能开、互不覆盖；
4. 关键路径走查：登录、分享、拍照上传、跳转这些会碰 Provider 与权限的功能逐个点一遍；
5. 看屏幕与复测：连手机时用 scrcpy 投屏到电脑上点，模拟器会把窗口提到最前；条件允许时手机与模拟器各跑一遍。

设备侧的小状况都好处理：国内主流模拟器（雷电 / MuMu / 夜神等）装了但 adb 没连上会自动扫端口连上；模拟器装了没开，会搜出路径问你要不要帮开；手机没授权会提示你去点"允许 USB 调试"。拉起用 am start 而不是 monkey——新版安卓镜像已没有 monkey，且它失败时退出码还是 0，容易把失败当成功。

六、兜底：源包、历史与打包标记

• 原始包备份：建项目时自动拷一份 source.apk，改坏了随时有原包可依；
• 修改历史：需求原文完整保留不截断（history.ini 按 记录1、记录2 递增），点「选择」就填回输入框，改细节照上次那条再发一遍；
• 打包标记：每次出包前往 res/values/styles.xml 写入一条 info 样式，把出包时间、账号、机器码、程序版本、应用名与包名编码进去，几个包分不清来源时一眼回溯；
• 失败保护：反编译失败不影响项目本身——配置、图标、源包都已落地，修好环境重来即可（会提示原因并给日志路径 apktool.log）。

另外：项目列表读磁盘、带搜索，每条可编辑 / 看历史 / 删除（删除带防呆）；大师币不足时导入与编辑项目不受影响，只有「立刻修改」和「去打包」才会提示。12MB 的包反编译约 3 秒，全程在后台线程，界面不卡。

七、用户评价

以下摘录来自长期做打包与内测交付的使用者，已获授权、昵称做过脱敏处理。

八、合规提醒与一页上手清单

改包名真正要评估的从来不是"能不能改"，而是"改了以后哪些东西会跟着变"。把这份清单走一遍，绝大多数坑都能提前暴露：

1. 先说清目的：是不是为了让新旧并存？不是为了并存就别动；
2. 过一遍联动清单：清单属性、Provider authorities、自定义权限与 action、相对组件名、硬编码字符串、数据目录、包外登记；
3. 需求按五要素写全，长清单走附件（说明不少于 10 个字）；
4. 打包四步跑完并看 verify，再按"搜残留 → 装机 → dumpsys 认身份 → 共存 → 手点关键路径"走一遍；
5. 留好退路：source.apk 在项目里，需求原文在历史里，出包记录在打包标记里。

本文所述操作均针对自有版权或已获授权的应用；用户反馈已获授权并做脱敏处理。