Skip to content

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.md
index 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 set
Restart 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 set
After restarting into macOS:
```bash
+ # Using amfidont:
xcrun python3 -m pip install amfidont
sudo 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):
```bash
make 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.md
index 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 amfidont
sudo 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.md
index 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 amfidont
sudo 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.md
index 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 amfidont
sudo 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、信息等)无法下载或安装。**