Start application command
Launches an application on the device. Use this function at the beginning of a script to ensure a known starting point for the user. To use this command, one of the two application identifiers is required. For information on retrieving the application identifier, see Application identifier.
native
to run this command.
Parameters
Name | Type | Possible values | Description |
---|---|---|---|
Device ID* |
String |
The device for this command. By default, this is the device under test (DUT). |
|
Application name |
String |
The application name as it is displayed on the screen. |
|
Application identifier |
String |
The identifier of the application. |
|
Timeout |
Number |
The time, in seconds, to wait for the application to start. A zero value starts the application without any validation or retries and returns immediately. On Android, a value greater than zero waits for the defined time and fails if the app is not loaded by that time. On iOS, the behavior is identical to the default undefined timeout. The command validates that the application has started on iOS devices only. |
|
Comment |
String |
Adds a comment to the script |
|
On-fail Result* |
Condition |
Ignore | Break | Continue | Abort | Catch |
The behavior when the command fails. |
* Mandatory parameter