Run a virtual iPhone on an Apple Silicon Mac.
Swift
setup: Remove artifacts when done to save disk space
zqxwce744090f69491
diff --git a/scripts/cfw_install_host.sh b/scripts/cfw_install_host.shindex 2861b527..f6649155 100755--- a/scripts/cfw_install_host.sh+++ b/scripts/cfw_install_host.sh@@ -88,6 +88,11 @@ trap - EXITecho "[*] flipping boot snapshot offline (com.apple.os.update -> live volume)...""$PY" "$PROJ/tools/apfs_snap_rename.py" "$IMG"+# Drop the extracted CFW input dirs (source .tar.zst re-extracts). VPHONE_KEEP_ARTIFACTS opts out.+if [[ -z "${VPHONE_KEEP_ARTIFACTS:-}" ]]; then+ rm -rf "${VM_DIR:?}/cfw_input" "${VM_DIR:?}/cfw_jb_input"+fi+# The whole install ran as root (owners-honored mounts / chown / cp). Hand the# host-side artifacts it created (vm/.vphoned.signed, vm/.cfw_temp, extracted# cfw_input/cfw_jb_input, the vphoned build) back to the invoking user, so thediff --git a/scripts/fw_prepare.sh b/scripts/fw_prepare.shindex dfa2faa2..f85b9074 100755--- a/scripts/fw_prepare.sh+++ b/scripts/fw_prepare.sh@@ -687,5 +687,13 @@ echo "==> Generating hybrid plists ..."echo "==> Cleaning up ..."rm -rf "$CLOUDOS_DIR"+# Drop the extracted base-IPSW caches (kept .ipsw re-extracts). VPHONE_KEEP_ARTIFACTS opts out.+if [[ -z "${VPHONE_KEEP_ARTIFACTS:-}" ]]; then+ hybrid="$(cd "$IPHONE_DIR" && pwd -P)"+ for cache in "$IPHONE_CACHE" "$CLOUDOS_CACHE"; do+ [[ -d "$cache" && "$(cd "$cache" && pwd -P)" != "$hybrid" ]] && rm -rf "$cache"+ done+fi+echo "==> Done. Restore directory ready: $IPHONE_DIR/"echo " Run 'make fw_patch' to patch boot-chain components."diff --git a/sources/VPhoneCore/VPhoneRestoreInfo.swift b/sources/VPhoneCore/VPhoneRestoreInfo.swiftindex db577710..2ae1a871 100644--- a/sources/VPhoneCore/VPhoneRestoreInfo.swift+++ b/sources/VPhoneCore/VPhoneRestoreInfo.swift@@ -57,6 +57,15 @@ public struct VPhoneRestoreInfo: Codable, Equatable, Sendable {try encoder.encode(self).write(to: Self.url(forBundle: bundle))}+ /// Remove the `iPhone*_Restore/` tree from the bundle; returns its name, or+ /// nil if absent. Record versions (`derive`) first — it reads this directory.+ @discardableResult+ public static func removeBuiltFirmware(fromBundle bundle: VPhoneBundle) throws -> String? {+ guard let dir = findRestoreDirectory(inBundle: bundle) else { return nil }+ try FileManager.default.removeItem(at: dir)+ return dir.lastPathComponent+ }+// MARK: - Restore-directory readsstatic func findRestoreDirectory(inBundle bundle: VPhoneBundle) -> URL? {diff --git a/sources/vphone-cli/VPhoneCreateOrchestrator.swift b/sources/vphone-cli/VPhoneCreateOrchestrator.swiftindex 364cd93f..6935505f 100644--- a/sources/vphone-cli/VPhoneCreateOrchestrator.swift+++ b/sources/vphone-cli/VPhoneCreateOrchestrator.swift@@ -104,6 +104,7 @@ public struct VPhoneCreateOrchestrator {public var memoryMB: UInt64public var diskSizeGB: UInt64public var verbosity: VPhoneVerbosity+ public var keepArtifacts: Boolpublic init(name: String,@@ -117,7 +118,8 @@ public struct VPhoneCreateOrchestrator {cpuCount: UInt = 8,memoryMB: UInt64 = 8192,diskSizeGB: UInt64 = 64,- verbosity: VPhoneVerbosity = .quiet+ verbosity: VPhoneVerbosity = .quiet,+ keepArtifacts: Bool = false) {self.name = nameself.variant = variant@@ -131,6 +133,7 @@ public struct VPhoneCreateOrchestrator {self.memoryMB = memoryMBself.diskSizeGB = diskSizeGBself.verbosity = verbosity+ self.keepArtifacts = keepArtifacts}}@@ -215,6 +218,13 @@ public struct VPhoneCreateOrchestrator {try runCFWInstall(options: options, bundleURL: bundleURL, sudoEnvExtras: sudoEnvExtras)}+ // CFW install is the last consumer of the built restore tree (it copies+ // the SystemOS/AppOS cryptexes from it onto Disk.img); reclaim it now.+ if !options.keepArtifacts, let bundle = try? VPhoneBundle.load(at: bundleURL),+ let removed = try? VPhoneRestoreInfo.removeBuiltFirmware(fromBundle: bundle) {+ print("[+] Removed built firmware \(removed)/ to save space (--keep-artifacts to keep)")+ }+print("\n=== First boot ===")try runFirstBoot(options: options, isLess: isLess, bundleURL: bundleURL)@@ -301,6 +311,7 @@ public struct VPhoneCreateOrchestrator {env["IPSW_DIR"] = resources.ipswCacheDir.pathenv["VPHONE_SEAL_DIR"] = resources.sealVolumeCacheDir.pathif isLess { env["VARIANT"] = "less" }+ if options.keepArtifacts { env["VPHONE_KEEP_ARTIFACTS"] = "1" }trace("spawn /bin/bash \(resources.fwPrepareScript.path) (env keys: VPHONE_PYTHON, IPSW_DIR, VPHONE_SEAL_DIR)", v)let code = try VPhoneProcessRunner.runStreaming(@@ -474,6 +485,7 @@ public struct VPhoneCreateOrchestrator {env["IPSW_DIR"] = resources.ipswCacheDir.pathenv["VPHONE_SEAL_DIR"] = resources.sealVolumeCacheDir.pathenv["VPHONE_DEBS_DIR"] = resources.debsCacheDir.path+ if options.keepArtifacts { env["VPHONE_KEEP_ARTIFACTS"] = "1" }for (key, value) in sudoEnvExtras { env[key] = value }let args = [resources.cfwInstallHostScript.path, "--variant", options.variant, bundleURL.path]diff --git a/sources/vphone-cli/VPhoneRestoreCLI.swift b/sources/vphone-cli/VPhoneRestoreCLI.swiftindex 4a319579..1c53313f 100644--- a/sources/vphone-cli/VPhoneRestoreCLI.swift+++ b/sources/vphone-cli/VPhoneRestoreCLI.swift@@ -104,6 +104,7 @@ struct VPhoneCFWInstallCommand: ParsableCommand {@Option(name: [.customShort("V"), .long], help: "variant: regular | dev | jb | exp") var variant: String = "exp"@Option(name: [.customShort("b"), .long], help: "(exp only) rewrite ProductBuildVersion to this build id") var spoofBuild: String?@Flag(name: .customLong("force-dsc-maxslide"), help: "Zero the dyld cache maxSlide on non-27 bases (opt-in DSC-map fit)") var forceDSCMaxSlide = false+ @Flag(name: .customLong("keep-artifacts"), help: "Keep the extracted CFW input dirs (cfw_input/, cfw_jb_input/) after install (default: removed to save space)") var keepArtifacts = false@Option(name: .shortAndLong, help: "Resource base override (default: inferred from the running binary path)")var projectRoot: String?@Flag(name: .customShort("v"), help: "Increase verbosity: -v tool detail, -vv guest serial, -vvv internal trace")@@ -121,6 +122,7 @@ struct VPhoneCFWInstallCommand: ParsableCommand {var env = ProcessInfo.processInfo.environmentif let spoofBuild { env["SPOOF_BUILD"] = spoofBuild }if forceDSCMaxSlide { env["FORCE_DSC_MAXSLIDE"] = "1" }+ if keepArtifacts { env["VPHONE_KEEP_ARTIFACTS"] = "1" }// Same redirect as `fw prepare`: VPHONE_PYTHON/IPSW_DIR/VPHONE_SEAL_DIR are// exported for the bundled scripts (cfw_install_host.sh's PY/P lines honor@@ -140,6 +142,9 @@ struct VPhoneCFWInstallCommand: ParsableCommand {}let code = try VPhoneProcessRunner.runStreaming(URL(fileURLWithPath: "/bin/zsh"), args, env: env, echo: v.showsToolDetail)+ if code == 0, !keepArtifacts, let removed = try? VPhoneRestoreInfo.removeBuiltFirmware(fromBundle: bundle) {+ print("[cfw] removed built firmware \(removed)/ to save space (--keep-artifacts to keep)")+ }throw ExitCode(code)}}diff --git a/sources/vphone-cli/VPhoneVMCreateCLI.swift b/sources/vphone-cli/VPhoneVMCreateCLI.swiftindex 6c60ccf4..acd0c70b 100644--- a/sources/vphone-cli/VPhoneVMCreateCLI.swift+++ b/sources/vphone-cli/VPhoneVMCreateCLI.swift@@ -21,6 +21,8 @@ struct VPhoneVMCreateCommand: ParsableCommand {@Option(name: [.customShort("b"), .long], help: "(exp only) rewrite ProductBuildVersion to this build id") var spoofBuild: String?@Flag(name: .customLong("force-dsc-maxslide"), help: "Zero the dyld cache maxSlide on non-27 bases (opt-in DSC-map fit)") var forceDSCMaxSlide = false@Flag(help: "Prompt at first-boot stages instead of running non-interactively") var interactive = false+ @Flag(name: .customLong("keep-artifacts"), help: "Keep intermediate build artifacts (built restore firmware, extracted base-IPSW caches, extracted CFW input dirs) instead of removing them after use. Source archives (.ipsw / .tar.zst) are always kept.")+ var keepArtifacts = false@Option(name: .shortAndLong, help: "Resource base override (default: inferred from the running binary path)")var projectRoot: String?@Flag(name: .customShort("v"), help: "Increase verbosity: -v tool detail, -vv guest serial, -vvv internal trace")@@ -37,6 +39,7 @@ struct VPhoneVMCreateCommand: ParsableCommand {name: name, variant: variant,iphoneSource: sources.iphoneSource, cloudosSource: sources.cloudosSource,sudoPassword: sudoPassword, spoofBuild: spoofBuild, forceDSCMaxSlide: forceDSCMaxSlide,- interactive: interactive, verbosity: VPhoneVerbosity(count: verboseCount)))+ interactive: interactive, verbosity: VPhoneVerbosity(count: verboseCount),+ keepArtifacts: keepArtifacts))}}