Skip to content

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.md
index 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 a
vphoned that has just started connects. vphoned's `/v1/health` carries
`instance`, a UUID made when it starts; the host keeps the last one it saw
across 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, separate
issue).
## Reproducing
diff --git a/Research/vphoned_http_api.md b/Research/vphoned_http_api.md
index 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` call
connects. `/v1/health` carries `instance`, a UUID vphoned makes when it starts,
so the host tells a start (guest boot, userspace reboot, a vphoned update) from
a 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 name
diff --git a/VPhoneExecutable/VPhoneCommand/VPhoneCommand/VirtualMachine/VPhoneVirtualMachineCommand.swift b/VPhoneExecutable/VPhoneCommand/VPhoneCommand/VirtualMachine/VPhoneVirtualMachineCommand.swift
index 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.xcstrings
index 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.swift
index 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 has
diff --git a/VPhoneExecutable/VPhoneVirtualization/UI/UserInterface/Menu/VPhoneMenuDevice.swift b/VPhoneExecutable/VPhoneVirtualization/UI/UserInterface/Menu/VPhoneMenuDevice.swift
index 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 : .off
unlockItem.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 = unlockItem
menu.addItem(unlockItem)
diff --git a/VPhoneLaunchpad/VPhoneLaunchpad/Localizable.xcstrings b/VPhoneLaunchpad/VPhoneLaunchpad/Localizable.xcstrings
index 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.swift
index 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)
}
}