Test Suite
  • StudioPro
    • Overview
    • Testing Activities
      • Getting Started
      • Managing Mobile Device Manager
      • Managing Applications
      • Device Interaction
      • Creating Mobile Automation Workflows
  • Orchestrator
  • Testing robots
  • Test Manager
Banner background image
Test Suite User Guide
Last updated Feb 28, 2024

Getting Started


Run device automation through Mobile Device Manager without ever touching the device. To quickly understand how to automate a mobile project, set up Mobile Device Manager (MDM), and then create and run a workflow on a cloud device.


  • Studio Pro license.
  • UiPath.MobileAutomation.Activities. For more information, see Managing Packages. Alternatively, you can use the Mobile Testing Project default template, as this will install the activity package for you.
  • Device farm
  • Appium endpoint

Prepare The Test Automation Framework

Prepare your test automation framework through Node.js and Appium.

  1. Download and install Node.js.
  2. Open Node.js command prompt and run the following command to install Appium:

    npm install -g appium

Create a Mobile Testing Project

Create a mobile testing project in Studio.

  1. Open Studio.
  2. Select a Mobile Testing Project from the default templates.
  3. Configure project details and then click Create.
  4. Create a new test case or start with the default one located in Projects, under .tmh.

Configure Mobile Device Manager

To prepare your test environment, open Studio and navigate to Mobile Automation > Mobile Device Manager to launch MDM.

Note: The Mobile Device Manager button is added to the ribbon after you install UiPath.MobileAutomation.Activities, or if you open a Mobile Testing Project template.

Continue by adding a device and an application to MDM.

Add a Device

Add your first cloud device to MDM.

  1. In the left navigation panel go to Devices.
  2. Click Add a device.
  3. Configure your device as follows:
    • Name - Enter a name to identify your device in the Devices tab.
    • Appium URL - Enter the Appium server where your device is hosted.
    • Platform - Click the field to select Android or iOS from the dropdown.
    • Device Name - Enter the device name.
    • Platform Version - Add the version number of your Android OS.
    • Additional Desired Capabilities (Optional) - Add specific capabilities to customize your automation session. For more information, see Appium Desired Capabilities.
    • Set Geo Location (Optional) - Set your device location to test applications that use Location Services to generate location data.
  4. Click Save & Close to add your device.

    Your device is added to the Devices list. To add a local device, see Local Devices.

Add an Application

Add an application to be used by your device.

  1. In the left navigation panel go to Applications.
  2. Click Add a new application and enter a name for your application.
  3. Select App and configure the following Android settings:
  4. Click Save & Close to add your application.

Start the Application

You can now start your mobile device emulator.

  1. In the Welcome tab, click Start an application.
  2. Select a device and an application by choosing the ones you have just created.
  3. Click Connect.

    It may take a while to establish a connection due to multiple connection layers and distance to your device farm.

Record Actions

Record your actions using the interaction bar, right next to your mobile device emulator. Through this, you can indicate your actions on-screen. Alternatively, you can design your workflow in Studio.

  1. Open the Recorded Actions panel on the right side to keep track of your executed actions.
  2. On the right side of the mobile device emulator, click the Android Home button.
  3. Click the Google search bar on the emulator screen and then click No Thanks to dismiss the overlay if needed.
  4. Double click on the search bar to send text and type in "Uipath Test Suite".
  5. Select Press Enter key after sending text and then click Send text.

Create and Run Mobile Automation

Open Studio to import your recorded actions and run your mobile automation.

  1. Open Studio and add a Mobile Device Connection activity to your sequence.
  2. Click Select Connection Details and select your device and application.
  3. Select Do within the sequence.
  4. Navigate to Mobile Automation > Import Recorded Actions to add them to the sequence.
  5. Navigate to Debug File > Run File.

    A new connection is established to the emulated mobile device to execute your actions in real-time.

Next Steps

To learn more about creating workflows for your mobile automation tests, understanding device interaction, and debugging, see the following topics:

Was this page helpful?

Get The Help You Need
Learning RPA - Automation Courses
UiPath Community Forum
Uipath Logo White
Trust and Security
© 2005-2024 UiPath. All rights reserved.