Morphe Desktop 专家模式完整指南:5 屏流水线从选 APK 到出结果全覆盖

原创2026-10-30 19:15:581,327 阅读

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。

Morphe Desktop专家模式首页:选择要修补的APK

专家模式首页由两部分组成:

  • 顶栏:中间是 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 可实现可重复、可脚本化的修补

Morphe Desktop专家模式选择补丁源与版本发布列表

管理补丁源(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 最快的方式

Morphe Desktop专家模式补丁选择界面与CLI命令预览

点击带选项的补丁行可展开编辑器,例如 Clone app 的 Package name、Update permissions 等开关:

Morphe Desktop专家模式补丁选项编辑器界面

如果某个补丁提供 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 驱动。

Morphe Desktop专家模式修补进度页实时日志与性能监控

修补失败了怎么办?

失败时会显示 Patching failed,并给出 App info(应用包名、版本、补丁版本)和 Error log(含完整异常堆栈,可 Copy)。完整堆栈也保存在日志文件里,点 View full logs 查看——这正是提交 bug 报告时最需要附上的材料。

Morphe Desktop专家模式修补失败错误日志界面

⚠️ 失败最常见的原因是 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 Desktop专家模式结果页ADB安装与链接路由

🔒 签名提示: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。

相关路径与文档

按这 5 屏走完,你就掌握了 Morphe Desktop 专家模式的全部能力:从选 APK、定源定版、精调补丁参数,到实时监工修补和 ADB 一键装机——GUI 能做的,CLI 全都能做,Command Preview 就是你的双向翻译器。

登录后查看全文
morphe-desktop