Subscribe

UiPath Test Suite

UiPath Test Suite

Getting Started

Overview


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.
Step 1: Prepare The Test Automation Framework.
Step 2: Create a Mobile Testing Project
Step 3: Configure Mobile Device Manager
Step 4: Start the Application
Step 5: Record Actions
Step 6: Create and Run Mobile Automation

Prerequisites


  • 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 new 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:

Updated 26 days ago


Getting Started


Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.