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.

Tip: If you have an IDE that likes to default to webview, set the context to 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