mirror of
https://github.com/Lakr233/vphone-cli.git
synced 2026-09-02 02:34:29 +00:00
docs: add amfree support as an alternative to amfidont for Option 2 (#235)
This commit is contained in:
Xin Huang
@@ -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."`**
|
||||
|
||||
|
||||
+7
-2
@@ -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、メッセージなど）がダウンロード・インストールできません**
|
||||
|
||||
|
||||
+7
-2
@@ -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, 메시지 등)을 다운로드하거나 설치할 수 없습니다.**
|
||||
|
||||
|
||||
+7
-2
@@ -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、信息等）无法下载或安装。**
|
||||
|
||||
|
||||
Reference in New Issue
Block a user