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.

Prerequisites for Cloud devices

• Install 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.
• Create an account on a device cloud platform. For this example, create an account on Sauce Labs.

Prerequisites for Local devices

Local devices require specific configurations in order to run mobile testing automations on them.

Local Android device

Follow the steps described in the Prerequisites for Local Android devices topic.

Local iOS device

Follow the steps described in the Prerequisites for Local iOS devices topic.

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 Cloud device, or a Local device and a native application, or web application to MDM.

Add a cloud 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.

   
   

   

   
   

Add a local device

• For Local Android devices, check out the Adding Local Android Device in Mobile Device Manager topic.
• For Local iOS devices, check out the Adding Local iOS Device in Mobile Device Manager topic.

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.
   
   

   

   
   

Add a web application

1. In the left navigation panel go to Applications.
2. Click Add a new application and enter a name for your application.
3. Select Web and select Android, or iOS, and configure the following settings:
   • Browser name - select the corresponding browser from the dropdown.
   • Start Page - set a page where you want the web application to start from.
   • Additional Desired Capabilities - Add specific capabilities to customize your automation session. For more information, see Appium Desired Capabilities.
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, 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