mirror of
https://github.com/Lakr233/vphone-cli.git
synced 2026-09-05 17:14:28 +00:00
Merge pull request #111 from zqxwce/feature/amfidont_readme
readme: Add `amfidont` as an option
This commit is contained in:
@@ -30,9 +30,13 @@ See [research/patch_comparison_all_variants.md](./research/patch_comparison_all_
|
||||
|
||||
**Host OS:** macOS 15+ (Sequoia) is required for PV=3 virtualization.
|
||||
|
||||
**Disable SIP and AMFI** — required for private Virtualization.framework entitlements.
|
||||
**Configure SIP/AMFI** — required for private Virtualization.framework entitlements and unsigned binary workflows.
|
||||
|
||||
Boot into Recovery (long press power button), open Terminal:
|
||||
Boot into Recovery (long press power button), open Terminal, then choose one setup path:
|
||||
|
||||
- **Option 1: Fully disable SIP + AMFI boot-arg (most permissive)**
|
||||
|
||||
In Recovery:
|
||||
|
||||
```bash
|
||||
csrutil disable
|
||||
@@ -47,6 +51,22 @@ sudo nvram boot-args="amfi_get_out_of_my_way=1 -v"
|
||||
|
||||
Restart once more.
|
||||
|
||||
- **Option 2: Keep SIP mostly enabled, disable only debug restrictions, use [`amfidont`](https://github.com/zqxwce/amfidont)**
|
||||
|
||||
In Recovery:
|
||||
|
||||
```bash
|
||||
csrutil enable --without debug
|
||||
csrutil allow-research-guests enable
|
||||
```
|
||||
|
||||
After restarting into macOS:
|
||||
|
||||
```bash
|
||||
xcrun python3 -m pip install amfidont
|
||||
sudo amfidont --path [PATH_TO_VPHONE_DIR]
|
||||
```
|
||||
|
||||
**Install dependencies:**
|
||||
|
||||
```bash
|
||||
@@ -171,12 +191,17 @@ Connect via:
|
||||
|
||||
**Q: I get `zsh: killed ./vphone-cli` when trying to run it.**
|
||||
|
||||
AMFI is not disabled. Set the boot-arg and restart:
|
||||
AMFI/debug restrictions are not bypassed correctly. Choose one setup path:
|
||||
|
||||
- **Option 1 (full AMFI disable):**
|
||||
|
||||
```bash
|
||||
sudo nvram boot-args="amfi_get_out_of_my_way=1 -v"
|
||||
```
|
||||
|
||||
- **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.
|
||||
|
||||
**Q: System apps (App Store, Messages, etc.) won't download or install.**
|
||||
|
||||
During iOS setup, do **not** select **Japan** or **European Union** as your region. These regions enforce additional regulatory checks (e.g., sideloading disclosures, camera shutter requirements) that the virtual machine cannot satisfy, which prevents system apps from being downloaded and installed. Choose any other region (e.g., United States) to avoid this issue.
|
||||
|
||||
Reference in New Issue
Block a user