Skip to content

Run a virtual iPhone on an Apple Silicon Mac.

Swift

Fix HomeView patches

Guilherme Rambo970b123a7792
diff --git a/Research/0_binary_patch_comparison.md b/Research/0_binary_patch_comparison.md
index b5d616ab..16e08a73 100644
--- a/Research/0_binary_patch_comparison.md
+++ b/Research/0_binary_patch_comparison.md
@@ -1,5 +1,33 @@
# Patch Comparison: Regular / Development / Jailbreak / Experimental
+> **HomeView guest-profile backend lookup (2026-10-30).** The BreadBoard
+> display exception clears its first assertion, but its native guest-profile
+> fetch still fails with an NSError chain ending in sandbox restriction 159
+> for `com.apple.mobile.keybagd.UserManager.xpc`. A mobile native probe with
+> BreadBoard's relevant client entitlements reproduces it. Userprofilesd's
+> donor sandbox lacks that lookup. New `system-userprofilesd-exp-keybag_lookup`
+> adds exactly that one exception to userprofilesd, preserving the native
+> profile/persona APIs and authorizations; it never fabricates a profile.
+> Selected only in `homeview`, gated to 27.2, reversible from executable backup.
+> Native setup bypass verification passed independently (`NeedsSetup=false`,
+> `CompletedInitialRun=true`, with `SetupDone` untouched). Validated on the
+> clean HomeView VM: native guest-profile retrieval succeeds, BreadBoard
+> stays up, and Setup.app renders. Touch navigation works from the bypassed
+> dashboard into World Clock and its city chooser.
+
+> **HomeView native shell display startup (2026-10-30).** The clean guest
+> reaches vphoned and backboardd, but BreadBoard traps in
+> `BKSDisplayServicesStart+436`, at the nonzero display-service query status
+> assertion, before drawing its UI. Its donor entitlements use
+> `temporary-sandbox` and lack `com.apple.backboard.display.services` and the
+> backboard HID/render lookups already repaired for Campo on the 26.4 kernel.
+> New `system-breadboard-exp-mach_lookup` reuses that scoped exception merger,
+> preserves the rest of BreadBoard's entitlements, and keeps an executable
+> backup for deselection. On only in `homeview`, gated to 27.2; native setup
+> still stays on. Validated: the display-service assertion is gone. Native
+> startup also needs the userprofilesd lookup repair above. No new kernel or
+> instruction patch.
+
> **HomeView bringup (2026-10-30).** Adds the opt-in
> `system-homeview-exp-setup_bypass`, off in every shipped preset, including
> the new `homeview` preset. The existing mobile setup helper runs in an
@@ -11,8 +39,8 @@
> `devicetree-cfw-tv_app_architecture` also copies the `home` donor's app
> architecture. `system-tv-exp-ota_userland` is reused for HomeView's own
> arm64e full OTA over the HD restore base; Apple TV remote/setup adapters
-> remain off. No new instruction replacement or kernel patch. Static/native
-> validation is separate from the still-pending VM boot and touch test; see
+> remain off. No new instruction replacement or kernel patch. Restore,
+> native setup, bypass enable/disable, framebuffer and touch are now tested; see
> [HomeView bringup](Firmware/homeview_bringup.md).
> **Apple TV RootHide bootstrap and environment hooks (2026-10-26).** No new
diff --git a/Research/Firmware/homeview_bringup.md b/Research/Firmware/homeview_bringup.md
index 6bc0e9d6..bee820ae 100644
--- a/Research/Firmware/homeview_bringup.md
+++ b/Research/Firmware/homeview_bringup.md
@@ -1,12 +1,54 @@
# HomeView virtualization bringup
+## Current tested result
+
+`HomeView` is installed in the normal Launchpad library and left running on
+HomeAccessory17,1 / J490, HomeView 27.2 (24V514), cloudOS 26.4 (23E5207q), with
+8 CPUs, 8 GiB RAM and a 64 GB disk. Its current host and guest bundle is
+`2.15.0-local.176e4e80`; the VM-specific setup bypass is enabled. Shipped
+`homeview` still defaults to native setup. The `native-setup` stopped snapshot
+preserves the working Hello/proximity-setup state before enabling the bypass;
+`native-baseline` preserves the earlier clean boot before the compatibility
+repairs, for reproducing the original display-service failure.
+
+Verified after the two scoped sandbox exception repairs: native Hello and
+Hold iPhone Nearby setup, actual UserProfiles guest-profile retrieval,
+bypass enable and exact preference restoration on disable, stable BreadBoard,
+framebuffer at 1088 square / 544 square points / 2x, virtual USB touchscreen,
+and native touch navigation dashboard → World Clock → Add City → Close →
+dashboard. No clock, account, HomeKit or provisioning choices were saved.
+`device.info` now completes. Final boot has setup pending false, setup_done
+false, no Setup.app process, and stable BreadBoard PID 39. The host window's
+OS subtitle uses the tvOS platform independently of remote-versus-touch input.
+
+Guest DNS resolution of `captive.apple.com` and a bounded HTTPS fetch of its
+connectivity success page both work. The dashboard still shows Weather
+Unavailable and a connectivity warning; those higher-level services have not
+been provisioned or validated. HomeView-shell accessibility discovery still
+uses IcliKit's PineBoard fallback and cannot verify the shell foreground;
+accessibility in native World Clock works. Panel density/dimensions remain
+provisional, and audio, camera and physical-device proximity pairing are not
+validated here.
+
+Screenshots (local build artifacts, not firmware inputs):
+
+- `.build/homeview-validation/native-setup.png`
+- `.build/homeview-validation/dashboard.png`
+- `.build/homeview-validation/touch-city-dialog.png`
+- `.build/homeview-validation/current.png`
+
+Final code validation: VPhone bundle build/admission and installed-bundle
+preflight pass; 57 patch catalog/resolution tests and 400 daemon logic checks
+pass for the runtime repairs. Earlier model/device-tree suites remain recorded
+below. No Python files were added.
+
## Evidence and scope
Inspected 2026-10-30, using the supplied Pallas SoftwareUpdate response, extracted
AssetData at `__tvOS/HomeViewBundle`, and root filesystem at
`__tvOS/__HomeView_27.2` under the operator's `_AppleOSImages` directory. These
-are firmware observations, not results from running a HomeView VM. **No HomeView
-VM has been booted or restored in this investigation.**
+began as firmware observations. The subsequent clean VM restore and first
+runtime failure are recorded below; usable native UI and touch remain unverified.
The Pallas response advertises a full, encrypted AEA update for 27.2, build
`24V514`, supporting `HomeAccessory17,1` and `HomeAccessory17,2`. Its
@@ -14,8 +56,8 @@ The Pallas response advertises a full, encrypted AEA update for 27.2, build
covers both products and includes both `DeviceTree.j490ap.im4p` and
`DeviceTree.j491ap.im4p`. Keep both board identities rather than aliasing J491 to
J490. This asset is not a restore IPSW. The initial implementation uses the
-existing Apple TV HD restore-base/OTA-userland workflow; its suitability for
-HomeView remains a bringup hypothesis pending restore and boot validation.
+existing Apple TV HD restore-base/OTA-userland workflow. A later clean restore
+reached vphoned and backboardd, but the native shell crashes before usable UI.
## Device presentation
@@ -200,3 +242,241 @@ names, the default-disabled setup patch, and export of an opt-in preset.
A network-backed `fw prepare --list` check could not resolve its server in this
execution environment. No firmware download, restore, or VM runtime result is
claimed by these checks.
+
+## First clean runtime, 2026-10-30
+
+The first attempt through an installed 2.14 Launchpad accidentally applied its
+older non-HomeView slimming behavior. It is not a valid native baseline. A fresh
+restore through the lower-level HomeView-aware path replaced that state before
+the observations below. The clean Data volume reports `setup_done=false`,
+setup pending, and service profile `none` (`record=null`, `disabled=[]`). No
+setup preference or UI input was changed during this baseline inspection.
+
+The clean VM reaches guest vphoned and `backboardd`. The actual macOS VM window,
+captured through CUA, remains black with the white Apple boot logo. The window
+reports HomeView, iOS 27.2.0 and a guest NAT address. This is boot graphics, not
+evidence that BreadBoard renders a native HomeView scene. `device.info` and the
+guest-dependent host screenshot request hang, while independent process, file,
+service and crash-list RPCs continue to answer. The stalled diagnostic clients
+were stopped. No successful guest screenshot or accessibility hierarchy was
+obtained, so there was no eligible setup control to touch.
+
+`services.print` shows `com.apple.backboardd` running as mobile, PID 75, one
+launch and no exit. Its advertised endpoints include
+`com.apple.backboard.display.services`, `com.apple.CARenderServer`, and the HID
+services. `com.apple.BreadBoard` is installed and launched correctly, but its
+service record shows eight runs and eight successive SIGTRAP crashes, with a
+roughly ten-second relaunch cadence. This is a shell initialization failure,
+not failure to import the launch daemon.
+
+The pulled `BreadBoard-2026-10-30-191634.ips` (PID 319) reports
+`EXC_BREAKPOINT` / `SIGTRAP` on the main thread:
+
+```text
+BKSDisplayServicesStart + 436
+-[BKSSystemShellService initWithConfigurator:] + 716
+-[FBSystemShell _initWithOptions:] + 664
+FBSystemShellInitialize
+BreadBoardFramework
+```
+
+The inspected donor BackBoardServices extraction has SHA-256
+`f78622e9194149789fa2804cf69ee6c232160f07350e48920183687a27c1f7c3`.
+REA inspection of `BKSDisplayServicesStart` at analysis address `0x19d2dca20`
+shows that the fault at `+436` is the assertion for a **nonzero main-screen
+query result**, rather than either of the later zero-width/zero-height
+assertions. Evidence:
+`ev_af213f97676042412efe1eed3a949f9eaf0b4ac9d63fffd56284337923b52723`.
+Its `__BKSDisplayServicesGetMainScreenInfo` helper at `0x19d2dccf4` calls
+`__BKSServerPortHelper` for `com.apple.backboard.display.services`, then makes
+the main-screen MIG query. Evidence:
+`ev_be76b6a28e2a7ad9a11695498345d971ab123e931d6932beda4a1d8e30f8b2b9`.
+These addresses are evidence for this build only, not patch anchors.
+
+Donor BreadBoard entitlements, decoded with `codesign` and `ldid -e`, explicitly
+select `com.apple.private.sandbox.profile:embedded = temporary-sandbox`. Their
+existing global mach-lookup exception list includes the system-app-server,
+backlightd and AttentionAwareness services but omits
+`com.apple.backboard.display.services`, `com.apple.CARenderServer`,
+`com.apple.iohideventsystem`, and the backboard HID services. This resembles the
+already documented Campo failure on a 27-series userland with the 26.4 research
+kernel. The combination of the native communication assertion, the live
+backboard endpoint, and the missing donor exceptions supports the same repair.
+**A direct BreadBoard sandbox denial was not captured:** a bounded twelve-second
+kernel live-log sample contained unrelated Protobox/Autobox denials, and the
+BreadBoard live-log sample was empty. Historical `log show` could not run
+because this guest does not contain `/usr/bin/log`.
+
+The new `system-breadboard-exp-mach_lookup` declaration merges the existing
+Campo backboard/frontboard service set into BreadBoard's own entitlements,
+preserving its other entitlements and a backup for reversal. It is enabled by
+the `homeview` preset only. **This is a targeted hypothesis pending the updated
+bundle's runtime retest.** Do not count it as a successful native UI or touch
+fix until BreadBoard stays alive and the setup screen renders.
+
+The baseline also produces repeated `duetexpertd` crashes at
+`ATXEnableMobileAssetDataVault + 580`, with the recorded assertion
+`Failed to initialize datavault for DuetExpertCenterAsset`, and ProxiedCrashCopier
+crashes. They are separate observations; fixing the BreadBoard communication
+path does not establish that these services recover. No setup-bypass runtime
+test was performed while the shell could not initialize. All REA sessions were
+closed after the static follow-up.
+
+## BreadBoard entitlement repair retest
+
+Retested installed bundle `2.15.0-local.ceb99033` after its guest environment
+update. The installer merged fifteen previously absent services into
+BreadBoard's existing exception list (73 total). Native guest screenshot
+capture now succeeds; `/tmp/homeview-native-before.png` and
+`/tmp/homeview-native-after.png` show the 1088-square virtual display with the
+Apple boot logo. No native setup control is visible. `ui.tree` fails with
+`frontmost application could not be verified`, so no touch was attempted.
+
+The original display-service assertion is gone. BreadBoard reaches its
+UIApplication main loop, then crashes on a cooperative Swift task. The new
+`BreadBoard-2026-10-30-192039.ips` (PID 249) has
+`_assertionFailure(_:_:file:line:flags:)` followed by BreadBoardFramework offset
+`0x1b4b2c`. REA maps that continuation to a fatal error in
+`BreadBoardFramework/PersonaIdentifier+Personas.swift`, line 118:
+`failed to retrieve guest persona identifier: `.
+Evidence: `ev_ecd077dff6ab3a600304541c83d3258a4d5d86d0065bf439eacf714858545c5f`.
+The caller creates `UPProfileStore` and asynchronously retries the
+`UserProfiles` Swift `guestProfile()` API. This is a separate dependency from
+the initial display-service failure; it is not an assertion to bypass.
+
+`userprofilesd` is running as mobile (PID 131), with one launch and no recorded
+crash. A read-only scripting probe confirms that UserProfiles selects
+`UPProfileStoreCoordinator`, rather than its unsupported-platform null source.
+Static `_makeProfileStoreSource` corroborates that distinction (REA
+`ev_6a6ce20de08f0343d0c04a6418221da2455de8cae9010edc6b25433e00d35221`).
+There are no dedicated multiuser/persona/guest capabilities in either donor's
+product-property inventory. The daemon's unsupported-guest-profile branch
+would return code 2 with `This platform does not support the guest profile`
+(REA `ev_68b03ef664942205bb648dc6d4defb364b0836cd491f65d0923166b1e0abecd3`).
+
+A bounded native Foundation diagnostic, run as mobile with the observed
+UserProfiles read-write entitlement, successfully retrieves an empty profile
+snapshot with no error. Its read-only `fetchGuestProfileWithCompletion:` call
+returns `UPProfileStoreErrorDomain` code 1 (`InternalError`), with underlying
+`NSCocoaErrorDomain` code 4099:
+
+```text
+The connection to service named com.apple.mobile.keybagd.UserManager.xpc
+was invalidated: Connection init failed at lookup with error 159 - Sandbox restriction.
+```
+
+This establishes a failed native dependency lookup rather than absence of
+ordinary profile records. A second mobile diagnostic added BreadBoard's observed
+UserManager client permissions: both service exceptions and persona
+fetch/setbundle entitlements. It returned the identical underlying sandbox
+restriction, while snapshot retrieval still succeeded. Merely adding those
+client permissions does not repair the request; combined with the daemon's
+native call path, this points to the daemon-side dependency. This rerun took
+place after the root investigation enabled the optional setup policy, so the
+persona failure also survives that policy. BreadBoard's donor already has
+both UserManager service exceptions and persona fetch/setbundle entitlements.
+The userprofilesd donor selects `temporary-sandbox` and has persona
+create/delete/fetch entitlements, but its global exceptions include
+`com.apple.mobile.usermanagerd.xpc` and omit
+`com.apple.mobile.keybagd.UserManager.xpc`. Its native
+`UPDPersonasController.createGuestUserPersonaWithCompletionHandler:` calls
+`UMUserManager.sharedManager` then
+`createUserPersona:passcodeData:completionHandler:` (REA
+`ev_ebe027049ce1a2b12e292d54d05e5437dff379ab8d281b0687a425298893e4eb`).
+The missing backend exception is therefore a focused candidate, pending
+caller isolation and runtime repair validation. No profile reset, synthetic
+persona, account enrollment, or setup completion was performed by the
+diagnostic.
+
+## Native setup renders after the backend lookup repair
+
+Bundle `2.15.0-local.dc3b7ead` adds only
+`com.apple.mobile.keybagd.UserManager.xpc` to userprofilesd's own lookup
+exceptions. With the optional setup bypass disabled and its saved override
+restored, the native maintenance status reads `Enabled=false`,
+`Succeeded=true`, `NeedsSetup=true`, `CompletedInitialRun=false`.
+
+On this boot BreadBoard stays alive as PID 38, with last exit status zero.
+The actual native `Setup.app` appears as PID 234. The first screen renders the
+orange animated Hello scene and `Hold iPhone Nearby`; screenshots are
+`/tmp/homeview-native-working-before.png` and
+`/tmp/homeview-native-working-after.png`. Guest geometry is 544 × 544 points
+at scale 2, matching the configured 1088 × 1088 virtual canvas. The host
+reports `mouse_uses_pointer=false`. No clipping or overlapping text was seen
+on this screen. This confirms the chosen virtual canvas works for initial UI;
+it does not establish the physical device's panel geometry or density.
+
+The accessibility tree exposes only a non-clickable `InstructionText` label,
+so this native proximity-setup screen offers no actionable button to test
+without provisioning. One harmless host touchscreen tap at the label center
+(272, 463.75 points; 544, 927.5 screenshot pixels) is accepted. The recaptured
+tree retains the same Setup PID, with the instruction now reading
+`Make sure iPhone Bluetooth is on.` The instruction may rotate independently,
+so this is not proof of a touch-triggered navigation transition. It confirms
+host input submission; interactive native-control touch behavior still needs
+a screen with an actionable control. Setup remains pending and `SetupDone`
+remains false; no account or HomeKit provisioning was performed.
+
+The same mobile native diagnostic with the matched UserManager client
+entitlements now returns an actual `UPGuestProfile` with a native persona UUID
+and **no NSError**. Snapshot retrieval also succeeds. This result, together
+with the unchanged healthy BreadBoard PID and visible native setup UI,
+validates the scoped userprofilesd backend lookup repair for this build. It
+does not depend on the optional setup bypass. The diagnostic binary is staged
+only in guest `/var/tmp` for investigation and is not a shipped component.
+
+## Final native touch and setup-bypass validation
+
+The same `.dc3b7ead` bundle was booted with the optional bypass on. Its native
+maintenance verification reports `NeedsSetup=false` and
+`CompletedInitialRun=true`; guest `setup.status` reports `pending=false`,
+`running=false`, while `setup_done` remains **false**. Thus the bypass does not
+write setup completion flags. The earlier off-mode boot restored its saved
+override and rendered native Setup, validating the policy's inverse as well.
+
+BreadBoard remains alive as PID 39, last exit zero. The native HomeView home
+screen renders a green dashboard with the large date, month calendar, analog
+clock and weather area. `/tmp/homeview-bypass-home.png` records this state.
+The weather area initially displays loading placeholders, then explicitly
+`Weather Unavailable`; World Clock advertises `No Internet Connection`.
+No account or HomeKit provisioning was attempted to change that state.
+
+Touch navigation is now verified against native actionable controls, using the
+host's virtual touchscreen path:
+
+1. A dashboard clock tap opens native World Clock (PID 358). The home shell's
+ AX foreground detection is unavailable, so that initial tap used the
+ screenshot as a bounded fallback. Once World Clock is foreground its
+ accessibility tree reports its actual labels, buttons and hitpoints.
+2. A host touch at its fresh Add hitpoint (477, 477 points, converted to
+ 954, 954 screenshot pixels at 2×) opens `Choose a City`.
+ `/tmp/homeview-bypass-after-touch.png` records the native sheet.
+3. A host touch at the sheet's fresh Close hitpoint (56, 56 points; 112, 112
+ pixels) dismisses it. The recaptured tree again shows only the original
+ Cupertino and New York clocks. No city or preference was added.
+4. An upward gesture returns to the dashboard, verified in
+ `/tmp/homeview-bypass-final.png`. The VM is left running in this state.
+
+No overlapping or unexpectedly clipped controls were observed in the home
+dashboard, World Clock or city chooser. Normal partial list content below the
+viewport scrolls beyond the panel. The 1088-square virtual canvas is usable
+for these verified native scenes; the physical display size/PPI remains
+unestablished.
+
+The one `device.info` retry also completes after the native shell boots,
+reporting `model=HomeAccessory17,1`, native software `27.2.0`, kernel `25.4.0`
+and a 544-square logical screen at 2×. Independent service checks after the
+touch test still show BreadBoard PID 39 with no exit, and setup remains
+suppressed without marking it done.
+
+One automation limitation remains: on the HomeView dashboard,
+`apps.foreground` incorrectly attempts the Apple TV `com.apple.PineBoard`
+fallback and reports PID zero/unverified; `ui.tree` therefore cannot inspect
+the shell. Foreground application AX works, as demonstrated by World Clock
+and its city chooser. This does not prevent host touch input or native UI
+operation, but shell-specific accessibility discovery needs a HomeView port.
+
+The temporary diagnostic path `/var/tmp/homeview-profile-probe` was checked
+after the final test and is absent. No diagnostic helper ships in the guest
+environment. No REA or device-control session remains open, and no further
+setup/account/provisioning action was performed.
diff --git a/VPhoneDaemon/Daemon/GuestAPI+SetupAssistant.swift b/VPhoneDaemon/Daemon/GuestAPI+SetupAssistant.swift
index c47f3bef..d5071cca 100644
--- a/VPhoneDaemon/Daemon/GuestAPI+SetupAssistant.swift
+++ b/VPhoneDaemon/Daemon/GuestAPI+SetupAssistant.swift
@@ -38,6 +38,7 @@ extension GuestAPI {
/// read independently; this correction never writes TV completion state.
static let setupAssistantCurrentVersion = setupAssistantVersion(symbol: "BYBuddyIOSCurrentVersion")
private static let tvSetupAssistantCurrentVersion = setupAssistantVersion(symbol: "BYBuddyTVOSCurrentVersion")
+ private static let usesHomeViewSetupState = GuestSetupAssistantState.usesHomeViewPolicy(machine: GuestVirtualAudioProduct.machine())
private static let usesTVSetupState = GuestSetupAssistantState.usesTVPolicy(machine: GuestVirtualAudioProduct.machine())
private static func setupAssistantVersion(symbol name: String) -> Int? {
@@ -59,10 +60,12 @@ extension GuestAPI {
private static var setupAssistantState: GuestSetupAssistantState {
GuestSetupAssistantState(
setupDone: buddyValue("SetupDone") as? Bool ?? false,
- version: usesTVSetupState ? (buddyValue("TVSetupVersion") as? NSNumber)?.intValue : buddySetupVersion,
- currentVersion: usesTVSetupState ? tvSetupAssistantCurrentVersion : setupAssistantCurrentVersion,
+ version: usesHomeViewSetupState ? nil : usesTVSetupState ? (buddyValue("TVSetupVersion") as? NSNumber)?.intValue : buddySetupVersion,
+ currentVersion: usesHomeViewSetupState ? nil : usesTVSetupState ? tvSetupAssistantCurrentVersion : setupAssistantCurrentVersion,
requiresTVCompletion: usesTVSetupState,
tvCompleted: usesTVSetupState && (buddyValue("TVBuddyCompletedSuccessfully") as? Bool == true),
+ requiresHomeViewCompletion: usesHomeViewSetupState,
+ forceNoBuddy: usesHomeViewSetupState && (buddyValue("ForceNoBuddy") as? Bool == true),
)
}
diff --git a/VPhoneDaemon/Daemon/GuestSetupAssistantState.swift b/VPhoneDaemon/Daemon/GuestSetupAssistantState.swift
index 2736574a..2505ee4b 100644
--- a/VPhoneDaemon/Daemon/GuestSetupAssistantState.swift
+++ b/VPhoneDaemon/Daemon/GuestSetupAssistantState.swift
@@ -3,13 +3,19 @@
struct GuestSetupAssistantState {
static func usesTVPolicy(machine: String) -> Bool { machine.hasPrefix("AppleTV") }
+ static func usesHomeViewPolicy(machine: String) -> Bool { machine.hasPrefix("HomeAccessory") }
+
let setupDone: Bool
let version: Int?
let currentVersion: Int?
let requiresTVCompletion: Bool
let tvCompleted: Bool
+ var requiresHomeViewCompletion = false
+ var forceNoBuddy = false
+
var pending: Bool {
+ if requiresHomeViewCompletion { return !setupDone && !forceNoBuddy }
guard setupDone else { return true }
if requiresTVCompletion && (currentVersion == nil || !tvCompleted) { return true }
if let currentVersion, (version ?? 0) < currentVersion { return true }
diff --git a/VPhoneDaemon/Tests/LogicTests.swift b/VPhoneDaemon/Tests/LogicTests.swift
index 93126615..b9beb8af 100644
--- a/VPhoneDaemon/Tests/LogicTests.swift
+++ b/VPhoneDaemon/Tests/LogicTests.swift
@@ -64,6 +64,16 @@ enum LogicTests {
for machine in ["iPhone17,3", "iPad16,1", "AudioAccessory5,1", ""] {
expect(!GuestSetupAssistantState.usesTVPolicy(machine: machine), "existing policy for \(machine)")
}
+ expect(GuestSetupAssistantState.usesHomeViewPolicy(machine: "HomeAccessory17,1"), "HomeView native setup policy")
+ expect(!GuestSetupAssistantState.usesHomeViewPolicy(machine: "AudioAccessory5,1"), "HomePod keeps its policy")
+ for done in [false, true] {
+ for bypass in [false, true] {
+ let home = GuestSetupAssistantState(setupDone: done, version: nil, currentVersion: nil,
+ requiresTVCompletion: false, tvCompleted: false,
+ requiresHomeViewCompletion: true, forceNoBuddy: bypass)
+ expect(home.pending == (!done && !bypass), "HomeView reads native completion or ForceNoBuddy without an iOS version")
+ }
+ }
func state(_ done: Bool, _ version: Int?, _ current: Int?, tv: Bool = true, completed: Bool = true) -> GuestSetupAssistantState {
GuestSetupAssistantState(setupDone: done, version: version, currentVersion: current, requiresTVCompletion: tv, tvCompleted: completed)
}
diff --git a/VPhoneExecutable/VPhoneCommand/FirmwarePatcher/PatchSets/FirmwareGuestPatchResolution.swift b/VPhoneExecutable/VPhoneCommand/FirmwarePatcher/PatchSets/FirmwareGuestPatchResolution.swift
index 52847ca2..8dc6eb88 100644
--- a/VPhoneExecutable/VPhoneCommand/FirmwarePatcher/PatchSets/FirmwareGuestPatchResolution.swift
+++ b/VPhoneExecutable/VPhoneCommand/FirmwarePatcher/PatchSets/FirmwareGuestPatchResolution.swift
@@ -82,7 +82,7 @@ public enum FirmwareGuestPatchResolution {
.subtracting([FirmwareGuestSystemPatchSet.tvTPRO, FirmwareGuestSystemPatchSet.tvLegacySetup,
FirmwareGuestSystemPatchSet.tvSetupDisplayLookup, FirmwareGuestSystemPatchSet.tvSetupFocus,
FirmwareGuestSystemPatchSet.tvLocalActivation])
- .union([FirmwareGuestSystemPatchSet.homeViewSetupBypass])
+ .union([FirmwareGuestSystemPatchSet.homeViewProfileLookup, FirmwareGuestSystemPatchSet.homeViewDisplayLookups, FirmwareGuestSystemPatchSet.homeViewSetupBypass])
public static func unvalidatedHomeViewGuestPatches(enabled: Set<String>) -> [String] {
enabled.intersection(guestTargetIdentifiers).subtracting(homeViewSupportedGuestPatches).sorted()
diff --git a/VPhoneExecutable/VPhoneCommand/FirmwarePatcher/PatchSets/FirmwareGuestSystemPatchSet.swift b/VPhoneExecutable/VPhoneCommand/FirmwarePatcher/PatchSets/FirmwareGuestSystemPatchSet.swift
index 299d7d29..8fc8d144 100644
--- a/VPhoneExecutable/VPhoneCommand/FirmwarePatcher/PatchSets/FirmwareGuestSystemPatchSet.swift
+++ b/VPhoneExecutable/VPhoneCommand/FirmwarePatcher/PatchSets/FirmwareGuestSystemPatchSet.swift
@@ -51,6 +51,8 @@ public enum FirmwareGuestSystemPatchSet {
public static let locationdCohorting = "system-locationd-cfw-disable_auto_cohort"
public static let virtualBluetooth = "system-bluetoothd-cfw-btvc_le_connection"
public static let jetsamDisableAllowed = "system-jetsamproperties-cfw-disable_allowed"
+ public static let homeViewProfileLookup = "system-userprofilesd-exp-keybag_lookup"
+ public static let homeViewDisplayLookups = "system-breadboard-exp-mach_lookup"
public static let homeViewSetupBypass = "system-homeview-exp-setup_bypass"
public static let homeViewSetupPath = "/usr/share/vphone/HomeViewSetup.plist"
public static let tvTPRO = "system-dyld-exp-tv_tpro"
@@ -100,6 +102,20 @@ public enum FirmwareGuestSystemPatchSet {
target: .prebootDeviceTree,
applicability: ios27,
),
+ VPhonePatchDeclaration(
+ identifier: homeViewProfileLookup,
+ title: "HomeView guest profile keybag access",
+ summary: "Adds only the native Keybag/UserManager Mach service lookup to userprofilesd's temporary sandbox so its guest-profile request can reach the service on the older research kernel. Preserves authorization checks and original entitlements; reversible from backup.",
+ target: .guestExecutable(path: "/System/Library/PrivateFrameworks/UserProfilesDaemon.framework/Support/userprofilesd"),
+ applicability: VPhonePatchApplicability(iOSBase: .release(major: 27, minor: 2)),
+ ),
+ VPhonePatchDeclaration(
+ identifier: homeViewDisplayLookups,
+ title: "HomeView shell display access",
+ summary: "Adds backboard/frontboard Mach service lookup exceptions to BreadBoard's temporary sandbox for the older research kernel, preserving its existing entitlements. Keeps an executable backup for deselection.",
+ target: .guestExecutable(path: "/System/Library/CoreServices/BreadBoard.app/BreadBoard"),
+ applicability: VPhonePatchApplicability(iOSBase: .release(major: 27, minor: 2)),
+ ),
VPhonePatchDeclaration(
identifier: homeViewSetupBypass,
title: "HomeView setup bypass",
diff --git a/VPhoneExecutable/VPhoneCommand/FirmwarePatcher/PatchSets/FirmwarePatchSetCatalog.swift b/VPhoneExecutable/VPhoneCommand/FirmwarePatcher/PatchSets/FirmwarePatchSetCatalog.swift
index abc30da1..082be773 100644
--- a/VPhoneExecutable/VPhoneCommand/FirmwarePatcher/PatchSets/FirmwarePatchSetCatalog.swift
+++ b/VPhoneExecutable/VPhoneCommand/FirmwarePatcher/PatchSets/FirmwarePatchSetCatalog.swift
@@ -68,7 +68,7 @@ public enum FirmwarePatchSetCatalog {
Set(FirmwareKernelFridaPatchSet.manifest.patches.map(\.identifier))
.union(hypervisorConcealmentPatches)
.union(experimentalIdentityPatches)
- .union([FirmwareGuestSystemPatchSet.homeViewSetupBypass, FirmwareGuestSystemPatchSet.otaUserland, FirmwareGuestSystemPatchSet.homePodTopCap, FirmwareGuestSystemPatchSet.homePodSetupBypass, FirmwareGuestSystemPatchSet.homePodAudioProduct, FirmwareGuestSystemPatchSet.homePodWelcome, FirmwareGuestSystemPatchSet.homePodSiriSpeech, FirmwareGuestSystemPatchSet.homePodOTAUserland, FirmwareGuestSystemPatchSet.homePodSoundGlow, FirmwareGuestSystemPatchSet.homePodCryptexStaging, FirmwareGuestSystemPatchSet.homePodCryptexClass, FirmwareGuestSystemPatchSet.homePodAdHocInstall])
+ .union([FirmwareGuestSystemPatchSet.homeViewProfileLookup, FirmwareGuestSystemPatchSet.homeViewDisplayLookups, FirmwareGuestSystemPatchSet.homeViewSetupBypass, FirmwareGuestSystemPatchSet.otaUserland, FirmwareGuestSystemPatchSet.homePodTopCap, FirmwareGuestSystemPatchSet.homePodSetupBypass, FirmwareGuestSystemPatchSet.homePodAudioProduct, FirmwareGuestSystemPatchSet.homePodWelcome, FirmwareGuestSystemPatchSet.homePodSiriSpeech, FirmwareGuestSystemPatchSet.homePodOTAUserland, FirmwareGuestSystemPatchSet.homePodSoundGlow, FirmwareGuestSystemPatchSet.homePodCryptexStaging, FirmwareGuestSystemPatchSet.homePodCryptexClass, FirmwareGuestSystemPatchSet.homePodAdHocInstall])
.union([FirmwareKernelCustomFirmwarePatchSet.tvTPROPagers, misTrustAuthPatch, FirmwareGuestSystemPatchSet.settingsRootRows, FirmwareGuestSystemPatchSet.settingsSoftwareUpdate, FirmwareGuestSystemPatchSet.tvTPRO, FirmwareGuestSystemPatchSet.tvOTAUserland, FirmwareGuestSystemPatchSet.tvSetupDisplayLookup, FirmwareGuestSystemPatchSet.tvSetupFocus, FirmwareGuestSystemPatchSet.tvLocalActivation, FirmwareGuestSystemPatchSet.tvLegacySetup])
.union([FirmwareGuestSystemPatchSet.prebootFoldableProductId])
@@ -227,7 +227,7 @@ public enum FirmwarePatchSetCatalog {
freshly restored 26.4 guest does not survive. The HomePod-only top cap is off.
""",
patchSets: bundledReferences,
- selection: .block([FirmwareGuestSystemPatchSet.homeViewSetupBypass, FirmwareGuestSystemPatchSet.tvLegacySetup, FirmwareGuestSystemPatchSet.tvSetupDisplayLookup, FirmwareGuestSystemPatchSet.tvSetupFocus, FirmwareGuestSystemPatchSet.tvLocalActivation, FirmwareGuestSystemPatchSet.homePodTopCap, FirmwareGuestSystemPatchSet.homePodSetupBypass, FirmwareGuestSystemPatchSet.homePodAudioProduct, FirmwareGuestSystemPatchSet.homePodWelcome, FirmwareGuestSystemPatchSet.homePodSiriSpeech, FirmwareGuestSystemPatchSet.homePodOTAUserland, FirmwareGuestSystemPatchSet.homePodSoundGlow, FirmwareGuestSystemPatchSet.homePodCryptexStaging, FirmwareGuestSystemPatchSet.homePodCryptexClass, FirmwareGuestSystemPatchSet.homePodAdHocInstall]),
+ selection: .block([FirmwareGuestSystemPatchSet.homeViewProfileLookup, FirmwareGuestSystemPatchSet.homeViewDisplayLookups, FirmwareGuestSystemPatchSet.homeViewSetupBypass, FirmwareGuestSystemPatchSet.tvLegacySetup, FirmwareGuestSystemPatchSet.tvSetupDisplayLookup, FirmwareGuestSystemPatchSet.tvSetupFocus, FirmwareGuestSystemPatchSet.tvLocalActivation, FirmwareGuestSystemPatchSet.homePodTopCap, FirmwareGuestSystemPatchSet.homePodSetupBypass, FirmwareGuestSystemPatchSet.homePodAudioProduct, FirmwareGuestSystemPatchSet.homePodWelcome, FirmwareGuestSystemPatchSet.homePodSiriSpeech, FirmwareGuestSystemPatchSet.homePodOTAUserland, FirmwareGuestSystemPatchSet.homePodSoundGlow, FirmwareGuestSystemPatchSet.homePodCryptexStaging, FirmwareGuestSystemPatchSet.homePodCryptexClass, FirmwareGuestSystemPatchSet.homePodAdHocInstall]),
)
/// The iOS payloads, hooks and shared-cache patches an Apple TV guest has no
@@ -343,7 +343,7 @@ public enum FirmwarePatchSetCatalog {
patchSets: bundledReferences,
selection: .block(
manualOnlyPatches
- .subtracting([FirmwareGuestSystemPatchSet.tvOTAUserland])
+ .subtracting([FirmwareGuestSystemPatchSet.tvOTAUserland, FirmwareGuestSystemPatchSet.homeViewDisplayLookups, FirmwareGuestSystemPatchSet.homeViewProfileLookup])
.union(tvOSBlockedPatches.subtracting(["system-extensions-boot-gpu_bundle"]).subtracting(tvOS27UserlandPatches)),
),
)
diff --git a/VPhoneExecutable/VPhoneCommand/FirmwarePatcherTests/PatchSets/FirmwareGuestPatchResolutionTests.swift b/VPhoneExecutable/VPhoneCommand/FirmwarePatcherTests/PatchSets/FirmwareGuestPatchResolutionTests.swift
index 2e67e94c..6041e09e 100644
--- a/VPhoneExecutable/VPhoneCommand/FirmwarePatcherTests/PatchSets/FirmwareGuestPatchResolutionTests.swift
+++ b/VPhoneExecutable/VPhoneCommand/FirmwarePatcherTests/PatchSets/FirmwareGuestPatchResolutionTests.swift
@@ -17,6 +17,8 @@ struct FirmwareGuestPatchResolutionTests {
preset: FirmwarePatchSetCatalog.homeViewPreset, patchSets: FirmwarePatchSetCatalog.bundled,
iOSBase: VPhoneVersion("27.2"), cloudOS: VPhoneVersion("26.4")
)
+ #expect(plan.isEnabled(FirmwareGuestSystemPatchSet.homeViewProfileLookup))
+ #expect(plan.isEnabled(FirmwareGuestSystemPatchSet.homeViewDisplayLookups))
#expect(plan.isEnabled(FirmwareGuestSystemPatchSet.tvOTAUserland))
#expect(plan.isEnabled("system-extensions-boot-gpu_bundle"))
#expect(!plan.isEnabled(FirmwareGuestSystemPatchSet.homeViewSetupBypass))
diff --git a/VPhoneExecutable/VPhoneCommand/FirmwarePatcherTests/PatchSets/FirmwarePatchSetCatalogTests.swift b/VPhoneExecutable/VPhoneCommand/FirmwarePatcherTests/PatchSets/FirmwarePatchSetCatalogTests.swift
index 0f0a6952..225fc511 100644
--- a/VPhoneExecutable/VPhoneCommand/FirmwarePatcherTests/PatchSets/FirmwarePatchSetCatalogTests.swift
+++ b/VPhoneExecutable/VPhoneCommand/FirmwarePatcherTests/PatchSets/FirmwarePatchSetCatalogTests.swift
@@ -255,6 +255,8 @@ struct FirmwarePatchSetCatalogTests {
)
let applicableManual = Set(FirmwarePatchSetCatalog.allDeclarations.filter {
FirmwarePatchSetCatalog.manualOnlyPatches.contains($0.identifier)
+ && $0.identifier != FirmwareGuestSystemPatchSet.homeViewProfileLookup
+ && $0.identifier != FirmwareGuestSystemPatchSet.homeViewDisplayLookups
&& $0.identifier != FirmwareGuestSystemPatchSet.homeViewSetupBypass
&& $0.identifier != FirmwareGuestSystemPatchSet.homePodTopCap
&& $0.identifier != FirmwareGuestSystemPatchSet.homePodSetupBypass
diff --git a/VPhoneExecutable/VPhoneCommand/VPhoneCommand/Firmware/VPhoneCustomFirmwareInstaller.swift b/VPhoneExecutable/VPhoneCommand/VPhoneCommand/Firmware/VPhoneCustomFirmwareInstaller.swift
index f486f8d9..d942f556 100644
--- a/VPhoneExecutable/VPhoneCommand/VPhoneCommand/Firmware/VPhoneCustomFirmwareInstaller.swift
+++ b/VPhoneExecutable/VPhoneCommand/VPhoneCommand/Firmware/VPhoneCustomFirmwareInstaller.swift
@@ -223,6 +223,12 @@ struct VPhoneCustomFirmwareInstaller {
if effectiveEnabled.contains(FirmwareGuestSystemPatchSet.tvSetupFocus), device.family != .appleTV {
throw ValidationError("The TV setup focus adapter is supported only for an Apple TV guest.")
}
+ if effectiveEnabled.contains(FirmwareGuestSystemPatchSet.homeViewProfileLookup), device.family != .homeView {
+ throw ValidationError("HomeView guest-profile keybag access requires a HomeView guest.")
+ }
+ if effectiveEnabled.contains(FirmwareGuestSystemPatchSet.homeViewDisplayLookups), device.family != .homeView {
+ throw ValidationError("BreadBoard display access is supported only for a HomeView guest.")
+ }
if effectiveEnabled.contains(FirmwareGuestSystemPatchSet.homeViewSetupBypass), device.family != .homeView {
throw ValidationError("The HomeView setup bypass is supported only for a HomeView guest.")
}
@@ -2122,6 +2128,40 @@ struct VPhoneCustomFirmwareInstaller {
}
}
+ let homeViewDisplay = FirmwareGuestSystemPatchSet.homeViewDisplayLookups
+ isolate([homeViewDisplay]) {
+ let bundle = "System/Library/CoreServices/BreadBoard.app"
+ let executable = "\(bundle)/BreadBoard"
+ if on(homeViewDisplay), guestDevice.family == .homeView {
+ try patchHomeViewMachLookups(system: system, work: work, target: executable,
+ services: CustomFirmwareMachLookupExceptions.services, backupSafe: backupSafe(homeViewDisplay))
+ try sealGuestBundle(system: system, bundle: bundle, preserveEntitlements: true)
+ live.insert(homeViewDisplay)
+ } else if priorGuest.contains(homeViewDisplay) {
+ guard try revertMachO(system: system, work: work, path: executable, bundle: bundle, preserveEntitlements: true) else {
+ live.insert(homeViewDisplay)
+ throw ValidationError("BreadBoard has no executable backup; cannot restore its original entitlements.")
+ }
+ print(" [+] \(homeViewDisplay): restored BreadBoard from backup")
+ }
+ }
+
+ let homeViewProfile = FirmwareGuestSystemPatchSet.homeViewProfileLookup
+ isolate([homeViewProfile]) {
+ let executable = "System/Library/PrivateFrameworks/UserProfilesDaemon.framework/Support/userprofilesd"
+ if on(homeViewProfile), guestDevice.family == .homeView {
+ try patchHomeViewMachLookups(system: system, work: work, target: executable,
+ services: ["com.apple.mobile.keybagd.UserManager.xpc"], backupSafe: backupSafe(homeViewProfile))
+ live.insert(homeViewProfile)
+ } else if priorGuest.contains(homeViewProfile) {
+ guard try revertMachO(system: system, work: work, path: executable) else {
+ live.insert(homeViewProfile)
+ throw ValidationError("userprofilesd has no executable backup; cannot restore its original entitlements.")
+ }
+ print(" [+] \(homeViewProfile): restored userprofilesd from backup")
+ }
+ }
+
let tvLegacySetup = FirmwareGuestSystemPatchSet.tvLegacySetup
let tvSetupFlags = CustomFirmwareTVSetup.relativePath
isolate([tvLegacySetup]) {
@@ -3987,6 +4027,23 @@ struct VPhoneCustomFirmwareInstaller {
/// Returns whether the patch was applied (false when Campo or its
/// entitlements are absent, so the caller does not record it live).
@discardableResult
+ /// BreadBoard 27.2 traps in BKSDisplayServicesStart under the 26.4
+ /// temporary-sandbox profile; userprofilesd also lacks its keybag lookup.
+ /// Merge only the selected service names and retain donor entitlements.
+ private func patchHomeViewMachLookups(system: VPhoneConfinedDirectory, work: WorkDirectory, target: String, services: [String], backupSafe: Bool) throws {
+ let name = (target as NSString).lastPathComponent
+ guard let staged = try stageOptional(target, from: system, work: work, label: name),
+ let source = try VPhoneSigner.entitlements(ofFileAt: staged).first(where: { !$0.isEmpty }) else {
+ throw ValidationError("HomeView service access requires \(name) and its original entitlements.")
+ }
+ let entitlements = work.file("\(name).entitlements")
+ try source.write(to: entitlements)
+ try CustomFirmwareMachLookupExceptions.merge(at: entitlements, services: services)
+ try backupEntitlementTarget(target, in: system, backupSafe: backupSafe)
+ try VPhoneSigner.sign(fileAt: staged, options: .init(entitlements: Data(contentsOf: entitlements), style: .appleAdHoc))
+ try system.replaceFile(target, fromFileAt: staged, mode: 0o755, owner: Self.guestOwner)
+ }
+
private func patchCampo(system: VPhoneConfinedDirectory, work: WorkDirectory, backupSafe: Bool) throws -> Bool {
let target = "Applications/Campo.app/Campo"
guard let staged = try stageOptional(target, from: system, work: work, label: "Campo") else { return false }
diff --git a/VPhoneExecutable/VPhoneVirtualization/Resources/patches_presets/experimental.plist b/VPhoneExecutable/VPhoneVirtualization/Resources/patches_presets/experimental.plist
index 745f4d87..95fe8bad 100644
--- a/VPhoneExecutable/VPhoneVirtualization/Resources/patches_presets/experimental.plist
+++ b/VPhoneExecutable/VPhoneVirtualization/Resources/patches_presets/experimental.plist
@@ -93,6 +93,8 @@
<string>Block</string>
<key>Patches</key>
<array>
+ <string>system-userprofilesd-exp-keybag_lookup</string>
+ <string>system-breadboard-exp-mach_lookup</string>
<string>system-homeview-exp-setup_bypass</string>
<string>system-homepod-exp-top_cap</string>
<string>system-setupbackground-exp-pineboard_lookup</string>
diff --git a/VPhoneExecutable/VPhoneVirtualization/Resources/patches_presets/homepod-mini.plist b/VPhoneExecutable/VPhoneVirtualization/Resources/patches_presets/homepod-mini.plist
index 62a49b6a..a83e1fca 100644
--- a/VPhoneExecutable/VPhoneVirtualization/Resources/patches_presets/homepod-mini.plist
+++ b/VPhoneExecutable/VPhoneVirtualization/Resources/patches_presets/homepod-mini.plist
@@ -73,6 +73,8 @@
<string>Block</string>
<key>Patches</key>
<array>
+ <string>system-userprofilesd-exp-keybag_lookup</string>
+ <string>system-breadboard-exp-mach_lookup</string>
<string>system-homeview-exp-setup_bypass</string>
<string>system-exp-ota_userland</string>
<string>kernel-exp-frida_thread_set_state_entitlement_flag</string>
diff --git a/VPhoneExecutable/VPhoneVirtualization/Resources/patches_presets/standard.plist b/VPhoneExecutable/VPhoneVirtualization/Resources/patches_presets/standard.plist
index 3f05bdfb..697fffe0 100644
--- a/VPhoneExecutable/VPhoneVirtualization/Resources/patches_presets/standard.plist
+++ b/VPhoneExecutable/VPhoneVirtualization/Resources/patches_presets/standard.plist
@@ -73,6 +73,8 @@
<string>Block</string>
<key>Patches</key>
<array>
+ <string>system-userprofilesd-exp-keybag_lookup</string>
+ <string>system-breadboard-exp-mach_lookup</string>
<string>system-homeview-exp-setup_bypass</string>
<string>system-homepod-exp-top_cap</string>
<string>system-homepod-exp-setup_bypass</string>
diff --git a/VPhoneExecutable/VPhoneVirtualization/Resources/patches_presets/tvos-4k.plist b/VPhoneExecutable/VPhoneVirtualization/Resources/patches_presets/tvos-4k.plist
index 88f1b983..dac49df7 100644
--- a/VPhoneExecutable/VPhoneVirtualization/Resources/patches_presets/tvos-4k.plist
+++ b/VPhoneExecutable/VPhoneVirtualization/Resources/patches_presets/tvos-4k.plist
@@ -73,6 +73,8 @@
<string>Block</string>
<key>Patches</key>
<array>
+ <string>system-userprofilesd-exp-keybag_lookup</string>
+ <string>system-breadboard-exp-mach_lookup</string>
<string>system-homeview-exp-setup_bypass</string>
<string>system-tv-exp-legacy_setup</string>
<string>system-homepod-exp-top_cap</string>
diff --git a/VPhoneExecutable/VPhoneVirtualization/Resources/patches_presets/tvos.plist b/VPhoneExecutable/VPhoneVirtualization/Resources/patches_presets/tvos.plist
index 1897dbeb..c1b1cd15 100644
--- a/VPhoneExecutable/VPhoneVirtualization/Resources/patches_presets/tvos.plist
+++ b/VPhoneExecutable/VPhoneVirtualization/Resources/patches_presets/tvos.plist
@@ -73,6 +73,8 @@
<string>Block</string>
<key>Patches</key>
<array>
+ <string>system-userprofilesd-exp-keybag_lookup</string>
+ <string>system-breadboard-exp-mach_lookup</string>
<string>system-homeview-exp-setup_bypass</string>
<string>system-homepod-exp-top_cap</string>
<string>system-homepod-exp-setup_bypass</string>
diff --git a/VPhoneExecutable/VPhoneVirtualization/UI/UserInterface/VPhoneVirtualMachineWindowController.swift b/VPhoneExecutable/VPhoneVirtualization/UI/UserInterface/VPhoneVirtualMachineWindowController.swift
index 608c19f0..372f6c4c 100644
--- a/VPhoneExecutable/VPhoneVirtualization/UI/UserInterface/VPhoneVirtualMachineWindowController.swift
+++ b/VPhoneExecutable/VPhoneVirtualization/UI/UserInterface/VPhoneVirtualMachineWindowController.swift
@@ -10,6 +10,7 @@ class VPhoneVirtualMachineWindowController: NSObject, NSWindowDelegate {
private weak var virtualMachineView: VPhoneVirtualMachineView?
private(set) var homePodDisplayView: VPhoneHomePodDisplayView?
private var homePodGuest = false
+ private var usesTVOS = false
private(set) var touchIDMonitor: VPhoneTouchIDMonitor?
private var homeButton: NSButton?
private var foldButton: NSButton?
@@ -47,10 +48,12 @@ class VPhoneVirtualMachineWindowController: NSObject, NSWindowDelegate {
name: String,
sceneIdentifier: String,
homePodGuest: Bool = false,
+ usesTVOS: Bool = false,
foldableGuest: Bool = false,
) {
self.control = control
self.homePodGuest = homePodGuest
+ self.usesTVOS = usesTVOS
self.foldableGuest = foldableGuest
machineDirectory = URL(fileURLWithPath: sceneIdentifier)
homeButton = nil
@@ -471,7 +474,7 @@ class VPhoneVirtualMachineWindowController: NSObject, NSWindowDelegate {
var parts: [String] = []
if control.isConnected {
if let version = control.guestIOSVersion, !version.isEmpty {
- let osName = homePodGuest ? "HomePod" : homeButtonHoldsInGuest ? "tvOS" : "iOS"
+ let osName = homePodGuest ? "HomePod" : usesTVOS ? "tvOS" : "iOS"
parts.append("\(osName) \(version)")
}
if let address = control.guestIPAddress, !address.isEmpty {
diff --git a/VPhoneExecutable/VPhoneVirtualization/UI/VPhoneVirtualMachineAppDelegate.swift b/VPhoneExecutable/VPhoneVirtualization/UI/VPhoneVirtualMachineAppDelegate.swift
index 4f562897..61eeac69 100644
--- a/VPhoneExecutable/VPhoneVirtualization/UI/VPhoneVirtualMachineAppDelegate.swift
+++ b/VPhoneExecutable/VPhoneVirtualization/UI/VPhoneVirtualMachineAppDelegate.swift
@@ -180,6 +180,7 @@ class VPhoneVirtualMachineAppDelegate: NSObject, NSApplicationDelegate {
.resolvingSymlinksInPath()
.path,
homePodGuest: options.isHomePodGuest,
+ usesTVOS: options.usesTVOS,
foldableGuest: options.isFoldableGuest,
)
wc.captureView?.escapeIsBackGesture = !options.isPadGuest && !options.isTVGuest