You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
Repository navigation
Commit 800da9a
Browse filesBrowse the repository at this point in the historyBrowse files
fix(ios): give boot a --timeout startup budget (#3004)
The first boot of a never-booted Simulator runs Apple's first-boot
migration, which can take minutes, but `boot`'s fixed 90s client
envelope and 120s daemon-side boot wait had no way to raise it.
- `boot --timeout <ms>` is a daemon-side startup budget, mirroring
open/prepare (#2325): the client envelope keeps a 30s margin over it
so the daemon's own `boot_timeout` result wins the race, and the
budget reaches the Simulator boot wait as an absolute deadline.
- Expiry fails with `error.details.reason: boot_timeout` and leaves
the Simulator booting, so a retry finds it further along.
Closes#3004
'Open/Prepare: startup budget covering the Simulator boot (and runner preparation for prepare). Replay/Snapshot/Test: maximum wall-clock time for the command or attempt. With --settle: the settle-wait deadline (default 10s)',
88
+
'Boot/Open/Prepare: startup budget covering the Simulator boot (and runner preparation for prepare). Replay/Snapshot/Test: maximum wall-clock time for the command or attempt. With --settle: the settle-wait deadline (default 10s)',
'Boot or prepare the selected device or simulator so later commands can target it. The device is chosen through the device-selection inputs, not by naming it here.',
78
79
{
79
80
headless: booleanField('Boot without showing simulator UI when supported.'),
81
+
timeoutMs: integerField(
82
+
'Startup budget in milliseconds. Bounds the Simulator boot wait, so a never-booted Simulator can finish its first-boot migration; omit for the default startup behavior.',
Copy file name to clipboardExpand all lines: website/docs/docs/commands.md
+1Lines changed: 1 addition & 0 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -69,6 +69,7 @@ agent-device fold open
69
69
-`--platform apple` is an alias for the Apple automation backend (`ios`, `tvOS`, `macOS` selection).
70
70
- Use `--target mobile|tv|desktop` with `--platform` (required) to select phone/tablet vs TV-class vs desktop-class targets.
71
71
-`boot` is mainly needed when starting a new session and `open` fails because no booted simulator/emulator is available.
72
+
-`boot --timeout <ms>` is a startup budget for the Simulator boot, same as `open`'s. A never-booted iOS Simulator runs Apple's first-boot migration, which can take several minutes; without the flag the boot wait is capped at 120 seconds. When the budget runs out the command fails with `error.details.reason: boot_timeout` and the Simulator keeps booting, so a retry finds it further along.
72
73
- Android: `boot --platform android --device <avd-name>` launches that emulator in GUI mode when needed.
73
74
- Android: add `--headless` to launch without opening a GUI window.
0 commit comments