mobile configuration.md

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.

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:

  5. Cloud connection: Select the desired connection.

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

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

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

  9. UDID : Enter the device's UDID.

  10. XcodeOrgId and XcodeSigningId: Retrieve these from your Apple Developer account.

  11. Capturing type:

  1. Click Test configuration to verify the setup.

  2. Click Apply to register the changes.

  3. 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:

  5. Cloud connection: Select the desired connection.

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

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

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

  9. UDID : use the command adb devices in the terminal to retrieve it.

  10. Capturing type:

  1. Click Test configuration to verify the setup.

  2. Click Apply to register the changes.

  3. Click Save.

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

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