Mobile Installation Guide | Leapwork Docs

Introduction

Leapwork offers the Mobile Automation feature. This feature enables you to run automation on mobile devices.

You can connect to cloud devices alongside native mobile devices to run the flows. The connection details for cloud devices are explained in the below sections in detail.

Objective

The main objective of this feature is to support mobile automation on both iOS and Android devices, the benefits of which are listed below:

Instructions for Installation

Leapwork supports mobile automation on native devices Appium and HeadSpin. Below are the instructions to install and run mobile automation on Android and iOS devices.

Android Device

Leapwork does not support the installation of Appium and mobile devices. You should have Appium pre-installed. Now, run the latest version of the Leapwork platform installer. Upon successful installation, the mobile automation blocks will be ready for use on the Android device.

iOS Device

Leapwork does not support the installation of Appium and mobile devices. The client should have Appium pre-installed. Now, run the latest version of the Leapwork platform installer. Upon successful installation, the mobile automation blocks will be ready for use on the iOS device.

Connections

The Connection tab lets you set up a connection to different servers. Multiple connections can be created and saved which can be used for running the flow.

Leapwork Mobile automation supports two different ways to set up a connection:

HeadSpin Server Connection

With HeadSpin Server, you don’t need to worry about setting up or maintaining physical mobile devices yourself. It’s a cloud-based automation framework that lets you test your Android and iOS apps on real devices hosted in the cloud. Using WebDriver, you can interact with those devices just like you would locally, except without the overhead of managing a local Appium server. This makes mobile testing simpler, faster to scale, and much easier to maintain.

Notes:

Add a HeadSpin Connection

To add a connection in Leapwork Flow:

  1. Click the Add button.
  2. In the Add Connection pop-up window, fill in the following fields:
    • Title: Enter a unique name.
    • Description: Provide a short description.
    • Type: Select HeadSpin Server.
    • Hostname: Enter the hostname provided by HeadSpin.
    • Port: Enter the port number configured in HeadSpin.
    • API Token: Enter your HeadSpin API token.
    • Click Test connection to verify.
  3. Click Save to confirm.
  4. Click Test connection to verify the connection established.

A success message appears when the connection is active.

To update or remove a connection, you can use the Edit or Delete buttons.

Where to Find Hostname, Port, and API Token in HeadSpin

If you’re not familiar with HeadSpin, here’s how to retrieve the required details:

Appium Server Connection

The Appium Server connection is used for automating mobile testing on iOS and Android. It drives native mobile applications using WebDriver.

To use this connection type, you must have an Appium server installed on a host that is accessible from Leapwork.

Note: This feature can be accessed by Leapwork Admins only.

Add Connection

To add an Appium Server connection in Leapwork Flow:

  1. Click the Add button.
  2. In the Add Connection pop-up window, fill in the following fields:
    • Title: Enter a unique name.
    • Description: Provide a short description.
    • Type: Select Appium Server.

When you select Appium Server, new fields appear:

  1. Click Test connection to verify.
  2. Click Save to confirm.

A success message appears when the connection activates. To update or remove a connection, you can use the Edit or Delete buttons.

Mobile Configurations

Once a connection is established, the Mobile Configurations tab allows administrators to add and manage mobile devices (phones, tablets, etc.) for automation.

Note: You must define a connection before adding any mobile devices. Only administrators can access Mobile Configuration settings.

Leapwork supports two mobile configuration types:

Note: If you're using an Appium server connection, ensure all devices are also registered on the Appium server before adding them to Leapwork.

iOS Device Configuration:

  1. In the Mobile Configurations tab, click Add.
  2. Enter a unique Title and a brief Description.
  3. Click Add next to Mobile to open the configuration form.
  4. Fill in the fields:
    1. Cloud connection: Select the desired connection.
    2. OS type: Choose the operating system.
    3. Device name: Enter a name for the device.
    4. Platform version: Specify the OS version.
    5. UDID: Enter the device's UDID.
    6. XcodeOrgId and XcodeSigningId: Retrieve these from your Apple Developer account.
    7. Capturing type:
      • Screenshot: Captures screenshots per block.
      • Streaming: Captures full-frame video.
  5. Click Test configuration to verify the setup.
  6. Click Apply to register the changes.
  7. Click Save.

A confirmation message appears and the new configuration is listed under Mobile.

Android Device Configuration

  1. Open the Mobile Configurations tab and click Add.
  2. Provide a unique Title and a short Description.
  3. Click Add next to Mobile to open the configuration form.
  4. Fill in the fields:
    1. Cloud connection: Select the desired connection.
    2. OS type: Choose the operating system.
    3. Device name: Enter a name for the device.
    4. Platform version: Specify the OS version.
    5. UDID: Use the command adb devices in the terminal to retrieve it.
    6. Capturing type:
      • Screenshot: Captures screenshots by block.
      • Streaming: Captures full-frame video.
  5. Click Test configuration to verify the setup.
  6. Click Apply to register the changes.
  7. Click Save.

A confirmation message appears and the new configuration is listed under Mobile.