Breadcrumbs

Start Mobile Application

The Start Mobile Application block is used to start a mobile app on a connected device. It identifies and launches the application by its bundle ID and allows dynamic input using tokens.

The block waits for the app to open and can fail gracefully if the application does not start within the specified timeout.

Fully expanded, the Start Mobile Application block shows the following properties:

image-20251112-131600.png

Note: The screenshot on this page uses the Elegance Design, introduced in 2025.3. If you are using an earlier version, your layout may look different.

Quick-start

  1. Drag Start Mobile Application onto the canvas.

  2. Specify the basic parameters required for this block to operate: Bundle Id, Default timeout, Timeout.

  3. Run the flow when it’s ready.

Building block parameters

Parameters

  • The Block Header: The green input connector in the header is used to trigger the block to start executing. The green output connector in the header triggers when the mobile application has been successfully started. The title of the block (“Start Mobile Application”) can be changed by double-clicking on it and typing in a new title.

  • Bundle Id: The unique identifier for the mobile application to be launched. Typically uses a string such as com.example.myapp. Supports tokens from Text fields for dynamic selection.

  • Text fields: Enables the use of dynamic values in the Bundle Id field. Right-click the Bundle Id field to insert tokens referencing these fields. Fields can be renamed, and tokens will update automatically.

  • Error occurred: Triggers if the application cannot be started within the specified timeout. This output can be used to branch the flow for error handling.

  • Default timeout: Defines whether the global flow timeout setting should be used. If unchecked, the local timeout value (below) is used instead.

  • Timeout: Maximum wait time in seconds to start the application. Default value is 60 seconds. If exceeded, the Error occurred output is triggered.

Resources

Topic

Description

Mobile connections

Overview of what’s needed to enable mobile automation

Mobile configuration

Steps to configure devices and environments for testing

Mobile FAQs

Frequently asked questions about mobile automation and troubleshooting