Run a virtual iPhone on an Apple Silicon Mac.
Swift
Include PCC GPU provenance in sibling package
Lakrd82d00f71ae0
diff --git a/AGENTS.md b/AGENTS.mdindex 39f2c70b..d8856fb7 100644--- a/AGENTS.md+++ b/AGENTS.md@@ -180,13 +180,13 @@ scripts/ # Build scripts and payloads only; no runtime├── guest_binaries.mk [b] # Cross-compiles vphoned (needs the iPhoneOS SDK)├── check_aux.sh [b] # The self-containment admission gates — `make check-aux`├── setup_tools.sh [b] # Builds insert_dylib, the Mach-O byte-parity test reference-├── payloads/ # Small GPU driver archive; no bootstrap payloads├── vphoned/ # Guest daemon source; only its plist and entitlements ship└── repos/ # Toolchain source (git submodule: insert_dylib)-siblings/ # Optional guest components; separate Makefile/package+siblings/ # Guest component sources/provenance; separate package├── camfix/ vcamcaptured/ # Camera hooks and filter plists-└── tweakloader/ vpregister/ # Loader and iOS 27 app registrar+├── tweakloader/ vpregister/ # Loader and iOS 27 app registrar+└── gpu/ # PCC firmware provenance; no Apple binaryresearch/ # Detailed firmware/patch documentation```diff --git a/Makefile b/Makefileindex fc94e7c3..db0d2606 100644--- a/Makefile+++ b/Makefile@@ -74,7 +74,7 @@ help:@echo "Build:"@echo " make build Build + sign vphone-cli"@echo " make vphoned Cross-compile + sign vphoned for iOS"- @echo " make siblings_package Build + archive optional guest components"+ @echo " make siblings_package Archive four optional guest components + GPU provenance"@echo " make clean Remove build/tooling artifacts only"@echo " Options: CLEAN_VM=1 Also remove VM_DIR=$(VM_DIR) after confirmation"@echo " CLEAN_IPSW=1 Also remove ipsws/ after confirmation"diff --git a/scripts/dist_manifest.sh b/scripts/dist_manifest.shindex 51292c86..8de0b959 100755--- a/scripts/dist_manifest.sh+++ b/scripts/dist_manifest.sh@@ -59,8 +59,8 @@ done## What is deliberately ABSENT is as important:# repos/ toolchain submodules — build tier, sources only-# ../siblings/ optional guest sources and archives; not part of the-# shipped app or automatic VM installation+# ../siblings/ guest sources and GPU provenance; not copied into the+# shipped app (GPU extraction runs in native fw prepare)# vphoned/*.m *.h vendor/ Makefile same, and it is the bulk of scripts/print -r -- "vphoned/vphoned.plist" # LaunchDaemon plist, injectLaunchDaemonsprint -r -- "vphoned/entitlements.plist" # guest_sign_ent for vphoneddiff --git a/siblings/Makefile b/siblings/Makefileindex f42de999..18df6a27 100644--- a/siblings/Makefile+++ b/siblings/Makefile@@ -1,5 +1,5 @@-# Optional guest components. Build on the developer machine with the iPhoneOS SDK.-# Nothing here is staged into vphone-cli.app or installed in a VM.+# Sibling guest components. The four source components compile with the iPhoneOS SDK.+# The GPU item is provenance only: fw prepare extracts the actual Apple bundle.OUT := $(abspath ../.build/siblings)STAGE := $(OUT)/stage@@ -13,17 +13,18 @@ TWEAKLOADER := $(STAGE)/tweakloader/TweakLoader.dylibVPREGISTER := $(STAGE)/vpregister/vpregisterARTIFACTS := $(CAMFIX) $(VCAMCAPTURED) $(TWEAKLOADER) $(VPREGISTER)PLISTS := $(STAGE)/camfix/libcamfix.plist $(STAGE)/vcamcaptured/libvcamcaptured.plist+GPU_PROVENANCE := $(STAGE)/gpu/README.md.PHONY: all package clean-all: $(ARTIFACTS) $(PLISTS)+all: $(ARTIFACTS) $(PLISTS) $(GPU_PROVENANCE)package: all@rm -f $(ARCHIVE)- @/usr/bin/tar -cf $(ARCHIVE) -C $(STAGE) camfix vcamcaptured tweakloader vpregister+ @/usr/bin/tar -cf $(ARCHIVE) -C $(STAGE) camfix vcamcaptured tweakloader vpregister gpu@echo "Packaged $(ARCHIVE)"-$(STAGE)/camfix $(STAGE)/vcamcaptured $(STAGE)/tweakloader $(STAGE)/vpregister:+$(STAGE)/camfix $(STAGE)/vcamcaptured $(STAGE)/tweakloader $(STAGE)/vpregister $(STAGE)/gpu:@mkdir -p $@$(CAMFIX): camfix/libcamfix.m | $(STAGE)/camfix@@ -58,5 +59,8 @@ $(STAGE)/camfix/libcamfix.plist: camfix/libcamfix.plist | $(STAGE)/camfix$(STAGE)/vcamcaptured/libvcamcaptured.plist: vcamcaptured/libvcamcaptured.plist | $(STAGE)/vcamcaptured@cp $< $@+$(GPU_PROVENANCE): gpu/README.md | $(STAGE)/gpu+ @cp $< $@+clean:@rm -rf $(OUT)diff --git a/siblings/README.md b/siblings/README.mdindex 52ce2b86..66c5d540 100644--- a/siblings/README.md+++ b/siblings/README.md@@ -1,9 +1,9 @@-# Optional sibling components+# Sibling guest components-`make siblings_package` (or `make -C siblings package`) cross-compiles the-four optional guest components with Xcode's iPhoneOS SDK and writes-`.build/siblings/siblings.tar`. The archive contains signed arm64e binaries and-the two tweak filter plists:+`make siblings_package` (or `make -C siblings package`) cross-compiles four+optional guest components with Xcode's iPhoneOS SDK and writes+`.build/siblings/siblings.tar`. The archive contains signed arm64e binaries,+two tweak filter plists, and the GPU provenance note:| Component | Archive contents || --- | --- |@@ -11,8 +11,10 @@ the two tweak filter plists:| Camera daemon hook | `vcamcaptured/libvcamcaptured.dylib`, `vcamcaptured/libvcamcaptured.plist` || Tweak loader | `tweakloader/TweakLoader.dylib` || iOS 27 app registrar | `vpregister/vpregister` |+| PCC GPU driver | `gpu/README.md` (source and extraction flow; no Apple binary) |-This is a build artifact, not a VM bootstrap. The normal JB build and install-flow does not stage or install these components. The GPU component is handled-separately until its firmware-derived build flow is integrated here; no Apple-GPU driver is stored in this directory.+The archive is a local build artifact, not a VM bootstrap. The four optional+components are not installed by the normal JB flow. The required GPU bundle is+instead extracted from the selected PCC firmware by `vphone-cli fw prepare`+and copied into the VM during JB installation. No Apple GPU binary is stored+in this directory, the archive, or the shipped app.