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 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 or Physical Mobile Device.
• 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

• For more information on Appium configuration, see Quick Start Intro.
• To prepare your environment for local devices, see Android Local devices and iOS Local devices.

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. Start with the default test case created through the project.

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. For example: http://localhost:1122/wd/hub.
   • 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 .

   
   

   

   
   

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:
   • App - Enter the app location. You can download and use the UiPath® Android Demo Application.
   • Additional Desired Capabilities - Add specific capabilities to customize your automation session. For more information, see Appium Desired Capabilities.
4. Select App and configure the following iOS settings:
   • App - Enter the app location. You can download and use UiPath® iOS Basic App.
   • Additional Desired Capabilities - Add specific capabilities to customize your automation session. For more information, see Appium Desired Capabilities.
5. 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, or iOS 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:

• Creating Mobile Automation Workflows
• Device Interaction
• Debugging