futureware-tech/Launch iOS Simulator
Launch an iOS Simulator (and shut it down once the job completes)
View on GitHubTrust Signals
- Scorecard Score
- not yet scored
- Maintenance Recency
- Activelast commit Apr 9, 2026
- License
- MIT
Pinned Snippet
uses: futureware-tech/simulator-action@e89aa8f93d3aec35083ff49d2854d07f7186f7f5 # v5tags can be moved; commit SHAs can't. why a SHA?
Inputs
| name | description | required | default |
|---|---|---|---|
| model | Simulator device model name (e.g. 'iPhone 8' ) | no | — |
| os | OS type (supported: 'iOS', 'watchOS' and 'tvOS') | no | — |
| os_version | OS version requirement in semver format (e.g. '^14.4') | no | — |
| udid | Specific UDID of the device to start. If UDID is specified along with OS and/or model, the action fails if the device with this UDID does not match specified constraints | no | — |
| erase_before_boot | Whether the Simulator data should be erased before booting | yes | true |
| wait_for_boot | Whether the action must wait for the Simulator to finish booting requested image | no | false |
| boot_timeout_seconds | Maximum number of seconds to wait for the Simulator to finish booting. Use 0 to disable the timeout. | no | 360 |
| boot_retries | Number of times to retry booting when waiting for the Simulator to finish booting fails. | no | 3 |
| shutdown_after_job | Whether the Simulator should be shut down after the job has finished. This is mostly relevant when e.g. running on self-hosted actions where the host OS and therefore Simulator will continue running after the job is finished | yes | true |
Outputs
| name | description |
|---|---|
| udid | UDID of the launched device, for use with e.g. xcrun command |