移动自动化活动和 API

本节包括测试 UiPath.Mobile.Automation.Activities 包中的相关活动和 API。通过这些活动和 API，您可以为设备创建自动化，运行原生或网页应用程序。

要在 Studio 中创建移动测试用例，您可以使用 Mobile.Automation 包中提供的活动。此外，要在 Studio 中创建编码移动测试用例，您可以使用 mobileautomation 服务中提供的 API（与 Mobile.Automation 包一起下载）。请访问移动自动化 API，查看如何使用移动自动化 API。

活动

本部分包含 Mobile.Automation 包中与移动自动化相关的所有活动。

活动	描述
移动设备连接	建立与移动设备的连接，并为所有后续活动/API 提供作用域。
获取日志类型	从通过移动设备连接连接的设备中检索日志类型。
获取日志	从通过“移动设备连接”作用域活动连接的移动设备检索日志。
安装应用程序	在通过“移动设备连接”连接的移动设备上安装指定的应用程序。
获取网页源代码	从通过“移动设备连接”作用域活动连接的移动设备检索页面来源。
管理当前应用程序	使用用户输入命令管理当前应用程序。
管理其他应用程序	将用户输入命令发送到目标移动设备上的指定应用程序。
打开深度链接	转至应用程序内部的深度链接
打开 URL	在当前活动的网页浏览器中打开某个 URL。
获取设备方向	检索指定移动设备的当前方向。
按硬件按钮	按下已连接设备上的硬件按钮
设置设备方向	更改并获取已连接设备的方向
截取屏幕截图	使用在“高度”和“宽度”属性中指定的自定义尺寸截取您正在使用的移动设备的屏幕截图。
存在元素	返回一个布尔值变量，用于声明指定的用户界面元素是否存在。
获取属性	检索指定用户界面元素的上级。
获取选定的项目	从目标元素中获取选定的项目。
获取文本	从指定的用户界面元素中提取文本，并将其作为字符串变量返回。
设置选定的项目	在目标元素上设置选定的项目。
设置文本	在目标用户界面元素中键入所提供的文本。
滑动	向指定方向滑动屏幕指定次数。
点击	返回一个布尔值变量，用于声明指定的用户界面元素是否存在。
定向滑动	使用以下预定义的方向执行滑动操作：下、上、左、右。
绘制图案	在设备屏幕上绘制由多个点标记的路径。
输入文本	获取通过键盘键入的内容，并将其粘贴到当前处于活动状态的用户界面元素中。

APIs

本部分包含 Mobile.Automation 包中与移动自动化相关的所有 API。

API	描述
Connect/ConnectAsync	将设备连接到应用程序。
CreateApplication	创建一个新应用程序并为其命名。
CreateDevice	创建新设备。 您可以在代码中使用此设备，但系统不会将其保存在移动设备管理器中。
GetApplication/GetApplications	获取具有指定名称的应用程序 (具有与移动设备管理器中相同的配置)。
GetDevice/GetDevices	获取具有指定名称 (在移动设备管理器中配置的名称) 的设备。
定向滑动	使用以下预定义的方向执行滑动操作：下、上、左、右。
DrawPattern	在设备屏幕上绘制由多个点标记的路径。 根据手指在设备屏幕上的路径记录创建路径的点。 您可以添加多个手指路径，以模拟涉及多个手指的屏幕交互。
ElementExists	返回一个布尔值变量，用于声明指定的用户界面元素是否存在。
ExecuteCommand	执行与特定端点不关联的原生移动命令。 例如，您可以检索电池信息或关闭警示（请参阅 Appium 命令）。
获取属性	检索指定用户界面元素的上级。
GetDeviceOrientation	检索指定移动设备的当前方向。
GetLogTypes	从通过移动设备连接的设备检索日志类型。
GetPageSource	从通过“连接”类连接的移动设备检索页面来源。
GetSelectedItem	从目标元素中获取选定的项目。
GetSesstionIdentifier	检索当前移动设备管理器连接的会话 ID，以将 HTTP 命令路由到 Appium 端点，以便执行自定义 Actions。
GetSystemTime	检索设备的当前时间。
GetText	Extracts the text from a specified UI element and returns it as a String variable.
InstallApp	在通过Connection连接的移动设备上安装指定应用程序。
ManageCurrentApplication	重置或启动此会话的当前应用程序。
ManageOtherApplication	使用命令管理其他应用程序。
OpenDeepLink	打开应用程序中的深度链接。
OpenUrl	在 Chrome 中打开 URL。 在调用此方法之前，当前处于活动状态的应用程序应为 Chrome，并且至少已打开一个选项卡。
PositionalSwipe	滑动到屏幕上包含起点和终点的预定义位置。
PressHardwareButton	按下已连接设备上的硬件按钮
SaveLogs	将特定类型的日志保存至文件。
SetDeviceGeoLocation	设置设备的当前地理位置。
SetDeviceOrientation	更改并获取已连接设备的方向
SetSelectedItem	在目标元素上设置选定的项目。
SetText	在移动自动化可识别的目标用户界面元素中键入指定文本。
滑动	滑动操作会遍历列表中的多次滑动（直到达到MaxNumberOfSwiches 次数），直到找到指定的元素。 如果未设置“目标”，则滑动操作将执行单次滑动，而不搜索特定元素。
截取屏幕截图	使用自定义尺寸截取您正在使用的移动设备的屏幕截图。
点击	返回一个布尔值变量，用于声明指定的用户界面元素是否存在。 该 API 没有返回值，但如果存在指定的用户界面元素（布尔值），则会对其执行点击操作。
TypeText	获取通过键盘键入的内容，并将其粘贴到当前处于活动状态的用户界面元素中。 要将文本粘贴到所需的元素内，您需要将焦点放在用户界面上要粘贴文本的任意位置。 在自动化应用程序时，您可以使用此 API，您需要通过键盘键入文本，但没有移动自动化可识别的目标元素。