Specify a Device
Last updated
Last updated
If you have multiple devices open, you can specify which device to run Maestro on. To do this, you must first obtain the device identifier and then pass it to Maestro.
To list available Android devices, run the following command in your terminal:
From the output, locate the device identifier for the device you want to use with Maestro.
When running any Maestro command that requires a device (e.g. test or studio), you must first pass the device identifier with the --device parameter before running the command.
For example, to run Maestro Studio on an Android device with identifier emulator-5554 use the following command:
Similarly, to run flow.yaml on an iOS simulator with identifier 5B6D77EF-2AE9-47D0-9A62-70A1ABBC5FA2 use the following command:
Maestro can run tests in parallel, also known as "sharding".
There are two sharding strategies available.
To run tests in parallel, you can use the --shard-all parameter. This parameter will run the same tests in parallel on available devices:
Let’s say you have 3 running devices and 9 tests, but now you want to split this test suite into 3 chunks of tests and run them in parallel on connected devices:
To run with --shard-all 3 or --shard-split, you need to have 3 available devices. If there are less, Maestro will print an error and request you to run more devices.