Run a virtual iPhone on an Apple Silicon Mac.
Swift
Drop the passcode caveat from Unlock at Startup
Jackyc6574d288dc8
diff --git a/Research/Guest/screen_unlock.md b/Research/Guest/screen_unlock.mdindex db4c49f3..1f74b5e9 100644--- a/Research/Guest/screen_unlock.md+++ b/Research/Guest/screen_unlock.md@@ -87,9 +87,9 @@ Settings) has `vphone-vm` call `screen.unlock` with a 60 s timeout when avphoned that has just started connects. vphoned's `/v1/health` carries`instance`, a UUID made when it starts; the host keeps the last one it sawacross disconnects, so a probe that drops and reconnects to the same vphoned-is not unlocked again. A guest still in Setup Assistant is skipped, and a-passcode guest stays locked (the call refuses without a passcode, and none is-stored).+is not unlocked again. A guest still in Setup Assistant is skipped. A vphone guest cannot have a+passcode (see "Why a passcode cannot be set" below), so the setting never+meets one.Measured on 2026-10-04 on `autounlock-iphone` (iPhone17,3, iOS 27.0 24A435,no passcode, Auto-Lock 1 minute), bundle 2.6.0-local:@@ -172,11 +172,10 @@ cannot be made, and `screen.unlock`'s passcode path cannot be run.## Not yet measured-- **Passcode guests.** Setting a passcode on a research guest is not- automated, so the Home-raises-the-pad-then-type path is unrun. It is written- to the behavior of a real device (Home/menu raises passcode entry); treat it- as untested until a passcode guest is available.-- iPadOS, and iOS 27.0.1 (its guests kernel-panic at first boot, separate+- **Passcode guests.** vphone does not support a passcode (see "Why a+ passcode cannot be set" above), so the Home-raises-the-pad-then-type path+ cannot be run. It is written to the behavior of a real device.+- iOS 27.0.1 (its guests kernel-panic at first boot, separateissue).## Reproducingdiff --git a/Research/vphoned_http_api.md b/Research/vphoned_http_api.mdindex 022f5633..d92affcf 100644--- a/Research/vphoned_http_api.md+++ b/Research/vphoned_http_api.md@@ -337,8 +337,7 @@ the Startup section of a machine's Settings in Launchpad) has `vphone-vm` callconnects. `/v1/health` carries `instance`, a UUID vphoned makes when it starts,so the host tells a start (guest boot, userspace reboot, a vphoned update) froma probe it lost and found again; only a new instance is unlocked. A guest still-in Setup Assistant is left alone, and a guest with a passcode stays locked: the-passcode is never stored.+in Setup Assistant is left alone.`time.timezone` (capability `timezone`; REST `GET/PUT /v1/timezone`) returns`{identifier, automatic, seconds_from_gmt}`: the Olson namediff --git a/VPhoneExecutable/VPhoneCommand/VPhoneCommand/VirtualMachine/VPhoneVirtualMachineCommand.swift b/VPhoneExecutable/VPhoneCommand/VPhoneCommand/VirtualMachine/VPhoneVirtualMachineCommand.swiftindex 5166debe..c97680ff 100644--- a/VPhoneExecutable/VPhoneCommand/VPhoneCommand/VirtualMachine/VPhoneVirtualMachineCommand.swift+++ b/VPhoneExecutable/VPhoneCommand/VPhoneCommand/VirtualMachine/VPhoneVirtualMachineCommand.swift@@ -231,8 +231,8 @@ struct VPhoneVirtualMachineConfigCommand: ParsableCommand {--mac-name off withdraws it. Applied each time vphone-vm connects to the guest.--unlock-at-startup on has vphone-vm wake the guest and dismiss its Lock Screen each time \- vphoned starts in it: after the VM starts and after the guest reboots. A guest with a \- passcode stays locked; the passcode is never stored. Applies from the next connect.+ vphoned starts in it: after the VM starts and after the guest reboots. Applies from the \+ next connect.""",)diff --git a/VPhoneExecutable/VPhoneVirtualization/Resources/Localizable.xcstrings b/VPhoneExecutable/VPhoneVirtualization/Resources/Localizable.xcstringsindex 1c716a11..4c4c260c 100644--- a/VPhoneExecutable/VPhoneVirtualization/Resources/Localizable.xcstrings+++ b/VPhoneExecutable/VPhoneVirtualization/Resources/Localizable.xcstrings@@ -207,37 +207,37 @@}}},- "Wake the guest and dismiss its Lock Screen each time it starts. A guest with a passcode stays locked." : {+ "Wake the guest and dismiss its Lock Screen each time it starts." : {"extractionState" : "manual","localizations" : {"en" : {"stringUnit" : {"state" : "translated",- "value" : "Wake the guest and dismiss its Lock Screen each time it starts. A guest with a passcode stays locked."+ "value" : "Wake the guest and dismiss its Lock Screen each time it starts."}},"ja" : {"stringUnit" : {"state" : "translated",- "value" : "ゲストが起動するたびに画面をスリープ解除し、ロック画面を閉じます。パスコードを設定したゲストはロックされたままです。"+ "value" : "ゲストが起動するたびに画面をスリープ解除し、ロック画面を閉じます。"}},"ko" : {"stringUnit" : {"state" : "translated",- "value" : "게스트가 시작될 때마다 화면을 깨우고 잠금 화면을 닫습니다. 암호가 설정된 게스트는 잠긴 상태로 유지됩니다."+ "value" : "게스트가 시작될 때마다 화면을 깨우고 잠금 화면을 닫습니다."}},"vi" : {"stringUnit" : {"state" : "translated",- "value" : "Đánh thức máy khách và đóng Màn hình khóa mỗi khi khởi động. Máy khách có mật mã vẫn bị khóa."+ "value" : "Đánh thức máy khách và đóng Màn hình khóa mỗi khi khởi động."}},"zh-Hans" : {"stringUnit" : {"state" : "translated",- "value" : "客户机每次启动时唤醒屏幕并关闭锁定屏幕。设有密码的客户机仍保持锁定。"+ "value" : "客户机每次启动时唤醒屏幕并关闭锁定屏幕。"}}}diff --git a/VPhoneExecutable/VPhoneVirtualization/UI/GuestCommunication/VPhoneGuestControlSystem.swift b/VPhoneExecutable/VPhoneVirtualization/UI/GuestCommunication/VPhoneGuestControlSystem.swiftindex fb49a6cf..94cf09fc 100644--- a/VPhoneExecutable/VPhoneVirtualization/UI/GuestCommunication/VPhoneGuestControlSystem.swift+++ b/VPhoneExecutable/VPhoneVirtualization/UI/GuestCommunication/VPhoneGuestControlSystem.swift@@ -63,8 +63,7 @@ extension VPhoneGuestControl {/// Wakes a guest whose vphoned has just started and dismisses its Lock/// Screen through `screen.unlock`. vphoned can come up well before/// SpringBoard on a cold boot; the method waits for SpringBoard itself, so- /// it is given the longest timeout it takes. A guest with a passcode- /// refuses without one and stays locked: the passcode is never stored.+ /// it is given the longest timeout it takes.////// SpringBoard can still read "unlocked, lit" after it reports that it has/// started, before it raises the Lock Screen, and `screen.unlock` then hasdiff --git a/VPhoneExecutable/VPhoneVirtualization/UI/UserInterface/Menu/VPhoneMenuDevice.swift b/VPhoneExecutable/VPhoneVirtualization/UI/UserInterface/Menu/VPhoneMenuDevice.swiftindex db83d5c8..4249bfe3 100644--- a/VPhoneExecutable/VPhoneVirtualization/UI/UserInterface/Menu/VPhoneMenuDevice.swift+++ b/VPhoneExecutable/VPhoneVirtualization/UI/UserInterface/Menu/VPhoneMenuDevice.swift@@ -108,7 +108,7 @@ extension VPhoneMenuController {let unlockItem = makeItem("Unlock at Startup", action: #selector(toggleUnlockAtStartup), symbol: "lock.open")unlockItem.state = control.unlocksAtStartup ? .on : .offunlockItem.toolTip = VPhoneLocalization.text(- "Wake the guest and dismiss its Lock Screen each time it starts. A guest with a passcode stays locked.",+ "Wake the guest and dismiss its Lock Screen each time it starts.",)unlockAtStartupItem = unlockItemmenu.addItem(unlockItem)diff --git a/VPhoneLaunchpad/VPhoneLaunchpad/Localizable.xcstrings b/VPhoneLaunchpad/VPhoneLaunchpad/Localizable.xcstringsindex d3fbdc5b..a4902ba5 100644--- a/VPhoneLaunchpad/VPhoneLaunchpad/Localizable.xcstrings+++ b/VPhoneLaunchpad/VPhoneLaunchpad/Localizable.xcstrings@@ -13051,13 +13051,13 @@"zh-Hans" : { "stringUnit" : { "state" : "translated", "value" : "启动时解锁" } }}},- "Each time the guest starts, its screen is turned on and the Lock Screen dismissed. A guest with a passcode stays locked." : {+ "Each time the guest starts, its screen is turned on and the Lock Screen dismissed." : {"localizations" : {- "en" : { "stringUnit" : { "state" : "translated", "value" : "Each time the guest starts, its screen is turned on and the Lock Screen dismissed. A guest with a passcode stays locked." } },- "ja" : { "stringUnit" : { "state" : "translated", "value" : "ゲストが起動するたびに画面をオンにし、ロック画面を閉じます。パスコードを設定したゲストはロックされたままです。" } },- "ko" : { "stringUnit" : { "state" : "translated", "value" : "게스트가 시작될 때마다 화면을 켜고 잠금 화면을 닫습니다. 암호가 설정된 게스트는 잠긴 상태로 유지됩니다." } },- "vi" : { "stringUnit" : { "state" : "translated", "value" : "Mỗi khi máy khách khởi động, màn hình được bật và Màn hình khóa được đóng. Máy khách có mật mã vẫn bị khóa." } },- "zh-Hans" : { "stringUnit" : { "state" : "translated", "value" : "客户机每次启动时点亮屏幕并关闭锁定屏幕。设有密码的客户机仍保持锁定。" } }+ "en" : { "stringUnit" : { "state" : "translated", "value" : "Each time the guest starts, its screen is turned on and the Lock Screen dismissed." } },+ "ja" : { "stringUnit" : { "state" : "translated", "value" : "ゲストが起動するたびに画面をオンにし、ロック画面を閉じます。" } },+ "ko" : { "stringUnit" : { "state" : "translated", "value" : "게스트가 시작될 때마다 화면을 켜고 잠금 화면을 닫습니다." } },+ "vi" : { "stringUnit" : { "state" : "translated", "value" : "Mỗi khi máy khách khởi động, màn hình được bật và Màn hình khóa được đóng." } },+ "zh-Hans" : { "stringUnit" : { "state" : "translated", "value" : "客户机每次启动时点亮屏幕并关闭锁定屏幕。" } }}},"%@ (Default)" : {diff --git a/VPhoneLaunchpad/VPhoneLaunchpad/Machines/VPhoneLaunchpadMachineSheets.swift b/VPhoneLaunchpad/VPhoneLaunchpad/Machines/VPhoneLaunchpadMachineSheets.swiftindex 6085e2b9..f4e2f799 100644--- a/VPhoneLaunchpad/VPhoneLaunchpad/Machines/VPhoneLaunchpadMachineSheets.swift+++ b/VPhoneLaunchpad/VPhoneLaunchpad/Machines/VPhoneLaunchpadMachineSheets.swift@@ -148,7 +148,7 @@ struct VPhoneLaunchpadMachineSettingsView: View {} header: {Text("Startup")} footer: {- Text("Each time the guest starts, its screen is turned on and the Lock Screen dismissed. A guest with a passcode stays locked.")+ Text("Each time the guest starts, its screen is turned on and the Lock Screen dismissed.").foregroundStyle(.secondary)}}