用户界面自动化活动

上次更新日期 2025年9月16日

连接

将设备连接到应用程序。

定义

命名空间：UiPath.MobileAutomation.API.Contracts

程序集：UiPath.MobileAutomation.API（在 UiPath.MobileAutomation.API.dll 中）

重载

重载	描述
`Connect(Device, Application, ConnectionOptions)`	连接设备和应用程序对象。
`Connect(string, string, ConnectionOptions)`	按照移动设备管理器中的配置连接设备和应用程序。

`Connect(Device, Application, ConnectionOptions)`

连接设备和应用程序对象。

Connect(
	    Device device,
	    Application application = null,
	    ConnectionOptions options = null
)Connect(
	    Device device,
	    Application application = null,
	    ConnectionOptions options = null
)

device 设备: 要连接的设备对象。
应用程序 应用程序: 在移动设备管理器中配置的应用程序对象。
options ConnectionOptions (Optional): 用于进一步配置连接的选项。

`Connect(string, string, ConnectionOptions)`

按照移动设备管理器中的配置连接设备和应用程序。

Connect(
	    string name,
	    string applicationName = null,
	    ConnectionOptions options = null
)Connect(
	    string name,
	    string applicationName = null,
	    ConnectionOptions options = null
)

name 字符串: 在移动设备管理器中配置的设备名称。
applicationName 字符串: 在移动设备管理器中配置的应用程序名称。
options ConnectionOptions (Optional): 用于进一步配置连接的选项。

返回值

Connection

一个连接对象，您可以通过该对象使用移动自动化编码的自动化 API。

MobileOptions.ConnectOptions 类

使用MobileOptions.ConnectOptions类在编码自动化中进一步配置移动设备连接。

定义

命名空间：UiPath.MobileAutomation.API.Models

程序集：UiPath.MobileAutomation.API（在 UiPath.MobileAutomation.API.dll 中）

语法

public class ConnectOptions : MobileOptionspublic class ConnectOptions : MobileOptions

构造函数

public ConnectOptions()public ConnectOptions()

MobileOptions.ConnectOptions: 初始化“ MobileOptions.ConnectOptions ”类的新实例。

属性

使用现有会话 布尔值

如果设置为true ，则仅当连接详细信息匹配时，Studio 才会重用移动设备管理器中的现有连接来执行 Coded Automation Coded Automation API。使用现有连接可以减少执行时间。

已启用镜像功能 布尔值

如果mirroringEnabled参数设置为true ，则执行流程将在打开的移动设备管理器 (MDM) 中镜像。但是，即使未显式设置此参数，如果设置了UseExistingSession参数，则仍将在打开的 MDM 中镜像执行。

单个实例 布尔值

此参数用于管理多个移动设备连接。当设置为true ，该参数会检查 MDM 中所有打开的连接，并将其关闭。当设置为false时，所有现有连接都保持打开状态。

如果移动设备连接与以下信息匹配（不区分大小写），则被视为相同：

URL
平台名称
设备名称
平台版本

等待页面更新 布尔值

如果设置为true ，则在执行操作后，系统会等待屏幕截图和控件树都更新完毕，然后再继续执行下一个操作。设置为false时，系统会立即移至下一个操作。

类

日志记录模型：

语法： public class LoggingModel : ConnectOptions
构造函数： public LoggingModel()
属性:
- IgnoreConditionalFields布尔值
  
  如果设置为true ，则忽略条件字段。
- LoggingEnabled布尔值
  
  如果设置为true ，则为连接启用日志记录。
- FolderPath字符串
  
  输入计算机上要保存日志的文件夹路径。
- VideoRecordingEnabled布尔值
  
  如果设置为true ，则启用运行的视频录制。
- RecordingTimeLimit Int32
  
  指定允许录制视频的最大秒数。
- VideoQuality VideoQuality
  选择录制的视频质量类型。您可以从以下选项中进行选择:
  - VideoQuality.Low
  - VideoQuality.Normal
  - VideoQuality.High
  - VideoQuality.Photo
- CollectScreenshot Collect
  选择“从不”在运行期间收集屏幕截图，或仅在执行编码自动化 API 后收集屏幕截图。可以在以下选项之间进行选择：
  - Collect.AfterActivity
  - Collect.Never
- CollectPageSource Collect
  选择“从不”在运行期间收集页面源代码，或仅在执行编码自动化 API 之后收集页面源代码。可以在以下选项之间进行选择：
  - Collect.AfterActivity
  - Collect.Never