Specify devices using regular expressions
You can use regular expressions (regex) to select devices to test on instead of providing specific device models in the devices parameter using the builds REST API. Based on the regex you pass, the first available device is allocated from the device pool that matches your specifications. By widening your search through regular expressions, you get better test execution speed by reducing queuing and device tier limits.
The following table provides information on how to use regular expressions for specifying device attributes:
| Parameter | Description | Sample values |
|---|---|---|
devices |
Required - device is required. - os_version is optional. The latest OS version is allocated for the device model if you do not pass this key. |
"devices": [{ "device": "Samsung Galaxy.*", "os_version": "[89]"}, {"device": "Google Pixel 3$", "os_version": ".*"}] Samsung .* allocates any Samsung device, Google Pixel 3$ allocates Google Pixel 3 only. |
Use the device selector below to select an Android device of your choice:
Example cURL request where a regular expression has been used to specify tests to run on any 2 Galaxy devices with OS version 11.0:
Here are some use cases of the using regular expression to specify device attributes:
| Use case | Number of parallels consumed | Parameter structure |
|---|---|---|
| Run test suite on any Galaxy device with OS version 11.0 | 1 | "devices": [{"device": "Samsung Galaxy .*", "os_version": "11.0"}] |
| Run test suite on any 2 Galaxy devices with OS version 11.0 | 2 | "devices": [{"device": "Samsung Galaxy .*", "os_version": "11.0"}, {"device": "Samsung Galaxy .*", "os_version": "11.0"}] |
| Run test suite on any 1 Galaxy device with OS version 11.0 and any 2 Android 8 or Android 9 devices | 3 | "devices": [{"device": "Samsung Galaxy .*", "os_version": "11.0"}, {"device": ".*", "os_version": "[89]"}, {"device": ".*", "os_version": "[89]"}] |
Once you start the Flutter test execution, you can access the test execution results on the App Automate dashboard.
Related topics
-
Manage your uploaded apps using our REST API.
-
Use the recent apps API endpoint to list your recently uploaded apps.
-
Delete your uploaded apps using the delete app API endpoint.
-
If you have any queries, get in touch with us.
We're sorry to hear that. Please share your feedback so we can do better
Contact our Support team for immediate help while we work on improving our docs.
We're continuously improving our docs. We'd love to know what you liked
We're sorry to hear that. Please share your feedback so we can do better
Contact our Support team for immediate help while we work on improving our docs.
We're continuously improving our docs. We'd love to know what you liked
Thank you for your valuable feedback!