Mobile Configuration

Once the connections are setup, the Mobile Configurations tab lets the admin configure the mobile devices (Phones, tablets, etc.) required for automation. It is not possible to add Mobile Configuration before a Connection has been defined. 

Note: Mobile Configuration settings would be available if you are logged in as an administrator.

Leapwork supports two different ways to configure the Mobile Configuration with devices:

  • iOS Device Configuration
  • Android Device Configuration

Note that if the Connection type is Appium server, the mobile devices you want to add as a Mobile Configuration must also be configured on the Appium server.

iOS Device Configuration:

You can complete the device setup by configuring the mobile device under Mobile Configuration tab:

Click on Add and a new window opens:

Enter the title in the Title field. It should be unique.

Enter the description in the Description field.

Click Add button next to Mobile and the following new fields appear:

Select the desired connection from the Cloud connection drop-down list.

Select the OS type based on device from the OS type drop-down list. This information is available on either the physical device or the HeadSpin device information.

Enter a device name for the device being configured in the Device name field.

Enter the version of the OS in the Platform version field. This information is available on either the physical device or the HeadSpin device information.

Enter the Udid of the device in the Udid field.

Note: You can obtain the Udid of the connected iOS device using below path on the Appium host machine::

Path: Finder > Locations

Refer the below image to obtain Udid:

Click on device name to view the UDID:

Enter the value for XcodeOrgld in the XcodeOrgld field. This can be obtained from the Apple dev portal.

Enter the XcodeSigningId in the XcodeSigningId field. This can be obtained from the Apple dev portal.

Select the Capturing type from the drop-down list:

Screenshot: The screenshots of individual blocks are captured as the flow executes on the mobile device ensuring effective debugging. This is the most viable option for optimal performance while executing multiple flows.

Streaming: The flow being executed on the mobile device is streamed in full frame video. This option requires more space on the Controller and also a reliable, high-speed network connection to ensure optimal performance. If you experience lagging automation performance, use “Screenshot” instead:

Click the Test configuration button to test the configuration.

Click the Apply button to apply the changes. The applied changes reflect next to the Mobile label.

Click the Save button to save the configuration. Once your connection is saved a success message appears to let you know the configuration is successful. The saved configuration displays under the Mobile Configuration screen:

To the right of the Add button, use the buttons Edit or Delete to change and remove the configuration:

Android Device Configuration

You can configure an Android device in addition to iOS device by following the below steps:

The device setup by configuring the mobile devices under Mobile Configurations tab:

Click on Add and a new window opens:

Enter the title in the Title field. It should be unique.

Enter the description in the Description field.

Click Add button next to Mobile and the following new fields appear:

Select the desired connection from the Cloud connection drop-down list.

Select the OS type based on device from the OS type drop-down list.

Enter a device name for the device being configured in the Device name field.

Enter the version of the OS in the Platform version field.

Enter the Udid of the device in the Udid field.

Note: You can obtain the Udid of the connected Android device using below command in the Command Prompt:

Command: C:\Users\username\adb devices or C:\>adb devices

Select the Capturing type from the drop-down list:

Screenshot: The screenshots of individual blocks are captured as the flow executes on the mobile device ensuring effective debugging. This is the most viable option for optimal performance while executing multiple flows.

Streaming: The flow being executed on the mobile device is streamed in full frame video. This option requires more space on the Controller and also a reliable, high-speed network connection to ensure optimal performance. If you experience lagging automation performance, use “Screenshot” instead:

Click the Test configuration button to test the configuration.

Click the Apply button to apply the changes. The applied changes reflect next to the Mobile label.

Click the Save button to save the configuration. Once your connection is saved a success message appears to let you know the configuration is successful. The saved configuration displays under the Mobile Configuration screen:

To the right of the Add button, use the buttons Edit or Delete to change and remove the configuration: