Mobile Automation with UiPath and Kobiton

This guide walks you through creating and executing a mobile test using Kobiton devices within UiPath Studio, from preparing your environment to running a recorded test on a device.
By the end of this walkthrough, you will have connected to a device, recorded automation steps, and executed a full test flow.

Kobiton currently supports mobile automation in UiPath Studio for:

  • iOS devices (Kobiton 4.19.6 and above).

  • Android devices (Kobiton 4.21.1 and newer, including 4.21.1S).

Prerequisites

  • An active Kobiton account. You will need the following information from your account in the Kobiton Portal:

  • Ensure UiPath Studio is installed and activated.

  • If you are working with Android devices, verify that your Kobiton version is 4.21.1, 4.21.1S, or newer.

Open and configure a project

Launch UiPath Studio

Open an existing project or create a new blank project. For help creating a new project, follow UiPath’s official instructions in this guide.

Select Manage Packages from the ribbon.

UiPath open tab showing Manage Packages ribbon item.

In the search bar, enter UiPath.MobileAutomation.Activities. Select the package and choose Install. Ensure the selected version to install is 24.10.0 or later.

UiPath manage packages menu open to official tab which shows version number and gives option to install.

Select Save to start the installation.

After the installation finishes, the Mobile Automation option appears in the ribbon.

Add a mobile device in UiPath

Select Mobile Automation → Mobile Device Manager in the ribbon. This launches a new Mobile Device Manager window.

UiPath mobile automation ribbon tab open with options menu.

In the Mobile Device Manager window, select Open Devices, then the plus ({+}) icon to create a new device connection.

UiPath mobile device manager window open to devices screen.

In the Add a device window, fill in the following information:

  • Name (required): enter a display name for the device.

  • Appium URL (required): enter the Appium Server URL obtained from the Kobiton Portal.

  • Platform: choose either Android or iOS.

  • Device Name: input the device name displayed in the Kobiton Portal.

  • Platform Version: input the operating system version of the device.

  • Under Additional Desired Capabilities, add the following:

    • udid: input the UDID of the device. If omitted, the Device Name, Platform, and Platform Version will be used to find the device.

    • kobiton:username (required, case-sensitive): input the Kobiton username.

    • kobiton:accessKey (required, case-sensitive): input the Kobiton API key.

    • kobiton:runtime (required): input appium.

See the screenshot below for an example of adding a device:

UiPath add device window open showing configuration options.

To create logs of your sessions, switch to the Logging tab, select Logging Enabled, and specify a path to save the log. This can help with troubleshooting.

Logging tab open showing logging enables and folder path.

Select Save & Close to save the changes.

Add a mobile application in UiPath

In Mobile Device Manager, select Open Application and the plus ({+}) icon to create a new application.

UiPath mobile device manager window open to applications tab.

In the Add an application window, fill in the following required information:

  • Name: enter a name for the application.

  • Choose either App or Web.

  • Select the application platform (Android or iOS).

If App is chosen:

  • App: input the app path. This can be either of the following:

    • Kobiton App Repo ID (e.g. kobiton-store:123 for the latest version of the app or kobiton-store:v124 for a specific version of the app)

    • Direct download URL (must not be a local app path, redirect to another link, or require login)

  • For an Android app, input the App package and App activity. For an iOS app, input the Bundle Id.

  • See below for an example:

UiPath app application window open showing configurable settings for the user uploaded app.

If Web is chosen:

  • Select Browser name.

  • Enter Start Page URL.

  • See below for an example:

UiPath app application window open showing configurable settings if user chose to test through browser.

Select Save & Close.

Connect to the device and record test steps

In Mobile Device Manager, select Start an application.

UiPath mobile device manager welcome window open.

In the Create connection screen, select the device and app you created earlier.

Create connection tab open showing the chosen device, app, and logging enabled option selected.

Select Connect.

After the connection is established, a live view of the device appears. Here you can interact with the device; UiPath automatically captures your actions.

UiPath mobile device manager window open to device tab displaying an image of device with uikitcatalog open.

View your recorded steps in the Recorded Actions tab:

UIKitCatalog tab open with alert views highlighted in green on the device screen.

To import these steps into your project:

  • Keep the device connection open in the Mobile Device Manager window.

  • Switch back to the Studio project window, then open a sequence file (Main.xaml in the screenshot below).

Studio project window open.

  • Select Mobile Automation → Import Recorded Actions.

UiPath menu ribbon with mobile automation menu item open displaying options.

A sequence is created with the recorded steps:

Project tab open displaying main sequence recorded actions.

When done, switch to the Mobile Device Manager window and close the connection by clicking X.

Note: This ensures the connection is closed properly. Otherwise, the device will remain in use in the Kobiton Portal and be inaccessible to other users.

Mobile device manager showing device selection with highlighted x to close window.

Create and execute test with recorded steps

In the project view, open the previously edited sequence file.

Select the Plus (+) icon before the sequence with the recorded actions to add a new activity.

Shows where to click to add a new activity.

Search for the Mobile Device Connection activity and select it.

Displays search bar where mobile device connection is entered for search.

Under the newly added activity, choose Select Connection Details.

Menu showing where to select connection details.

Select the device and app you created and Save.

Connection details displaying names of sample device and sample app.

Drag the sequence with the recorded steps into the Do sequence of the Mobile Device Connection activity.

Select connection details window of sample device and app with activity indicators.

Now you have a complete sequence to run the test.

To run the test, select Debug File or other UiPath debugging options.

UiPath menu ribbon items with debug file option highlighted.

If Debug File is selected, the Debug window appears. At the same time, Mobile Device Manager opens a new connection to the device and executes the test.

UiPath debug window.

Follow UiPaths debugging guide and mobile automation guides for more information.

When the test is done, close the connection in Mobile Device Manager.

Note: This ensures the connection is closed properly. Otherwise, the device will remain in use in the Kobiton Portal and be inaccessible to other users.