iOS Simulator: Launch
ios_simulator_launchLaunch an installed iOS app on a chosen simulator, pass launch arguments for fixture or demo mode, and capture stdout/stderr to diagnose crashes at startup.
Instructions
Launch an installed app. Pass arguments to put it into a fixture or demo mode — that is what IOS_SIMULATOR_LAUNCH_ARGS sets as the default for every launch that does not override it. Standard output and error are captured to files under the output directory, so an app that dies on launch leaves something readable behind.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| device | No | Which simulator: its UDID or its name as shown by ios_simulator_list. Omit it when exactly one is booted — that is the normal case, and IOS_SIMULATOR_ID pins it when it is not. Unlike simctl's own `booted`, this never picks arbitrarily between two. | |
| arguments | No | Launch arguments, e.g. ["-DemoMode", "YES"]. Overrides IOS_SIMULATOR_LAUNCH_ARGS rather than adding to it. | |
| bundle_id | Yes | The app's bundle identifier, e.g. "io.mgcrea.Canopy". List them with ios_simulator_list_apps. | |
| terminate_first | No | Replace a running copy rather than attaching to it. On by default so a launch means a fresh process and a predictable first screen. |