Breadcrumbs

Mobile Configuration

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.

image-20260313-144006.png

Leapwork supports two mobile configuration types:

  • iOS Device

  • Android Device

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.

image-20260123-113223.png

  1. Click Add next to Mobile to open the configuration form.

image-20260123-113248.png

  1. Fill in the fields:

    1. Cloud connection: Select the desired connection.

    2. OS type: Choose the operating system.  This information is available on either the physical device or the HeadSpin device information.

    3. Device name: Enter a name for the device.

    4. Platform version: Specify the OS version. This information is available on either the physical device or the HeadSpin device information.

    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. Recommended for most use cases.

      • Streaming: Captures full-frame video. Requires more bandwidth and storage.

        image-20260123-113316.png


  2. Click Test configuration to verify the setup.

image-20260123-113332.png

  1. Click Apply to register the changes.

  2. Click Save.

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

image-20260123-113409.png

Android Device Configuration

  1. Open the Mobile Configurations tab and click Add.

image-20260123-113437.png

  1. Provide a unique Title and a short Description.

  2. Click Add next to Mobile to open the configuration form.

image-20260123-113503.png

  1. Fill in the fields:

    1. Cloud connection: Select the desired connection.

    2. OS type: Choose the operating system.  This information is available on either the physical device or the HeadSpin device information.

    3. Device name: Enter a name for the device.

    4. Platform version: Specify the OS version. This information is available on either the physical device or the HeadSpin device information.

    5. UDID:se the command adb devices in the terminal to retrieve it.

    6. Capturing type:

      • Screenshot: Captures screenshots by block. Recommended for most cases.

      • Streaming: Captures full-frame video. Requires more bandwidth and storage.

        https://www.leapwork.com/hs-fs/hubfs/image-png-Mar-07-2023-06-19-19-8007-AM.png?width=492&height=102&name=image-png-Mar-07-2023-06-19-19-8007-AM.png

  2. Click Test configuration to verify the setup.

image-20260123-113540.png

  1. Click Apply to register the changes.

  2. Click Save.

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

image-20260123-113617.png

To edit or delete a configuration, use the Edit or Delete buttons beside the mobile device entry.

image-png-Mar-07-2023-06-21-24-2967-AM.png?width=1077&height=290&name=image-png-Mar-07-2023-06-21-24-2967-AM.png