Configure the OS

Set Android API levels or iOS runtime versions and device models for Maestro Cloud tests. Supports Android 10-14 and iOS 16-18.

Maestro Cloud allows you to test your application across multiple Android and iOS versions. This ensures your app remains compatible and performs reliably across different mobile environments.

Maestro Cloud Plan required. OS configuration options are available on the Maestro Cloud Plan.

Android

You can specify the Android OS version (API level) using the --android-api-level flag when using Maestro Cloud.

maestro cloud --android-api-level "<API_LEVEL>" --app-file "<APP_FILE>" --flows "<FLOWS>"

The following table lists the supported Android versions:

Android Version	API Level
Android 14	34
Android 13 (Default)	33
Android 12	31
Android 11	30
Android 10	29

Reproducing Cloud runs locally

To closely reproduce Maestro Cloud runs for Android on your local machine, create an emulator of the same API version and use the Google APIs variant (not Google Play).

iOS

For iOS, you can configure both the runtime version and the device model.

Maestro recommends specifying both the minor OS version and the device model. Use the --device-os and --device-model flags to select a specific combination:

maestro cloud --device-os "<DEVICE_OS>" --device-model "<DEVICE_MODEL>" --app-file "<APP_FILE>" --flows "<FLOWS>"

The following table lists the supported device models and their available iOS versions:

Device Model	Supported iOS Versions
iPhone-11	iOS-16-2, iOS-17-5, iOS-18-2
iPhone-13-mini	iOS-18-2
iPhone-16	iOS-18-2
iPhone-16-Pro	iOS-18-2
iPhone-16-Pro-Max	iOS-18-2
iPad-10th-generation	iOS-16-2, iOS-17-5, iOS-18-2

For example, to run your flows on iOS 18.2 using an iPhone 16 Pro, use the following command:

maestro cloud --device-os "iOS-18-2" --device-model "iPhone-16-Pro" --app-file myapp.app --flows myflows/

Deprecated: --ios-version

The --ios-version option is deprecated and will no longer be available. Use the --device-os and --device-model flags instead.

Previously, the --ios-version flag allowed you to specify only a major version (for example, 16, 17, or 18). When using this flag, Maestro Cloud automatically runs your flows on an iPhone 11 simulator.

Related content

Now that you understand how configure the OS, explore other ways to customize your test environment:

• App locales and device timezones: Select the device locale for Maestro Cloud tests.

• Set up notifications via Slack, email, or webhooks to stay informed about build and test results.