Morphe Desktop 专家模式完整指南:5 屏流水线从选 APK 到出结果全覆盖
Morphe Desktop 专家模式完整指南:5 屏流水线从选 APK 到出结果全覆盖
Morphe Desktop 是一款开源的 Android APK 修补(Patching)工具,支持 CLI 与图形界面两种形态。它的 Expert mode(专家模式) 提供 5 屏流水线——Home → Patch source → Patch selection → Patching → Result——让你从拖入 APK 到产出签名好的补丁包,全程可视化控制:补丁源与版本、逐个补丁的开关与参数、Strip Libs 瘦身、签名配置,还能一键生成等价的 CLI 命令。
| 模式 | 适合人群 | 你能控制什么 |
|---|---|---|
| Quick(默认) | 新手、想快速出包 | 只管拖 APK,源和补丁集由 Morphe 自动挑选 |
| Expert | 进阶用户 | 补丁源与版本、单个补丁及其选项、原生库裁剪、签名、实时 CLI 命令预览 |
一分钟开启专家模式
首次启动默认是 Quick 模式。切换路径:Settings(齿轮图标)→ Advanced → Expert mode → 打开开关,Morphe 会自动记住你的选择。开关实现位于 AdvancedTab.kt。
专家模式首页由两部分组成:
- 顶栏:中间是 Sources 胶囊(已加载补丁版本 + N 个源,每个源一颗彩色 LED:🟢 最新稳定 / 🟡 旧稳定 / 🟣 最新实验 / 🩵 本地源,加载失败则变红);右侧是 设备指示器(ADB 安装目标)、Tools(扳手) 和 Settings(齿轮)。
- Supported apps 列表:当前补丁支持的目标应用,每个版本标签(Latest Stable / Latest Experimental)都是可点击的下载入口,帮你拿到"版本最匹配"的 APK——版本越匹配,能成功应用的补丁越多。第二个标签页 Your apps 则记录你修补过的所有应用历史。
第 1 屏:选择要修补的 APK
把 APK 直接拖进窗口即可(虚线区域显示 Drop APK here),也支持 Browse files 手动选择;.apkm / .xapk / .apks 这类 Split-APK 会自动合并为单个 APK。分析完成后会弹出信息卡,显示应用名、包名和版本号,点击 Continue 进入下一步。
💡 如果 APK 版本与补丁期望不符,按钮会变成 Continue anyway(等价于 CLI 的
--force):不兼容的补丁会被跳过,能应用的补丁不保证可用,其中"版本过新"风险最高。
首页逻辑见 HomeScreen.kt。
第 2 屏:选择补丁源与版本
进入 Select bundle version 页面,Morphe 会从你配置的源拉取可用发布,并打上标签:
- Latest:最新版本;Stable:稳定版;Dev:预发布(实验性);Cached:已下载缓存
- 点击 Patch notes 可展开阅读该版本的更新日志,再点 Download / Select 获取
- 手里已有本地
.mpp补丁文件?用 Local patch file → Browse 直接指向它 - Export JSON 会导出该补丁包的
options.json,配合 CLI 的--options-file可实现可重复、可脚本化的修补
管理补丁源(Source Manager)
在专家模式下点击顶栏的 Sources 胶囊可打开源管理器:添加(GitHub / GitLab 仓库或 morphe.software/add-source 链接)、移除、刷新、拖拽排序。顺序即加载优先级——若两个源包含同名类,靠前的源会胜出,建议把主源放在最上面。单个源加载失败时会标红并弹出横幅,其他源不受影响。页面入口在 PatchesScreen.kt。
第 3 屏:挑选补丁并微调选项
这是专家模式的核心页,顶部显示 "N of M selected" 实时计数:
- 补丁开关:逐个启用/禁用(对应 CLI 的
-e/-d) - 搜索框:过滤列表;多源时补丁按 bundle 分组
- 选项编辑器:带可配置选项的补丁会显示选项数,点开即可编辑;Patch defaults 表示未改动,Your defaults 表示你已自定义
- Strip-libs 摘要:显示本次保留哪些原生库架构(在 Settings → Strip Libs 修改)
- Continue patching even if a patch fails:某个补丁失败时跳过并继续,而不是中止整个流程
- Command Preview:生成你当前选择对应的精确 CLI 命令,可 Copy / Expand / Compact——这也是学 CLI 最快的方式
点击带选项的补丁行可展开编辑器,例如 Clone app 的 Package name、Update permissions 等开关:
如果某个补丁提供 custom icon 选项,还能直接打开 Icon Studio 可视化设计新的应用启动图标(前景层 + 背景层,实时预览自适应 / 单色 / 通知栏三种形态),保存后自动写入补丁选项。选择页逻辑见 PatchSelectionScreen.kt。
第 4 屏:实时观看修补进度
点击 Patch (N) 后进入修补页:
- 实时日志流 + patched/total 计数器(如 10/74),内容与 CLI 打印完全一致
- CPU / I/O / 内存监控图:直观看到重度修补时的系统负载
- Copy all 一键复制完整日志;Log file → Reveal / View 查看磁盘上保存的日志(
morphe-data/logs/,也可通过 Tools → Open Logs 打开) - Cancel 可随时中止
修补执行本身由 PatchCommand.kt 驱动。
修补失败了怎么办?
失败时会显示 Patching failed,并给出 App info(应用包名、版本、补丁版本)和 Error log(含完整异常堆栈,可 Copy)。完整堆栈也保存在日志文件里,点 View full logs 查看——这正是提交 bug 报告时最需要附上的材料。
⚠️ 失败最常见的原因是 APK 版本与补丁不匹配。优先对照 Supported apps 列表上的推荐版本号重新下载 APK。
第 5 屏:拿到修补好的 APK
成功后进入 Result 页,四个出口一次到位:
- Output file / Open folder →:修补完成的 APK 及文件管理器定位按钮(默认输出到输入 APK 所在目录,可在 Settings → Output folder 修改)
- ADB install:连接设备且开启 ADB 后可直接安装;选设备 → 等待 Ready → 安装,成功后显示 INSTALLED ON
- Link handling:把该应用支持的网页链接路由到修补版(可附加"同时禁止原版应用打开这些链接"),完全可逆;在 Settings 打开 Route links to patched app 可每次 ADB 安装后自动执行
- Patch another:重新开始修补新 APK;Temporary files → Clean up 清理本次临时文件(默认自动清理)
🔒 签名提示:Morphe 默认用数据目录里的共享
morphe.keystore签名,保证同一应用反复修补都能覆盖安装。如果提示 Keystore not found,到 Settings → Signing 点 Reset 恢复默认,或 Browse 指向你自己的 keystore(当前仅支持 BKS 格式)。
管理已修补应用:Your apps
修补记录会自动进入首页 Your apps 标签,每条记录支持:
| 操作 | 作用 |
|---|---|
| Install | 安装到已连接设备 |
| Update | 有新补丁/新版本时重新解析并修补 |
| Re-patch | 用已保存的配置再次修补同一应用 |
| Uninstall | 从设备移除(可勾选同时清除历史记录) |
| Forget | 仅删除历史记录,不动设备上的应用 |
常见问题速查
- 版本不匹配,Continue 变成 Continue anyway 了? 能继续,但按 Supported apps 的推荐版本下载 APK 成功率最高。
- 想给补丁包瘦身? Settings → Strip Libs 选择保留架构(手机一般保留
arm64-v8a),其余架构的原生库会被裁掉。注意:别裁掉你设备正在用的架构。 - 想在终端复现这次修补? 用第 3 屏的 Command Preview 复制命令即可,一条可重复的完整 CLI 指令。
- 想让补丁自动指向本地构建目录? 打开 Settings → Developer options,把本地源指向文件夹,Morphe 会自动加载其中最新的
.mpp。
相关路径与文档
- 完整官方文档(专家模式章节):docs/documentation.md
- 专家模式开关实现:AdvancedTab.kt
- 首页(选 APK):HomeScreen.kt
- 补丁源选择页:PatchesScreen.kt
- 补丁选择与命令预览:PatchSelectionScreen.kt
- 修补命令执行:PatchCommand.kt
按这 5 屏走完,你就掌握了 Morphe Desktop 专家模式的全部能力:从选 APK、定源定版、精调补丁参数,到实时监工修补和 ADB 一键装机——GUI 能做的,CLI 全都能做,Command Preview 就是你的双向翻译器。






