Monkeydev

# MonkeyDev

使用 Xcode 完成已有 iOS App 的插件开发、重签名、真机安装与调试。工作流为：安装 MonkeyDev → 创建 MonkeyApp → 放入目标 IPA/App → 编写 dylib → Xcode Build/Run。优先使用已有工程；用户要求新建时再创建工程。不要将此流程替换成独立重打包脚本。

先区分任务：非越狱重签名使用 MonkeyApp；越狱设备向已安装 App 注入插件使用 Logos Tweak 或 CaptainHook Tweak；在设备 SSH 中运行程序使用 Command-line Tool。后两种流程见第 9 节，不需要把 App 放进 TargetApp，也不使用开发团队的 provisioning profile 安装 deb。

仓库：<https://github.com/AloneMonkey/MonkeyDev>。本文件可单独作为操作入口，无需先读取完整仓库文档。从分支或特定提交读取本文件时，使用同一版本的安装脚本和源码，避免新说明搭配旧模板。

## 1. 检查前提

- Apple Silicon Mac，使用原生 arm64 终端；完整 Xcode 已安装并完成首次启动配置。
- MonkeyApp：iPhone 开启开发者模式、信任此 Mac，并在安装启动时保持解锁。准备可用的开发团队、签名证书及授权该设备的 provisioning profile；Personal Team 的实际限制由 Xcode/Apple 决定。
- MonkeyApp 输入为已砸壳的 IPA 或未加密 `.app`，主程序及保留的嵌入代码应符合 thin arm64 范围。MonkeyDev 不负责在非越狱设备上自动砸壳。
- 当前支持基线为 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 或系统进程兼容。

先检查：

```bash
uname -m
xcode-select -p
xcodebuild -version
xcrun --sdk iphoneos --show-sdk-path
```

`uname -m` 应为 `arm64`。若选中的是 CommandLineTools 而非完整 Xcode，选择实际的 Xcode Developer 目录；默认位置可用：

```bash
sudo xcode-select -s /Applications/Xcode.app/Contents/Developer
```

## 2. 安装与更新

### 安装 Theos

Logos 预处理使用普通用户的 `~/theos`。已有该目录时先确认 `~/theos/bin/logos.pl` 可执行，不覆盖用户现有安装。不使用 `/opt/theos`。