This GitHub Action helps you start an iOS (tvOS, watchOS) Simulator inside the workflow you are running. It runs equally well on GitHub runners as well as self-hosted runners.
steps:
- uses: actions/checkout@v4
- uses: futureware-tech/simulator-action@v4
with:
model: 'iPhone 8'
- run: flutter driveMost inputs are dedicated to refine the selection of device you'd like to launch. However, launching a device requires having a profile -- something which is either preinstalled or needs an Apple ID to download. Since it's unlikely that you'll trust your CI with an Apple ID, it's easier to select one of the preinstalled profiles.
For GitHub Actions runners, a fresh list of devices is maintained in the
Wiki of this
project. Note that UDID and OS version can be rather volatile and may change
when Mac OS updates, so it's recommended to stay with only specifying the model
or if you really need OS version, leave it on the loose side (e.g.
os_version: ">=14.0"). The UDIDs on that page also cannot be used to register
a device with Apple Developer account, because a Simulator UDID
can not be used there.
| Name | Sample values | Description |
|---|---|---|
model |
iPhone 8 |
Model of the device you'd like to launch |
os |
iOS, tvOS, watchOS |
OS type of the device |
os_version |
>=14.0 |
OS version specification in semver format |
udid |
ABCD-EFGH |
Specific UDID you'd like to launch |
erase_before_boot |
true |
Whether the data should be erased from device before boot. Starting from a clean state helps getting a stable environment for tests |
wait_for_boot |
false |
Whether the action must wait for the Simulator to finish booting requested image |
shutdown_after_job |
true |
Whether to shutdown the launched Simulator after the workflow job has been finished |
| Name | Sample values | Description |
|---|---|---|
udid |
ABCD-EFGH |
UDID of the launched device |