Mobile Device Automation

This section describes the Mobile Device Automation solution in more detail, and helps you in getting started on how to use it.

About mobile device automation

Mobile device automation involves using three distinct components:

• StudioPro - IDE for designing mobile tests, and prepare them for test management and execution.
• Mobile Automation activities - Configurable actions that you can take on the mobile device, to automate it.
• MDM (Mobile Device Manager) - Tool that offers you a realistic visual interface of testing and automating a mobile device within StudioPro. You can use MDM to connect to real or emulated devices through Appium, and perform and record your actions on the device as well as manage devices and applications.

Resources

To get started with using UiPath's mobile device automation solution, check out the following resources:

• Mobile Automation
  • Getting Started
  • Creating Mobile Automation Workflows
  • Mobile Automation Activities
• Mobile Device Manager:
  • Managing Mobile Device Manager
  • Managing Devices
  • Managing Applications
  • Device Interaction
  • Troubleshooting

Managing Devices

Manage your devices individually by configuring settings or running applications.

To configure devices see:

• Cloud Devices
• Local Devices

Device Capabilities

• Android and iOS support.
• Run multiple devices at the same time.
• Access any type of content except for videos.

Navigation in MDM Devices Panel

You can filter your devices using one or all of the following criteria:

• By device type: Click the Androidor the Apple button.
• By platform version: Click the Platform Version button and choose from the dropdown. By default is set to All.

You can reorder your devices by dragging and dropping a device card in a new position in the list.

Managing Devices in MDM

The following table lists the actions that you can take to manage your devices.

Action	Description	Procedure
Edit	Configure device settings.	In MDM, go to Devices Select a device from the list. Click Edit and configure your device settings. Click Save & Close to save changes.
Clone	Create a device clone.	In MDM, go to Devices Select a device from the list. Click Clone and configure your device settings. Click Save & Close to save changes.
Delete	Delete the selected device.	In MDM, go to Devices Select a device from the list. Click Delete, followed by Ok to confirm changes.
Start an application on this device	Choose and run an application on the selected device.	In MDM, go to Devices Select a device from the list. Click Start an application to run on this device and choose an application from the dropdown. Click Connect to fire up the device. For more information, see Device Interaction.

Troubleshooting

The following section lists your troubleshooting options:

• Debugging to investigate Appium logs.
• Logs and Execution Timeline to examine what has happened on your device during automation.
• Troubleshooting Scenarios

Mobile Automation Activities

This section includes testing related activities found in the UiPath.Mobile.Automation.Activities pack. Through these activities, you can create automation for your devices, running native or web applications. You can find the activities in Studio, under Mobile Automation.

Activity	Description
Mobile Device Connections	Establishes a connection to a mobile device and provides scope for all subsequent activities.
Get Log Types	Retrieves the log types from a device connected via the Mobile Device Connection
Get Logs	Retrieves the logs from a mobile device connected via the Mobile Device Connection scope activity.
Install App	Installs a specified app on a mobile device connected via the Mobile Device Connection scope activity.
Get Page Source	Retrieves the page source from a mobile device connected via the Mobile Device Connection scope activity.
Manage Current App	Manages the current app by using a user input command.
Manage Other App	Sends a user input command to a specified app on the target mobile device.
Open Deep Link	Navigates to a deep link inside an application.
Open URL	Opens a specified URL in the currently active web browser.
Get Device Orientation	Retrieves the current orientation of the specified mobile device.
Press Hardware Button	Presses a hardware button on the connected device.
Set Device Orientation	Changes and then retrieves the orientation of the connected device.
Take Screenshot	Takes a screenshot of the screen of the mobile device you are using with custom dimensions specified in the Height and Width properties.
Element Exists	Returns a boolean variable that states whether a specified UI element exists.
Get Attribute	Retrieves an attribute of a specified UI element.
Get Selected Item	Retrieves the selected item from a target UI element.
Get Text	Extracts the text from a specified UI element and returns it as a string variable.
Set Selected Item	Sets the selected item on a target UI element.
Set Text	Types the specified text into a target UI element.
Swipe	Swipes the screen in a specified direction and for a specified amount of times.
Tap	Returns a boolean variable that states whether a specified UI element exists.

Troubleshooting Scenarios

If you run into issues, consider the following troubleshooting scenarios:

iOS physical device fails to start

If your iOS device fails to start, try the following:

• Make sure that your device is trusting the certificate. On your device, go to Settings > General > Profiles & Device Management, tap on the email entry (e.g. Apple Development: [e-mail]), and then trust the certificate. If the device is using your corporate account, this would not be needed.
• If you get an error that port 8100 is not accessible, close Appium (Control + C) and then restart it.
• If you get a different error, consider looking through Appium XCUITest Driver Real Device.