Skip to content
Back to search

monkeydev

SkillWorks with Claude CodeGitHub

使用 MonkeyDev 在 Apple Silicon Mac 上创建 Xcode MonkeyApp、MonkeyPod 插件库、越狱 Logos/CaptainHook Tweak 和 iOS 命令行工具,完成插件开发、签名打包、USB/SSH 安装,以及 LLDB 调试、OC 头文件导出、符号还原、Reveal/Lookin 视图检查和方法追踪。

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/alonemonkey--monkeydev/badge.svg)](/listings/alonemonkey--monkeydev)

HTML

<a href="/listings/alonemonkey--monkeydev"><img src="/api/listings/alonemonkey--monkeydev/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

需要完整 Xcode、原生 arm64 shell,以及当前用户的 `~/theos`。发行包已包含原生 monkeyparser 和 class-dump,正常安装无需自行编译这些工具。

先以普通用户安装 Theos,不要将其安装到 `/opt/theos`:

bash -c "$(curl -fsSL https://raw.githubusercontent.com/theos/theos/master/bin/install-theos)"

首次安装:

sudo /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/AloneMonkey/MonkeyDev/master/bin/md-install)"
/opt/MonkeyDev/bin/md-doctor

后续更新:

sudo /opt/MonkeyDev/bin/md-update

开发时,也可在 MonkeyDev 源码目录安装或更新本地版本:

sudo env MONKEYDEV_SOURCE_DIR="$PWD" /bin/bash bin/md-install
# 本地更新仍指定源码目录:
sudo env MONKEYDEV_SOURCE_DIR="$PWD" /bin/bash bin/md-update
/opt/MonkeyDev/bin/md-doctor

macOS 原有 `/bin/sh -c` 入口也已验证兼容。安装位置为 `/opt/MonkeyDev`,模板注册在当前用户的 Xcode 模板目录;安装、更新和卸载不修改 Xcode.app。安装器先准备并校验完整版本,再替换安装,生成版本回执和文件哈希。完整模板统一维护在 [MonkeyDev-Xcode-Templates](https://github.com/AloneMonkey/MonkeyDev-Xcode-Templates),安装时直接复制,不再应用模板补丁。

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

SKILL.md · Manifest · 368 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. ---
  2. name: monkeydev
  3. description: >-
  4. 使用 MonkeyDev 在 Apple Silicon Mac 上创建 Xcode MonkeyApp、MonkeyPod 插件库、越狱 Logos/CaptainHook Tweak 和 iOS 命令行工具,完成插件开发、签名打包、USB/SSH 安装,以及 LLDB 调试、OC 头文件导出、符号还原、Reveal/Lookin 视图检查和方法追踪。
  5. ---
  6. # MonkeyDev
  7. 使用 Xcode 完成已有 iOS App 的插件开发、重签名、真机安装与调试。工作流为:安装 MonkeyDev → 创建 MonkeyApp → 放入目标 IPA/App → 编写 dylib → Xcode Build/Run。优先使用已有工程;用户要求新建时再创建工程。不要将此流程替换成独立重打包脚本。
  8. 先区分任务:非越狱重签名使用 MonkeyApp;越狱设备向已安装 App 注入插件使用 Logos Tweak 或 CaptainHook Tweak;在设备 SSH 中运行程序使用 Command-line Tool。后两种流程见第 9 节,不需要把 App 放进 TargetApp,也不使用开发团队的 provisioning profile 安装 deb。
  9. 仓库:<https://github.com/AloneMonkey/MonkeyDev>。本文件可单独作为操作入口,无需先读取完整仓库文档。从分支或特定提交读取本文件时,使用同一版本的安装脚本和源码,避免新说明搭配旧模板。
  10. ## 1. 检查前提
  11. - Apple Silicon Mac,使用原生 arm64 终端;完整 Xcode 已安装并完成首次启动配置。
  12. - MonkeyApp:iPhone 开启开发者模式、信任此 Mac,并在安装启动时保持解锁。准备可用的开发团队、签名证书及授权该设备的 provisioning profile;Personal Team 的实际限制由 Xcode/Apple 决定。
  13. - MonkeyApp 输入为已砸壳的 IPA 或未加密 `.app`,主程序及保留的嵌入代码应符合 thin arm64 范围。MonkeyDev 不负责在非越狱设备上自动砸壳。
  14. - 当前支持基线为 iOS 15+、arm64 真机。MonkeyApp 不覆盖 Intel 主机、模拟器、Fat 输入、arm64e/PAC 或加密输入;设备 CPU 为 arm64e 不妨碍运行 arm64 App。越狱三个模板的 rootless arm64 已真机验证,rootful 仅完成构建与打包检查。Logos Tweak、CaptainHook Tweak 的 roothide arm64 已在 iPhone X / iOS 16.7.16 / Dopamine-roothide 2.4.9.27 + ElleKit 验证安装与 Hook 弹窗,Command-line Tool 的 C 示例已验证自动安装及 SSH 执行;不据此声明 Bootstrap 或系统进程兼容。
  15. 先检查:
  16. ```bash
  17. uname -m
  18. xcode-select -p
  19. xcodebuild -version
  20. xcrun --sdk iphoneos --show-sdk-path
  21. ```
  22. `uname -m` 应为 `arm64`。若选中的是 CommandLineTools 而非完整 Xcode,选择实际的 Xcode Developer 目录;默认位置可用:
  23. ```bash
  24. sudo xcode-select -s /Applications/Xcode.app/Contents/Developer
  25. ```
  26. ## 2. 安装与更新
  27. ### 安装 Theos
  28. Logos 预处理使用普通用户的 `~/theos`。已有该目录时先确认 `~/theos/bin/logos.pl` 可执行,不覆盖用户现有安装。不使用 `/opt/theos`。
  29. 没有安装时,以普通用户执行,不加 sudo:
  30. ```bash
  31. bash -c "$(curl -fsSL https://raw.githubusercontent.com/theos/theos/master/bin/install-theos)"
  32. ```
  33. ### 安装 MonkeyDev
  34. 使用已发布到 master、与本说明匹配的版本时:
  35. ```bash
  36. sudo /bin/sh -c "$(curl -fsSL https://raw.githubusercontent.com/AloneMonkey/MonkeyDev/master/bin/md-install)"
  37. /opt/MonkeyDev/bin/md-doctor
  38. ```
  39. 默认安装到 `/opt/MonkeyDev`,模板注册在当前用户的 `~/Library/Developer/Xcode/Templates/MonkeyDev`。完整模板来自 `MonkeyDev-Xcode-Templates` 仓库,安装器直接校验并安装,不再打补丁;需要测试本地模板修改时,通过 `MONKEYDEV_TEMPLATES_DIR` 显式指定其目录。安装器不修改 Xcode.app。正常安装已包含原生 monkeyparser 和 class-dump,无需额外编译 Capstone/Keystone 或安装 CMake。
  40. 安装器固定模板提交,不会因为更新本地 MonkeyDev 源码就自动使用本地模板。需要同时验证两仓库的未发布改动时,在下面安装或更新命令的 `env` 参数中另加 `MONKEYDEV_TEMPLATES_DIR="本地模板仓库的绝对路径"`。发布时先提交模板,再将安装器的默认模板 ref 更新为该提交;没有发布新模板前,不把远程 master 安装视为本地版本的验证。
  41. **本地开发版或未发布改动:** 不执行上面的远程 master 安装命令代替本地安装。在包含这些改动的 MonkeyDev 源码根目录执行:
  42. ```bash
  43. sudo env MONKEYDEV_SOURCE_DIR="$PWD" /bin/bash bin/md-install
  44. /opt/MonkeyDev/bin/md-doctor
  45. ```
  46. 远程更新与本地源码更新分别使用:
  47. ```bash
  48. # 更新已发布版本:
  49. sudo /opt/MonkeyDev/bin/md-update
  50. # 更新当前本地源码版本,在其源码根目录执行:
  51. sudo env MONKEYDEV_SOURCE_DIR="$PWD" /bin/bash bin/md-update
  52. ```
  53. 安装后保存工作并重启 Xcode 刷新模板缓存。更新模板只影响新建工程,不会自动迁移已有工程。若版本中没有 `md-doctor` 或缺少下文选项,先确认是否装到了旧版,不据此修改 Xcode 私有文件。
  54. 管理员密码只在终端或 macOS 授权窗口输入,不在聊天中索取。若管理员进程被 macOS 隐私限制阻止读取 Documents 中的源码,可从可读取的临时发行副本运行相同安装器;安装锁或失败恢复目录存在时,先确认没有安装进程并检查恢复信息,不直接删除旧安装。
  55. ## 3. 创建与运行工程
  56. 1. Xcode → File → New → Project,选择 **MonkeyDev → MonkeyApp**。
  57. 2. 填写 Product Name、Team、Organization Identifier。使用用户实际的签名团队;不要照搬其他工程的 Team ID、Bundle ID 或设备 UDID。
  58. 3. `Target App` 保持 `Optional`。这个文本框是历史越狱 dump 入口,不是 IPA 文件路径选择器。
  59. 4. 创建工程后,将一个已砸壳 IPA 或未加密 `.app` 放到 `<App target 目录>/TargetApp/`。保持只有一份明确输入,避免脚本选到其他旧 App。没有输入时使用内置 Demo,可先验证基础环境。
  60. 5. App target → Signing & Capabilities,选择团队,确认项目 Bundle ID 可由该团队签名。
  61. 6. 选择连接的 iPhone,用 Debug 执行 Run。无需配置 `MONKEYDEV_INPUT_APP`,沿用 TargetApp 文件夹输入方式即可。
  62. 直接在 Xcode 修改 `<App target 目录>/Info.plist`,可配置应用名称、权限说明和 URL Schemes。更换 IPA 后会保留这些修改,原始 IPA/App 不会被修改。
  63. 构建会自动保存配置记录和最近一次 Info.plist 备份,无需额外配置。
  64. 向导提供以下下拉项;创建后在 **App target → Build Settings → User-Defined** 修改,别改错到 Dylib target:
  65. | 向导项 | Build Setting | 默认 | 用途 |
  66. | --- | --- | --- | --- |
  67. | Inject Dylib | `MONKEYDEV_INSERT_DYLIB` | YES | 注入本工程 dylib |
  68. | Keep Original Bundle ID | `MONKEYDEV_DEFAULT_BUNDLEID` | NO | YES 时保留输入 App 的 Bundle ID |
  69. | Restore OC Symbols | `MONKEYDEV_RESTORE_SYMBOL` | NO | 还原 OC 方法符号以便符号断点与调用栈分析 |
  70. | Export OC Headers | `MONKEYDEV_CLASS_DUMP` | NO | 导出主程序 OC 头文件 |
  71. | UI Inspector (Debug) | `MONKEYDEV_UI_INSPECTOR` | None | 可选 None / Reveal / Lookin,仅 Debug 接入 |
  72. 通常保持 Keep Original Bundle ID 为 NO,使用新工程的标识。YES 不会绕过签名授权;profile 必须允许原 ID,第三方原始 ID 常无法由当前团队注册。若用户明确要求保留,应说明实际签名限制,不自行换掉该 ID。
  73. `MONKEYDEV_MINIMAL=YES` 保留默认值;不要为普通 Hook 打开旧 Substrate/Cycript 依赖。构建会在副本上移除 PlugIns、Watch 和旧 Store 元数据,当前不支持这些扩展的独立签名与安装。保留原始 IPA/App,不直接修改输入包。
  74. ## 4. 编写插件
  75. 工程通常包含两个同时编译的入口:
  76. ```text
  77. <项目名>Dylib/
  78. <项目名>Dylib.m 普通 Objective-C / CaptainHook
  79. Logos/
  80. <项目名>Dylib.xm Logos 源文件,修改这里
  81. <项目名>Dylib.mm 预处理生成文件,不手改
  82. ```
  83. 普通 `.m` 与 Logos 生成的 `.mm` 都能生效。先阅读现有 Hook 再修改,避免重复注册或两处同时展示相同弹窗。模板默认只打印示例日志。
  84. ### Logos 示例
  85. 在 `.xm` 中修改现有对应 Hook;下面是完整示例,不要重复追加同一段:
  86. ```objc
  87. %config(generator=internal);
  88. #import <UIKit/UIKit.h>
  89. %hook UIViewController
  90. - (void)viewDidAppear:(BOOL)animated {
  91. %orig(animated);
  92. static BOOL logged = NO;
  93. if (!logged) {
  94. logged = YES;
  95. NSLog(@"[MonkeyDev] Hook executed: %@", NSStringFromClass(self.class));
  96. }
  97. }
  98. %end
  99. %ctor {
  100. NSLog(@"[MonkeyDev] dylib loaded");
  101. %init;
  102. }
  103. ```
  104. 替换成目标 App 的实际类、selector 与准确方法签名,保留适当的原方法调用。构建时由 `~/theos/bin/logos.pl` 生成 `.mm`。internal 后端支持 OC 方法 Hook、`%orig`、`%ctor`,不支持 `%hookf`。
  105. 普通 `.m` 已提供 CaptainHook 示例,使用内部 Objective-C runtime 后端,不依赖 Substrate。保持 `CHUseSubstrate` 未定义,定义为 0 也可能命中 `#ifdef`。fishhook 用于导入符号重绑定,不是任意函数入口 Hook。
  106. 若任务是启动后弹窗,等待前台窗口和可展示的控制器就绪,再在主线程展示 `UIAlertController`,只展示一次;不要在 dylib constructor 中直接弹窗。测试代码放在当前用户工程,不把业务类或测试弹窗写进通用模板。
  107. ## 5. LLDB、符号和头文件
  108. ### 源码断点与符号断点
  109. 用 Debug 从 Xcode 启动。普通 `.m` 在实际语句上设断点;Logos 在 `.xm` 的实际语句上设断点,生成代码通过 `#line` 映射回源文件。若 `.xm` 无法点击行号设断点,核对其 Xcode File Type 为 Objective-C++,并保持它不作为额外编译源文件;实际编译的是生成 `.mm`。
  110. 要分析原 App 的 OC 方法,开启 `MONKEYDEV_RESTORE_SYMBOL=YES` 后重新构建。在 Xcode LLDB 控制台逐条执行:
  111. ```lldb
  112. image lookup -n '-[YourClass yourMethod:]'
  113. breakpoint set -n '-[YourClass yourMethod:]'
  114. ```
  115. 把示例换成真实完整符号,保留 selector 的全部冒号。也可在断点导航器按 ⌘8,点击 + → Symbolic Breakpoint,将方法符号填入 Symbol。
  116. 先确认符号能查到、断点有解析位置,再操作 App 触发相应路径。已解析却未命中可能只是调用了另一个重载或实现,不能直接判断符号还原失败。MonkeyApp 中,monkeyparser 负责 dylib 加载命令注入与独立的 OC 方法符号还原,系统 codesign 负责最终签名;越狱 deb 使用 ldid 签名,由设备 tweak 加载器加载,不经 monkeyparser 注入。
  117. ### Debug 查询辅助函数
  118. 优先使用带 `md_` 前缀的入口,避免与系统符号重名。UI 查询前选中主线程,在 LLDB 逐条执行:
  119. ```lldb
  120. expr -l objc++ -O -- (id)md_pvc()
  121. expr -l objc++ -O -- (id)md_pviews()
  122. expr -l objc++ -O -- (id)md_methods("YourClass")
  123. ```
  124. `md_pvc` 列控制器树,`md_pviews` 列视图树,`md_methods` 列 OC runtime 方法。`md_ivars((uintptr_t)地址)` 查询成员元数据,`md_pactions((uintptr_t)地址)` 查询 UIControl 的 target/action;地址必须是当前进程有效的存活对象。UI 查询不会自动调度到主线程。辅助函数只在 Debug 可用,不提供旧版堆扫描功能。
  125. ### 导出头文件
  126. 开启 `MONKEYDEV_CLASS_DUMP=YES` 后构建,头文件位于:
  127. ```text
  128. <工程目录>/Headers/<App target 名>/
  129. ```
  130. 使用构建日志打印的路径。导出由独立 class-dump 完成,不需要另外执行 monkeyparser 的隐式导出。生成目录加入工程 `.gitignore`,不要加入 App target。输出供分析参考,不保证能当作完整 SDK 编译,也不还原纯 Swift 源码;无法解析的元数据可能产生警告或被跳过。
  131. ## 6. Reveal / Lookin
  132. 1. 用户在 Reveal 桌面应用中下载 Server SDK,默认位置为:
  133. ```text
  134. ~/Library/Application Support/Reveal/RevealServer/RevealServer.xcframework
  135. ```
  136. 2. 设置 App target 的 `MONKEYDEV_UI_INSPECTOR=Reveal`,用 Debug 重新构建并运行。自定义 SDK 路径使用 `MONKEYDEV_REVEAL_SDK`,值是 `.xcframework` 的完整路径。
  137. 3. 允许 App 的本地网络访问,在 Reveal 选择该运行中的 App。USB 连接已验证;检查层级和 Refresh 时保持 App 运行,不能停在断点上。
  138. 框架从用户本机 SDK 复制到构建副本,MonkeyDev 不捆绑新版 SDK。只在名为 Debug 的 iPhoneOS 配置接入,Release 忽略开关;开启但缺少 SDK 时构建会失败。
  139. 若看不到 App,依次检查构建产物:`Frameworks/RevealServer.framework/RevealServer` 存在、主程序包含对应加载命令、最终 Info.plist 的 NSBonjourServices 包含 `_reveal._tcp`、本地网络权限已允许、签名和设备连接正常。若连接超时,先确认未暂停调试器,再重试 USB 连接。列表中出现 App 只说明发现成功,还需能读取完整层级并刷新。
  140. ### Lookin
  141. 选择 `MONKEYDEV_UI_INSPECTOR=Lookin`,只在 Debug iPhoneOS 构建中复制、注入并签名内置的 LookinServer 1.2.8,不依赖项目 dylib 的 Inject Dylib 开关。默认读取 `$(MonkeyDevPath)/Librarys/Lookin/LookinServer.framework`,自定义动态 framework 路径用 `MONKEYDEV_LOOKIN_SDK`。不接受静态库或模拟器 framework,不使用低于 1.0.6 的版本。
  142. 用户只需安装 Lookin 桌面客户端,不需要另行准备 Server。项目构建不下载或编译 Server 源码,也不修改 Xcode.app 或 Lookin.app。上游许可证、完整对应源码归档、固定版本与构建说明随 SDK 保留在 `Librarys/Lookin/`。
  143. 运行 App 后通过 USB 在 Lookin 客户端连接并读取、刷新视图层级;不需要为 Lookin 添加 Reveal 的 Bonjour 配置。测试时确认主程序的 LookinServer 加载命令、framework 签名以及实际层级读取,不能只以列表可见判断通过。SDK 保留上游许可证和固定源码来源。
  144. `None` 不注入视图检查工具,Release 忽略选项。未设置新选项的既有工程继续兼容 `MONKEYDEV_REVEAL=YES`;设置了新选项时以新选项为准,不同时自动注入 Reveal 和 Lookin。不覆盖输入 App 自带的同名 framework;启用时若冲突,应先关闭该选项或由用户处理输入依赖。
  145. ## 7. 方法追踪 Trace
  146. Debug 下在类已加载后、启动阶段或调试器暂停时注册指定方法。在 LLDB 逐条执行:
  147. ```lldb
  148. expr -l objc++ -O -- (id)md_trace_start("YourClass", "yourMethod:", (BOOL)0)
  149. expr -l objc++ -O -- (id)md_trace_status()
  150. expr -l objc++ -- (void)md_trace_set_descriptions((BOOL)0)
  151. expr -l objc++ -- (void)md_trace_stop()
  152. ```
  153. 将示例类和方法换为真实目标。第三个参数 0 为实例方法,1 为类方法。也可在源码导入 `Trace/MDMethodTrace.h`,于 `#if DEBUG` 内调用相同函数。正式模板不会自动注册方法。
  154. 注册前确认方法签名符合范围:
  155. - 返回值:void、对象、BOOL/bool、signed char、32/64 位有符号或无符号整数、float、double。
  156. - 参数:无显式参数;一个上述标量或对象;或者两个对象参数。
  157. - 不使用结构体、union、任意指针、SEL、Class、其他混合/更多参数、可变参数及特殊 ARC 所有权方法;不追踪 init/new/copy/alloc 等所有权方法族或 runtime 生命周期管理方法。
  158. 日志包含 before、args、return、after/after-throw。按 `call` 与 `thread` 配对;`depth` 只表示同一线程中被追踪的同步嵌套,独立和异步调用通常为 0。耗时是原方法同步耗时,仍包含嵌套追踪及调试暂停的影响,不是完整网络请求耗时。
  159. 对象 description 会执行应用代码;有副作用或开销疑虑时用 `md_trace_set_descriptions(NO)` 关闭,YES 恢复。每个方法最多采样 100 次,最多注册 128 个方法、深度 32。stop 关闭日志但不卸载包装,再次 start 不重置预算;需要重新采样时重启进程。
  160. ## 8. 故障处理与验收
  161. | 现象 | 优先检查与处理 |
  162. | --- | --- |
  163. | 模板或向导选项没更新 | 重启 Xcode,确认用户模板链接指向当前 `/opt/MonkeyDev/templates`;已有工程不会自动迁移 |
  164. | Logos 找不到或不生成代码 | 检查当前用户 `~/theos/bin/logos.pl` 和 include 路径;编辑 `.xm`,不要只改 `.mm` |
  165. | 原 Bundle ID 无法签名 | 查看当前团队/profile 是否授权该 ID;设备 UDID 授权与 App ID 授权是不同问题 |
  166. | 手机无法启动或安装中断 | 检查解锁、信任、开发者模式、描述文件和 Xcode 的具体错误;不要反复安装或删除 App 数据 |
  167. | 第二次安装失败或符号/库残留 | 先 Clean Build Folder,再连续两次构建运行;检查当前安装脚本版本及完整签名,而非只看编译成功 |
  168. | 修改源码后运行行为没变 | 区分仓库、`/opt/MonkeyDev` 和工程中的源码;同步安装不等于自动更新已有 dylib 源文件 |
  169. 从没有 pack-files 清单的旧版本升级后,先执行一次 **Product → Clean Build Folder**。保留打包与最终签名两个脚本阶段每次执行;不要通过添加输出文件让 Xcode 跳过它们。不要手动更改 Xcode.app 的私有规格文件,也不要自行拼造签名 entitlements。
  170. 用户要求验证时,记录实际工程、构建配置和开关,完成构建、完整签名检查、安装、启动及用户要求的功能检查。修改打包或签名流程后,再不改源码连续运行一次以覆盖增量构建。只修改文档则不重复真机安装。已有测试记录不能代替本次执行结果;Build Succeeded、进程启动或 Reveal 列表可见,也不能单独证明所有功能通过。
  171. 只读取用户当前请求需要的内容,不把 IPA、导出头文件、测试工程、证书或 profile 放进 MonkeyDev 仓库。默认保留用户输入和 App 数据;提交、推送及设备操作不由读取本 skill 自动授权。
  172. ## 9. 越狱 Tweak 与命令行工具
  173. ### 创建与构建
  174. 使用 **MonkeyDev → Logos Tweak / CaptainHook Tweak / Command-line Tool** 正式模板,不另建测试模板分类。默认 arm64、rootless、USB 连接。手机需有可用的 SSH 服务;tweak 还需兼容 MobileSubstrate 接口的加载环境,例如 ElleKit。Sileo 是包管理器,不是 Hook 框架。
  175. 主机依赖:
  176. ```bash
  177. brew install ldid libusbmuxd libimobiledevice
  178. # 仅密码认证需要:
  179. brew install sshpass
  180. ```
  181. Logos Tweak 另需当前普通用户的 `~/theos/bin/logos.pl` 和 Theos 对应的头文件、链接库。CaptainHook 默认使用内部 Objective-C Runtime 后端,不定义 `CHUseSubstrate`,不添加 `-lsubstrate`;纯 C/C++ 命令行工具不依赖 Theos。
  182. Logos Tweak、CaptainHook Tweak、Command-line Tool 创建向导提供 **Package Scheme**:`rootless`(默认)、`rootful`、`roothide`,自动联动链接与打包配置。
  183. 三个模板的认证方式相同:
  184. | SSH Authentication | Build 行为 | 账号密码 |
  185. | --- | --- | --- |
  186. | `None` | 只生成 deb,不连接或安装 | 置灰 |
  187. | `KEY`(默认) | SSH 免密登录并自动安装 | 置灰,继承已有 SSH 配置 |
  188. | `PASSWORD` | 使用密码登录并自动安装 | 启用,默认账号 `mobile`,密码必填 |
  189. 密码输入为普通文本,会写入生成工程;`NotPersisted` 只是不记住到下一次创建,不能视为安全存储。不要将含密码的工程配置提交或分享,已有密码优先留在不提交的本地 xcconfig 或密码文件中。构建阶段不打印环境变量。
  190. USB 默认通过 inetcat 直连设备 SSH 端口 22,不启动 iproxy,不需要本地 2222 转发。设备选择优先级:`MonkeyDevDeviceUDID` → Xcode 选择的有效设备标识 → `idevice_id -l` 检测到的唯一 USB 设备;多设备无法确定目标时停止并让用户选择。
  191. 免密模式默认匹配 `~/.ssh/config` 的 `monkeydev-usb` 别名,沿用其中的用户、IdentityFile 或 ssh-agent;不要照搬其他人的私钥路径或假设当前 Mac 用户名就是设备账号。首次连接先在终端核对主机身份,例如:
  192. ```bash
  193. # rootless / rootful
  194. ssh -o "ProxyCommand=inetcat -u <UDID> 22" -o "HostKeyAlias=monkeydev-usb-<UDID>" mobile@usb-iphone
  195. # roothide
  196. ssh -o "ProxyCommand=inetcat -u <UDID> 22" -o "HostKeyAlias=monkeydev-roothide-<UDID>" mobile@usb-iphone
  197. ```
  198. 把 `<UDID>` 和账号替换为实际值,使用已有密钥配置或 `-i`。USB 安装使用同一 HostKeyAlias;roothide 改用 `monkeydev-roothide-<UDID>`,避免与同一手机的旧环境记录冲突,不关闭主机密钥检查。SSH 免密与 sudo 免密独立;mobile 安装 deb 仍需已有 sudo 权限和所需密码,不为了通过测试擅自放宽 sudo 权限。
  199. ### 高级连接与布局
  200. 只有用户需要时才修改 target 的 Build Settings:
  201. | 设置 | 用途 |
  202. | --- | --- |
  203. | `MonkeyDevConnectionType` | 默认 `USB`;`IP` 直连局域网,`SSH` 继承 SSH 别名配置 |
  204. | `MonkeyDevDeviceIP` | 默认 `monkeydev-usb`;IP 模式填地址,SSH 模式填别名 |
  205. | `MonkeyDevDevicePort` | 默认设备端口 22;SSH 模式留空才会继承别名端口 |
  206. | `MonkeyDevDeviceUser` / `MonkeyDevDeviceKey` | 可显式指定设备账号、私钥;免密默认留空继承配置 |
  207. | `MonkeyDevDeviceUDID` | 可选,指定 USB 目标设备 |
  208. | `MonkeyDevDevicePasswordFile` | 本机一行密码文件,用于密码登录或免密登录后的 sudo;优先于 `MonkeyDevDevicePassword` |
  209. | `MonkeyDevDevicePassword` | 设备密码,可在本地 xcconfig 配置;KEY 模式下只供 sudo,不切换 SSH 登录方式 |
  210. | `MONKEYDEV_PACKAGE_SCHEME` | 越狱模板向导可选 `rootless`、`rootful`、`roothide`,默认 `rootless`;创建后仍可修改 |
  211. | `MonkeyDevkillProcessOnInstall` | 可选目标进程名,默认留空;不默认重启 SpringBoard |
  212. 私钥和密码文件支持 `~/` 或相对工程目录的路径。向导的 `KEY/PASSWORD` 将 `MonkeyDevInstallOnAnyBuild` 联动为 YES,`None` 为 NO,且脚本会阻止 None 安装;手动把该安装设置改为 NO 可关闭 KEY/PASSWORD 的每次 Build 安装。路径映射辅助字段自动联动,不要求用户手动修改。
  213. 打包在临时副本完成,deb 输出到 `<工程目录>/Packages/`。资源仍放在工程 `Package/Library/...` 或 `Package/usr/...`,不要手工再套 `var/jb`;rootless 自动添加 `/var/jb` 前缀,架构为 `iphoneos-arm64`,rootful 使用传统路径和 `iphoneos-arm` 包架构,两者二进制均为 arm64。
  214. Logos / CaptainHook 的 roothide 方案使用无 `/var/jb` 前缀的包布局、`iphoneos-arm64e` 包标识和 `.jbroot` 相对加载路径,当前仍编译 arm64 二进制。Logos 使用随 MonkeyDev 提供的 Hook 接口链接声明;CaptainHook 使用内部 Objective-C runtime 后端,无需链接 Substrate。两者均不打包 Substrate 运行库,也不替换用户的 Theos。Tweak 设备需安装 roothide 兼容的 ElleKit。
  215. 仅选择 `roothide` 时,三个越狱模板提供官方路径 SDK,可直接 `#include <roothide.h>`,无需手动配置搜索路径。未调用 SDK API 时,最终产物不保留 `libroothide` 依赖;调用后使用设备 `roothide` 包自带的运行库,不向 deb 捆绑运行库。
  216. 例如将资源放入 `Package/Library/MyTweak/config.plist`,在 roothide 中读取:
  217. ```objc
  218. #include <roothide.h>
  219. NSString *path = jbroot(@"/Library/MyTweak/config.plist");
  220. NSDictionary *config = [NSDictionary dictionaryWithContentsOfFile:path];
  221. ```
  222. SDK 提供 C、Objective-C、C++ 的 `jbroot()`、`rootfs()` 及 `jbrand()`。不要硬编码 `/var/jb` 或随机 `.jbroot-*` 路径;这些接口不会自动改写现有文件访问,也不会自动提升进程权限。rootless/rootful 不引入 SDK;同一份源码需用 `#if defined(THEOS_PACKAGE_SCHEME_ROOTHIDE)` 区分 SDK 调用和其他方案的路径处理。App 自身沙盒路径不应统一套 `jbroot()`。 roothide 的独立可执行程序默认受沙盒限制;使用 SDK 访问越狱资源时,需要按实际用途在工程 `monkeydev.entitlements` 配置权限,参见 [RootHide 官方权限说明](https://github.com/roothide/Developer/blob/main/entitlements.md)。模板仍保持空权限;不要为 dylib 额外申请或修改目标 App 的权限。
  223. ### 源码与验收
  224. - Logos Tweak:编辑 `<项目名>.xm`,编译生成的 `.mm`。默认通过 Theos 的 MobileSubstrate 接口链接,设备端可由 ElleKit 实现,不把旧 Substrate 库打入 deb;与 MonkeyApp 的 Logos internal 后端区分。
  225. - CaptainHook Tweak:编辑 `<项目名>.mm`,使用实际类和方法签名,在类已加载且存在时注册 Hook。模板只提供示例,不内置特定 App 的弹窗。
  226. - 两种 tweak 均需设置 `Package/Library/MobileSubstrate/DynamicLibraries/<项目名>.plist` 的 Filter/ Bundles 为目标 App 的 Bundle ID;默认占位 ID 不会命中用户 App。它们默认不带 LLDBTools、Trace 或 Reveal,不能假定 MonkeyApp 的辅助入口可用。
  227. - Command-line Tool:支持 C、C++、Foundation、Core Foundation;没有 Core Data/Core Services 类型。源码通常为 `main.c`、`main.cpp` 或 `main.m`。默认无额外 entitlements,需权限时按具体用途配置;不默认开启 `platform-application`。
  228. - 命令行工具安装到 rootless 的 `/var/jb/usr/bin/<项目名>` 或 rootful / roothide 的 `/usr/bin/<项目名>`(roothide 环境内的逻辑路径),通过设备 SSH 执行;不把 Xcode Run 当作设备安装启动入口。
  229. 验收时先用 None 验证编译与 deb 内容,再按用户选择的认证方式验证自动安装。tweak 重启目标 App 后检查实际 Hook 命中;要求弹窗时还需确认可见,不能用手工 dlopen 或调用弹窗函数代替。命令行工具需在设备执行并检查输出与退出码。SSH 不通先区分 USB 设备识别、主机身份、SSH 登录与 sudo 安装失败,不把所有错误归结为端口转发。
  230. ## 10. MonkeyPod 本地插件库
  231. 需要跨工程复用 CaptainHook 插件时使用 MonkeyPod,不把它当作独立 App 或 deb 模板。当前已验证 iOS 15+ arm64、本地动态 Pod、MonkeyApp 签名安装和真机 Hook;发布流程未验收。
  232. 1. 通过 Homebrew 安装 CocoaPods:`brew install cocoapods`,确认 `pod --version` 可执行,不使用 sudo 安装 Pod。
  233. 2. Xcode 选择 **MonkeyDev → MonkeyPod**,生成 Objective-C framework、公开头文件和同目录的 podspec。修改 `.m` 的实际类和实例方法;默认示例可在内置 Demo 上验证 `getMyName` 返回 `MonkeyDevPod`。保持 CaptainHook 内部后端,不定义 `CHUseSubstrate`。
  234. 3. 在 MonkeyApp 工程根目录创建 Podfile,将 Pod 接到 **Dylib target**,不是 App target。示例中替换实际名称和路径:
  235. ```ruby
  236. require '/opt/MonkeyDev/Tools/cocoapods-compat'
  237. platform :ios, '15.0'
  238. target 'YourAppDylib' do
  239. use_frameworks! :linkage => :dynamic
  240. pod 'YourPlugin', :path => '../YourPlugin/YourPlugin'
  241. end
  242. ```
  243. 4. `:path` 指向 podspec 所在目录。执行 `pod install` 后打开 `.xcworkspace`,选择 MonkeyApp 的 App scheme,通过正常 Build/Run 流程安装。动态 framework 的 constructor 随加载执行;不要随意改成静态 Pod,避免仅含 Hook 函数的对象文件被链接器丢弃。
  244. 5. 检查最终 App 的 `Frameworks/<Pod名>.framework`、Dylib 的链接依赖和完整签名,再检查真机实际 Hook。默认示例的 Demo 界面显示 `MonkeyDevPod`;不能只凭 pod install 或 framework 编译成功认定插件已生效。
  245. `cocoapods-compat.rb` 只在当前 Podfile 进程中适配已验证的 Xcode 27 字段:脚本数组转为字符串,framework 复制目的地转成等效表示,生成的 Pods 工程使用受支持格式。保留宿主工程版本,不修改 Xcode.app 或安装的 gem。旧解析器遇到其他 `dstSubfolder` 复制目录时会在保存工程前报错停止;不要移除检查强行安装。其他未知字段仍需评估,不能据此承诺所有第三方工程兼容。只更新 MonkeyPod 模板无需改 MonkeyApp 打包脚本,其已有流程会复制并签名 Pod framework。
  246. 默认 podspec 的源文件路径相对 podspec 目录,支持 `.h/.m/.mm`。作者、homepage、source、许可为待填写的发布元数据;本地 `:path` 不下载示例 URL,也不代表可以直接发布。不要把实际用户的仓库、私钥或账号固化进通用模板。
README.md · README · 205 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. # MonkeyDev
  2. > **使用 AI 安装或操作 MonkeyDev:请先读取 [SKILL.md](SKILL.md)**,按其中的安装、使用流程和注意事项执行。可以直接将该文件链接提供给 AI。
  3. MonkeyDev 基于 iOSOpenDev,为 Xcode 提供 MonkeyApp 模板,用于向已有 iOS App 注入 dylib、开发 Objective-C / Logos Hook,并使用 Xcode 重签名、安装和调试。
  4. 当前支持 **Apple Silicon Mac 和 iOS 15+ 非越狱 iPhoneOS arm64 真机**。已用内置 Demo 和未加密 App 验证构建、重复安装、Hook、符号断点、头文件导出及 Reveal。验证环境为 Xcode 27.0(27A266a)、iPhone 14 Pro / iOS 18.6.2。
  5. ## 安装
  6. 需要完整 Xcode、原生 arm64 shell,以及当前用户的 `~/theos`。发行包已包含原生 monkeyparser 和 class-dump,正常安装无需自行编译这些工具。
  7. 先以普通用户安装 Theos,不要将其安装到 `/opt/theos`:
  8. ```bash
  9. bash -c "$(curl -fsSL https://raw.githubusercontent.com/theos/theos/master/bin/install-theos)"
  10. ```
  11. 首次安装:
  12. ```bash
  13. sudo /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/AloneMonkey/MonkeyDev/master/bin/md-install)"
  14. /opt/MonkeyDev/bin/md-doctor
  15. ```
  16. 后续更新:
  17. ```bash
  18. sudo /opt/MonkeyDev/bin/md-update
  19. ```
  20. 开发时,也可在 MonkeyDev 源码目录安装或更新本地版本:
  21. ```bash
  22. sudo env MONKEYDEV_SOURCE_DIR="$PWD" /bin/bash bin/md-install
  23. # 本地更新仍指定源码目录:
  24. sudo env MONKEYDEV_SOURCE_DIR="$PWD" /bin/bash bin/md-update
  25. /opt/MonkeyDev/bin/md-doctor
  26. ```
  27. macOS 原有 `/bin/sh -c` 入口也已验证兼容。安装位置为 `/opt/MonkeyDev`,模板注册在当前用户的 Xcode 模板目录;安装、更新和卸载不修改 Xcode.app。安装器先准备并校验完整版本,再替换安装,生成版本回执和文件哈希。完整模板统一维护在 [MonkeyDev-Xcode-Templates](https://github.com/AloneMonkey/MonkeyDev-Xcode-Templates),安装时直接复制,不再应用模板补丁。
  28. ## 创建并运行 MonkeyApp
  29. 1. 安装后保存工作并重启 Xcode,通过 **File → New → Project → MonkeyDev → MonkeyApp** 新建工程。
  30. 2. 填写项目名称、开发团队和 Organization Identifier。`Target App` 保持 `Optional`。
  31. 3. 将一个已砸壳的 IPA 或未加密 `.app` 放入 `<App target>/TargetApp/`,保持只有一份目标输入。不放输入时使用内置 Demo;无需设置 `MONKEYDEV_INPUT_APP`。
  32. 4. 选择 iPhone,以 Debug Build/Run。签名需要当前团队可用的证书、匹配的描述文件及设备授权。
  33. `Target App` 文本框是历史越狱 Frida/SSH dump 入口,不是 IPA 路径选择器;该入口未纳入当前验证范围。使用上述 TargetApp 文件夹放入未加密输入,MonkeyDev 不负责在非越狱设备上自动砸壳。
  34. 创建向导提供以下下拉选项;创建后仍可在 **App target → Build Settings → User-Defined** 修改:
  35. | 选项 | Build Setting | 默认 |
  36. | --- | --- | --- |
  37. | Inject Dylib | `MONKEYDEV_INSERT_DYLIB` | YES |
  38. | Keep Original Bundle ID | `MONKEYDEV_DEFAULT_BUNDLEID` | NO |
  39. | Restore OC Symbols | `MONKEYDEV_RESTORE_SYMBOL` | NO |
  40. | Export OC Headers | `MONKEYDEV_CLASS_DUMP` | NO |
  41. | UI Inspector (Debug) | `MONKEYDEV_UI_INSPECTOR` | None(可选 Reveal / Lookin) |
  42. 默认使用项目 Bundle ID。保留原 Bundle ID 仍需要描述文件授权该 ID,开关不会绕过签名权限。最小运行时固定开启,不捆绑旧 Substrate/Cycript。
  43. ## 编写 Hook 与调试
  44. - `<项目名>Dylib/<项目名>Dylib.m`:普通 Objective-C / CaptainHook 示例,使用内部 runtime 后端。
  45. - `<项目名>Dylib/Logos/<项目名>Dylib.xm`:Logos 示例,采用 internal 后端;生成的 `.mm` 同时参与编译,编辑源文件 `.xm`,不要手改 `.mm`。
  46. - 两个入口可以同时执行。正式模板只打印示例日志,不自动弹窗;Trace 不自动注册业务方法。
  47. 源码断点直接设在 dylib 的实际语句上。分析输入 App 的 OC 方法时,可开启符号还原,重新构建后在 LLDB 设置符号断点:
  48. ```lldb
  49. breakpoint set -n '-[YourClass yourMethod:]'
  50. ```
  51. 将类名和 selector 换成目标 App 的实际方法。基础 UI/runtime 查询位于 `Tools/LLDBTools.h/.mm`,方法追踪位于 `Trace/MDMethodTrace.h/.mm`,均仅 Debug 可用。Trace 输出调用编号、线程号、嵌套深度、参数、返回值及同步方法耗时;它只支持明确的签名子集,不是任意 ABI 的通用 Hook。
  52. ## 头文件与视图检查
  53. 开启 **Export OC Headers** 后,构建将主程序头文件导出到可见目录:
  54. ```text
  55. <工程目录>/Headers/<App target 名>/
  56. ```
  57. 构建日志会打印实际路径。头文件不会自动加入 Xcode 的 App target;生成目录应加入项目 `.gitignore`。旧版本曾使用 `.monkeydev/Headers`,现有工程下次构建使用新目录。头文件主要用于分析,不保证能作为完整 SDK 直接编译。
  58. Reveal 使用用户本机 SDK,不再随 MonkeyDev 分发框架。先通过 Reveal 下载 SDK,默认读取:
  59. ```text
  60. ~/Library/Application Support/Reveal/RevealServer/RevealServer.xcframework
  61. ```
  62. 选择 **UI Inspector (Debug) → Reveal** 后重新 Build/Run,允许 App 的本地网络访问,在 Reveal 选择运行中的 App;USB 连接已验证。查看层级时保持 App 继续运行,不停在断点上。Release 不接入 Reveal。
  63. LookinServer 1.2.8 的 arm64 动态 framework 已内置。安装 Lookin 桌面客户端后,选择 **UI Inspector (Debug) → Lookin**,Debug Build/Run,通过 USB 在 Lookin 打开运行中的 App,无需额外下载或编译 Server。自定义版本可通过 `MONKEYDEV_LOOKIN_SDK` 指定动态 framework 路径。Release 不接入。
  64. 旧工程的 `MONKEYDEV_REVEAL=YES` 仍可用;显式设置 `MONKEYDEV_UI_INSPECTOR` 时以新选项为准。上游许可证、对应源码和版本说明保留在 `Librarys/Lookin/`。
  65. ## MonkeyPod
  66. MonkeyPod 将 CaptainHook 插件做成可复用的 CocoaPods 库,由 MonkeyApp 的 Dylib target 引用,不负责独立重签名或设备安装。先安装 CocoaPods:
  67. ```bash
  68. brew install cocoapods
  69. ```
  70. 用 **MonkeyDev → MonkeyPod** 创建工程。向导生成 Objective-C framework、公开头文件和同目录的 podspec,支持 iOS 15+ arm64。先用本地 Pod 验证,在 MonkeyApp 工程根目录创建 Podfile,例如:
  71. ```ruby
  72. # 兼容当前 CocoaPods 尚未支持的 Xcode 27 工程字段,仅在本次进程中生效。
  73. require '/opt/MonkeyDev/Tools/cocoapods-compat'
  74. platform :ios, '15.0'
  75. target 'YourAppDylib' do
  76. use_frameworks! :linkage => :dynamic
  77. pod 'YourPlugin', :path => '../YourPlugin/YourPlugin'
  78. end
  79. ```
  80. 替换 target、Pod 名和路径;`:path` 指向 podspec 所在目录,不是 `.xcodeproj`。执行 `pod install` 后打开 `.xcworkspace`,通过 MonkeyApp 的 App scheme Build/Run。使用动态 framework,让插件 constructor 随加载执行,避免静态链接时只含 Hook 函数的文件被丢弃。
  81. 默认示例对 `CustomViewController` 的实例方法 `getMyName` 返回 `MonkeyDevPod`,可用 MonkeyApp 内置 Demo 验证;实际使用时改成目标 App 的类、selector 和准确签名。CaptainHook 使用内部后端,不链接旧 Substrate。插件 framework 会由现有打包流程复制并签名。
  82. 兼容模块转换脚本数组和 framework 复制目的地,生成的 Pods 工程使用 CocoaPods 支持的格式,不修改宿主工程版本或已安装的 gem。遇到旧解析器不支持的其他 `dstSubfolder` 复制目录时会报错停止,避免保存时丢失目录配置。当前新格式仍可能出现版本提示;遇到其他未知字段时先检查,不按本例推断任意第三方工程均兼容。发布 Pod 前需自行补齐实际仓库、作者、许可等元数据,默认示例地址不能用于发布。
  83. ## 越狱 Logos Tweak
  84. Logos Tweak、CaptainHook Tweak、Command-line Tool 创建向导的 **Package Scheme** 可选择 `rootless`(默认)、`rootful` 或 `roothide`,自动切换构建配置和 deb 布局。Tweak 需要兼容 MobileSubstrate 接口的 Hook 框架(例如对应环境的 ElleKit),不随插件打包旧 Substrate。roothide 使用随机越狱根目录,不能用普通 rootless 包直接代替。 仅选择 roothide 时可直接 `#include <roothide.h>`,通过 `jbroot()` 等官方接口访问插件资源;未调用 API 不保留运行库依赖。rootless/rootful 不引入该 SDK。
  85. CaptainHook Tweak 和 Command-line Tool 使用相同的 USB、认证和 deb 安装配置。CaptainHook 默认使用内部 Objective-C Runtime Hook,不链接 Substrate;仍需设备上的 tweak 加载器加载插件。将工程 `Package/Library/MobileSubstrate/DynamicLibraries/<项目名>.plist` 的 Filter 改为目标 App 的 Bundle ID。
  86. Command-line Tool 保留 C、C++、Foundation、Core Foundation 类型,使用 ldid 签名,默认不申请额外权限。rootless 安装到 `/var/jb/usr/bin`,rootful / roothide 安装到 `/usr/bin`(roothide 环境内的逻辑路径);安装后通过设备 SSH 执行程序,不通过 Xcode Run 启动。
  87. 创建向导默认使用 USB 连接和 rootless 布局,授权方式可选 `None`、`KEY`(默认,SSH 密钥免密)或 `PASSWORD`(输入设备账号、密码)。`None` 只生成 deb,不安装;`KEY` 和 `PASSWORD` 在 Build 后自动安装 tweak。免密模式沿用 SSH 配置;只有密码模式启用账号、密码输入,默认账号为 `mobile`,密码必填。向导填写的密码会保存在工程中,请勿提交或分享。
  88. USB 优先使用显式配置的 UDID,其次使用 Xcode 选择的设备,否则自动识别唯一连接的 USB 设备。IP 连接、SSH 别名和其他高级设置仍可在 target 的 Build Settings 中配置:
  89. | 设置 | 用途 |
  90. | --- | --- |
  91. | `MonkeyDevConnectionType` | `USB`:通过 inetcat 直连;`IP`:通过局域网直连;`SSH`:继承 SSH 配置别名 |
  92. | `MonkeyDevDeviceUDID` | 可选,手动指定 USB 目标设备;连接多台设备时可填写 |
  93. | `MonkeyDevDeviceIP` | IP 地址或 SSH 别名;USB 模式也可填写别名以复用账号和密钥配置 |
  94. | `MonkeyDevDevicePort` | 设备 SSH 端口;USB 默认 22,SSH 别名模式留空可继承配置 |
  95. | `MonkeyDevAuthentication` | `None`:只打包、不安装;`AUTO`:自动认证;`KEY`:公钥免密;`PASSWORD`:强制密码认证 |
  96. | `MonkeyDevDeviceUser` | SSH 用户,留空继承 `~/.ssh/config` |
  97. | `MonkeyDevDeviceKey` | 可选私钥路径,留空使用 SSH 配置或 ssh-agent |
  98. | `MonkeyDevDevicePasswordFile` | 可选本地密码文件(一行密码),用于密码登录或非 root 用户的 sudo 安装 |
  99. | `MonkeyDevInstallOnAnyBuild` | 设为 `YES` 后,Build 自动上传并安装 deb |
  100. | `MonkeyDevkillProcessOnInstall` | 安装后退出的目标进程名,默认留空,不自动重启 SpringBoard |
  101. USB 模式需要 `brew install libusbmuxd libimobiledevice`,无需启动 iproxy;密码认证需要 `brew install sshpass`。密码也可通过不提交 Git 的本地配置设置 `MonkeyDevDevicePassword`,或使用密码文件。密码文件与直接配置同时存在时,以密码文件为准。
  102. 首次连接先在终端确认设备 SSH 主机身份。USB 模式在 rootless/rootful 下使用 `monkeydev-usb-<UDID>`,roothide 下使用独立的 `monkeydev-roothide-<UDID>` 作为主机身份别名;IP 模式使用目标主机身份;SSH 模式遵循用户已有配置。构建不会关闭主机密钥检查。SSH 免密登录与 sudo 权限独立:mobile 免密登录后,安装 deb 仍需要 sudo 密码或已有的免密 sudo 权限。
  103. 首次 USB 连接可用下面的命令,将 `<UDID>` 和 `mobile` 替换为实际设备与账号;密钥可由 SSH 配置提供,也可通过 `-i` 指定:
  104. ```bash
  105. # rootless / rootful
  106. ssh -o "ProxyCommand=inetcat -u <UDID> 22" -o "HostKeyAlias=monkeydev-usb-<UDID>" mobile@usb-iphone
  107. # roothide
  108. ssh -o "ProxyCommand=inetcat -u <UDID> 22" -o "HostKeyAlias=monkeydev-roothide-<UDID>" mobile@usb-iphone
  109. ```
  110. ## 支持范围与迁移
  111. - 支持 MonkeyApp 的 thin arm64、未加密 iOS 真机输入;不支持 Intel 主机、模拟器、arm64e/PAC、Fat 或加密输入。arm64e 设备可以运行 arm64 App。
  112. - 打包副本会移除 App 扩展、Watch 和旧 Store 元数据;当前不覆盖扩展的独立签名与安装。原始 IPA/App 保留。
  113. - Cycript 和旧 Substrate 运行库已移除。CaptainHook/Logos internal 保留;Logos internal 不支持 `%hookf`。
  114. - Logos Tweak、CaptainHook Tweak、iOS Command-line Tool 的 rootless arm64 已完成真机验证;Logos Tweak、CaptainHook Tweak 另已在 iPhone X / iOS 16.7.16 / Dopamine-roothide 2.4.9.27 + ElleKit 验证安装及 Hook 弹窗,Command-line Tool 的 C 示例也已验证安装与 SSH 执行;rootful 仅完成构建和打包检查。
  115. - MonkeyPod 已完成本地动态 Pod 接入 MonkeyApp、签名安装及真机 Hook 验证;Pod 发布流程未验证。
  116. - macOS 模板尚未迁移验证,不在当前支持范围内。
  117. - 模板更新影响新建项目;已有工程需单独迁移。增量构建的签名阶段必须每次执行。
  118. 历史资料保留在 [Wiki](https://github.com/AloneMonkey/MonkeyDev/wiki) 和 [MonkeyDevSpecs](https://github.com/AloneMonkey/MonkeyDevSpecs),其中旧依赖和安装步骤不代表当前适配状态。
  119. ## 卸载
  120. ```bash
  121. sudo /opt/MonkeyDev/bin/md-uninstall
  122. ```
  123. 卸载会删除整个 `/opt/MonkeyDev` 专用目录(包括自行放入其中的文件),以及安装器记录的模板链接和 shell 配置。需要保留的自定义文件请先备份;工程、目标 IPA/App 和 Theos 不会删除,也不会修改 Xcode.app。
  124. **免责声明: 软件仅供技术交流,禁止用于商业及非法用途,如产生法律纠纷与本人无关。**
  125. ## 个人博客
  126. 欢迎访问我的个人博客 [AloneMonkey](https://www.alonemonkey.com),阅读更多技术文章与实践分享。
  127. ## 关注公众号 · 添加个人微信
  128. 欢迎扫码关注我的微信公众号,或添加个人微信,一起交流技术与实践。
  129. | 个人微信 · AloneMonkey | 微信公众号 |
  130. | :---: | :---: |
  131. | <img src="assets/wechat-personal.jpg" alt="AloneMonkey 个人微信二维码" width="280" /> | <img src="assets/wechat-official-account.png" alt="微信公众号关注二维码" width="280" /> |
  132. <a href="https://hotrepo.ai/zh/AloneMonkey/MonkeyDev?utm_source=github-readme&utm_medium=chart">
  133. <picture>
  134. <source media="(prefers-color-scheme: dark)" srcset="https://hotrepo.ai/AloneMonkey/MonkeyDev/star-history.svg?style=avatar&lang=zh&theme=dark">
  135. <img alt="AloneMonkey/MonkeyDev 的 Star 增长" src="https://hotrepo.ai/AloneMonkey/MonkeyDev/star-history.svg?style=avatar&lang=zh">
  136. </picture>
  137. </a>

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.