Run a virtual iPhone on an Apple Silicon Mac.
Swift
docs: add amfree support as an alternative to amfidont for Option 2 (#235)
Xin Huangc7205642e562
diff --git a/README.md b/README.mdindex 34153f15..07cad634 100644--- a/README.md+++ b/README.md@@ -54,7 +54,7 @@ Boot into Recovery (long press power button), open Terminal, then choose one setRestart once more.-- **Option 2: Keep SIP mostly enabled, disable only debug restrictions, use [`amfidont`](https://github.com/zqxwce/amfidont)**+- **Option 2: Keep SIP mostly enabled, disable only debug restrictions, use [`amfidont`](https://github.com/zqxwce/amfidont) or [`amfree`](https://github.com/retX0/amfree)**In Recovery:@@ -66,11 +66,16 @@ Boot into Recovery (long press power button), open Terminal, then choose one setAfter restarting into macOS:```bash+ # Using amfidont:xcrun python3 -m pip install amfidontsudo amfidont --path [PATH_TO_VPHONE_DIR]++ # OR Using amfree:+ brew install retX0/tap/amfree+ sudo amfree --path [PATH_TO_VPHONE_DIR]```- Repo helper:+ Repo helper (for amfidont):```bashmake amfidont_allow_vphone@@ -250,9 +255,9 @@ AMFI/debug restrictions are not bypassed correctly. Choose one setup path:```- **Option 2 (debug restrictions only):**- use Recovery mode `csrutil enable --without debug` (no full SIP disable), then install/load [`amfidont`](https://github.com/zqxwce/amfidont) while keeping AMFI otherwise enabled.+ use Recovery mode `csrutil enable --without debug` (no full SIP disable), then install/load [`amfidont`](https://github.com/zqxwce/amfidont) or [`amfree`](https://github.com/retX0/amfree) while keeping AMFI otherwise enabled.For this repo, `make amfidont_allow_vphone` packages the required encoded-path- and CDHash allowlist startup.+ and CDHash allowlist startup (if using amfidont).**Q: `make boot` / `make boot_dfu` starts and then fails with `VZErrorDomain Code=2 "Virtualization is not available on this hardware."`**diff --git a/docs/README_ja.md b/docs/README_ja.mdindex ff73fb3a..b463a3dd 100644--- a/docs/README_ja.md+++ b/docs/README_ja.md@@ -54,7 +54,7 @@ Apple の Virtualization.framework と PCC の研究用 VM インフラを使用もう一度再起動します。-- **方法 2:SIP はほぼ有効のまま、デバッグ制限のみ無効化、[`amfidont`](https://github.com/zqxwce/amfidont) を使用**+- **方法 2:SIP はほぼ有効のまま、デバッグ制限のみ無効化、[`amfidont`](https://github.com/zqxwce/amfidont) または [`amfree`](https://github.com/retX0/amfree) を使用**復旧モードで:@@ -66,8 +66,13 @@ Apple の Virtualization.framework と PCC の研究用 VM インフラを使用通常の macOS に再起動した後:```bash+ # amfidont の場合:xcrun python3 -m pip install amfidontsudo amfidont --path [PATH_TO_VPHONE_DIR]++ # または amfree の場合:+ brew install retX0/tap/amfree+ sudo amfree --path [PATH_TO_VPHONE_DIR]```**依存関係のインストール:**@@ -239,7 +244,7 @@ AMFI/デバッグ制限が正しくバイパスされていません。以下の```- **方法 2(デバッグ制限のみ無効化):**- 復旧モードで `csrutil enable --without debug`(完全な SIP 無効化は不要)を使用し、[`amfidont`](https://github.com/zqxwce/amfidont) をインストール/ロードして AMFI のその他の機能は有効のままにします。+ 復旧モードで `csrutil enable --without debug`(完全な SIP 無効化は不要)を使用し、[`amfidont`](https://github.com/zqxwce/amfidont) または [`amfree`](https://github.com/retX0/amfree) をインストール/ロードして AMFI のその他の機能は有効のままにします。**Q: システムアプリ(App Store、メッセージなど)がダウンロード・インストールできません**diff --git a/docs/README_ko.md b/docs/README_ko.mdindex 9125a737..a95e352b 100644--- a/docs/README_ko.md+++ b/docs/README_ko.md@@ -54,7 +54,7 @@ PCC 리서치 VM 인프라와 Apple의 Virtualization.framework를 사용하여한 번 더 재시작합니다.-- **방법 2: SIP은 대부분 활성 유지, 디버그 제한만 비활성화, [`amfidont`](https://github.com/zqxwce/amfidont) 사용**+- **방법 2: SIP은 대부분 활성 유지, 디버그 제한만 비활성화, [`amfidont`](https://github.com/zqxwce/amfidont) 또는 [`amfree`](https://github.com/retX0/amfree) 사용**복구 모드에서:@@ -66,8 +66,13 @@ PCC 리서치 VM 인프라와 Apple의 Virtualization.framework를 사용하여macOS로 다시 시작한 후:```bash+ # amfidont 사용:xcrun python3 -m pip install amfidontsudo amfidont --path [PATH_TO_VPHONE_DIR]++ # 또는 amfree 사용:+ brew install retX0/tap/amfree+ sudo amfree --path [PATH_TO_VPHONE_DIR]```**의존성(Dependencies) 설치:**@@ -239,7 +244,7 @@ AMFI/디버그 제한이 올바르게 우회되지 않았습니다. 다음 중```- **방법 2 (디버그 제한만 비활성화):**- 복구 모드에서 `csrutil enable --without debug`(완전한 SIP 비활성화 없음)를 사용한 다음, [`amfidont`](https://github.com/zqxwce/amfidont)를 설치/로드하여 AMFI의 나머지 기능은 활성 상태로 유지합니다.+ 복구 모드에서 `csrutil enable --without debug`(완전한 SIP 비활성화 없음)를 사용한 다음, [`amfidont`](https://github.com/zqxwce/amfidont) 또는 [`amfree`](https://github.com/retX0/amfree)를 설치/로드하여 AMFI의 나머지 기능은 활성 상태로 유지합니다.**Q: 시스템 앱(App Store, 메시지 등)을 다운로드하거나 설치할 수 없습니다.**diff --git a/docs/README_zh.md b/docs/README_zh.mdindex 922e4d35..c7ae5f5c 100644--- a/docs/README_zh.md+++ b/docs/README_zh.md@@ -54,7 +54,7 @@再重启一次。-- **方式 2:保持 SIP 大部分启用,仅禁用调试限制,使用 [`amfidont`](https://github.com/zqxwce/amfidont)**+- **方式 2:保持 SIP 大部分启用,仅禁用调试限制,使用 [`amfidont`](https://github.com/zqxwce/amfidont) 或 [`amfree`](https://github.com/retX0/amfree)**在恢复模式中:@@ -66,8 +66,13 @@重新启动回 macOS 后:```bash+ # 使用 amfidont:xcrun python3 -m pip install amfidontsudo amfidont --path [PATH_TO_VPHONE_DIR]++ # 或使用 amfree:+ brew install retX0/tap/amfree+ sudo amfree --path [PATH_TO_VPHONE_DIR]```**安装依赖:**@@ -241,7 +246,7 @@ AMFI/调试限制未正确绕过。选择以下任一方式:```- **方式 2(仅禁用调试限制):**- 在恢复模式中使用 `csrutil enable --without debug`(不完全禁用 SIP),然后安装/加载 [`amfidont`](https://github.com/zqxwce/amfidont),保持 AMFI 其他功能不变。+ 在恢复模式中使用 `csrutil enable --without debug`(不完全禁用 SIP),然后安装/加载 [`amfidont`](https://github.com/zqxwce/amfidont) 或 [`amfree`](https://github.com/retX0/amfree),保持 AMFI 其他功能不变。**问:系统应用(App Store、信息等)无法下载或安装。**