UiPath 远程运行时

关于 UiPath 远程运行时

UiPath Remote Runtime 是一个组件，可实现远程桌面或应用程序（例如 Citrix Virtual Apps）与某些 UiPath 扩展程序之间的通信。其中包括 UiPath Citrix 扩展程序、UiPath Windows 远程桌面和应用程序扩展程序以及 UiPath VMware Horizon 扩展程序。UiPath Remote Runtime 会收集有关远程应用程序目标用户界面元素的信息，并将此数据传递到相应的扩展程序。这允许在“UI Explorer”中原生生成选取器。

备注：

从 Citrix Virtual Apps and Desktops 7 2109 开始，默认情况下会阻止所有自定义虚拟通道。这会导致 UiPath Remote Runtime 无法正常工作。要解决此问题，必须将 UiPath 虚拟通道添加到允许列表策略中：

UIPCTX,C:\Program Files (x86)\UiPath\RemoteRuntime\UiPathRemoteRuntime.exe

Remote Runtime 组件已获 Citrix Ready 认证，因此可将其视为与 Citrix 技术搭配使用的可靠有效的解决方案。

根据您构建的自动化项目所要基于的环境类型，您可以按照按照如下方式安装 UiPath 远程运行时组件：

• 在 Citrix 应用程序服务器上 – 与 UiPath Citrix 扩展程序通信。
• 在 VMware Horizon 虚拟机上 – 与适用于 VMware Horizon 的 UiPath 扩展程序通信。
• 在 Windows 远程桌面机器上 – 与 UiPath Windows 远程桌面和应用程序扩展程序通信。

必须在客户机上安装相应的 UiPath 扩展程序。

可从以下位置下载 UiPathRemoteRuntime.msi 安装程序：

• UiPath Customer Portal 中的产品下载。
• UiPath Automation Cloud 中的“资源中心”。要访问资源中心，您需要登录 Automation Cloud 组织，然后单击左侧导航栏上的“帮助”按钮。

安装 UiPath Remote Runtime 组件后，该组件将在任务调度程序中注册一个任务，以便在用户每次登录时为每个已登录到远程服务器的用户启动 UiPathRemoteRuntime.exe 进程。

需要 UiPath 远程运行时组件，以便在应用程序或桌面服务器和客户端计算机上的 UiPath 扩展程序之间建立连接。这样，选取器会在安装了 Studio 的客户端计算机上原生生成，而不必依赖于 OCR 和图像识别活动。

任务调度程序

默认情况下，UiPath 远程运行时组件会在 Windows 任务调度程序中创建条目，以在每次相应用户登录时自动启动。此功能由 UiPathRemoteRuntime.msi 安装程序中的“创建启动 UiPath 远程运行时任务”选项进行管理。如有必要，可以选择禁用。

可以通过安装程序或命令提示符添加或删除 Remote Runtime 任务调度程序条目，如以下各节所述。如果删除了该条目，则必须使用其他方法（例如启动脚本）启动 UiPathRemoteRuntime.exe 进程。

还可以通过单击“触发器”选项卡中的“编辑”按钮，对 Remote Runtime 任务调度程序条目进行编辑，使其仅为特定用户启动。可以为多个用户创建多个任务。

安装 UiPath 远程运行时

从安装程序

1. 运行 UiPathRemoteRuntime.msi 文件以安装 UiPath Remote Runtime。您需要将其安装到您要创建自动化项目的所有 Citrix 应用程序服务器、VMware Horizon 虚拟机或 Windows 远程桌面计算机上。
2. 从客户端计算机上的当前 Citrix 窗口、VMware Horizon 窗口或 RDP 会话注销，再重新登录。需要这一步操作，以便您的更改生效。
3. 根据您要基于哪种技术创建自动化项目，在客户端计算机上安装 UiPath Citrix 扩展程序、UiPath VMware Horizon 扩展程序或 UiPath Windows 远程桌面和应用程序扩展程序。

您还可以通过选择相应的选项，从安装程序中选择适用于 Java、Chrome、Microsoft Edge 和 Citrix 的扩展以及任务调度条目，如下所示：

可以随时添加或删除远程运行时的任务调度程序条目。只需运行 UiPathRemoteRuntime.msi 安装程序并选择相应的选项即可。

从命令提示符中

注意：安装 UiPathRemoteRuntime.msi 需要管理员权限。

1. 单击 Windows 开始按钮，然后在搜索字段中键入 cmd。
2. 右击命令提示符并以管理员身份运行。
3. 将目录更改到 UiPathRemoteRuntime.msi 文件夹（例如：cd C:\Tools\Studio）。
4. 使用 UiPathRemoteRuntime.msi ADDLOCAL=RemoteRuntime,RemoteRuntimeTask 命令安装UiPath 远程运行时组件。
5. 从客户端计算机上的当前 Citrix 窗口、VMware Horizon 窗口或 RDP 会话注销，再重新登录。需要这一步操作，以便您的更改生效。
6. 根据您要基于哪种技术创建自动化项目，在客户端计算机上安装 UiPath Citrix 扩展程序、UiPath VMware Horizon 扩展程序或 UiPath Windows 远程桌面和应用程序扩展程序。

此外，您可以使用 RemoteRuntimeTask、JavaBridge、ChromeExtension、EdgeChromium 或 CitrixClient 参数安装任务调度程序条目、Java、Chrome、Microsoft Edge 或 Citrix 扩展程序，如下例所示：

• UiPathRemoteRuntime.msi ADDLOCAL=RemoteRuntime,RemoteRuntimeTask,JavaBridge,ChromeExtension,EdgeChromium,CitrixClient - 安装 Remote Runtime 组件、任务计划程序条目、Java 扩展程序、Chrome 扩展程序、Microsoft Edge 扩展程序和 Citrix 扩展程序。

还可以使用 /quiet 参数执行静默安装。

• UiPathRemoteRuntime.msi ADDLOCAL=RemoteRuntime,RemoteRuntimeTask /quiet - 以静默方式安装 Remote Runtime 组件和任务计划程序条目。

您可以使用APPLICATIONFOLDER选项在任何位置安装 UiPath Remote Runtime：

• UiPathRemoteRuntime.msi APPLICATIONFOLDER="D:\UiPathRemoteRuntime" ADDLOCAL=RemoteRuntime,RemoteRuntimeTask /quiet – 在 D:\UiPathRemoteRuntime 中静默安装 Remote Runtime 组件，并添加任务调度程序条目。

现在，您可以如同在标准计算机上一样，创建基于 Citrix Virtual Apps 和桌面、VMware Apps 以及通过 RDP 连接进行自动化的流程。由于存在对应的扩展程序，正确识别用户界面元素已不再需要 OCR 和图像识别活动。元素可以原生识别，并可与任何活动搭配使用。

UIAutomation 依赖项

UiPath Remote Runtime 依赖于 UiPath.UIAutomation.Activities 包的版本，而不依赖于 UiPath Studio/Robot 的版本。

安装在远程计算机上的 Remote Runtime 必须具有您要在项目中使用的最新 UIAutomation 包版本，并且它与以前的 UIAutomation 版本兼容（向后兼容）。

UiPath.UIAutomation.Activities 包和 UiPath Remote Runtime 具有相同的 UiPath 驱动程序依赖项。对于每个发布的用户界面自动化包版本，都提供具有相同版本号的 UiPath Remote Runtime 组件的下载链接。

例如，对于 UiPath.UIAutomation.Activities 包版本 23.10.8，可以从https://download.uipath.com/versions/23.10.8/UiPathRemoteRuntime.msi下载所需的 UiPath Remote Runtime 安装程序。

可以从以下位置下载 UiPathRemoteRuntime.msi 安装程序：

• UiPath Customer Portal 中的“产品下载”。
• UiPath Automation Cloud 中的“资源中心”。要访问“资源中心”，您需要登录 Automation Cloud 组织，单击工具栏上的“帮助”按钮，然后选择“资源”>“下载”。
• 或者，您可以通过联系技术支持页面提交请求。

并行支持

UiPath Remote Runtime 组件安装在 Citrix 应用程序服务器、VMware 虚拟机或远程桌面计算机上的 %ProgramFiles(x86)\UiPath 文件夹中。所有已安装版本均位于 %ProgramFiles(x86)%\UiPath\RemoteRuntime\packages\uipath 文件夹中。

构建或执行流程时，您需要使用与已部署的 UiPath Remote Runtime 驱动程序版本兼容的 UiPath.UIAutomation.Activities 包。

UiPath.UIAutomation.Activities 包的 UiPath 驱动程序依赖项版本显示在 Studio 的 包管理器信息部分中。

远程计算机上的 %ProgramFiles(x86)%\UiPath\RemoteRuntime\packages\uipath 文件夹中必须存在相同的 UiPath 版本。

每个 UiPathRemoteRuntime.msi 安装程序都包含最新的 UiPath 依赖项以及最新支持的长期支持 (LTS) UiPath。

下表列出了 UiPath.UIAutomation.Activities 包和 UiPath Remote Runtime 之间的依赖项：

UIAutomation 包版本	UiPath Remote Runtime 内部版本号	UiPath 驱动程序依赖项	UiPath Remote Runtime 的 UIAutomation 兼容版本
22.10.10	23.4.67.63183	22.10.67.59238	23.4.10 22.10.10 22.4.12 21.10.10 20.10.15
22.4.12	23.4.67.63183	22.4.67.58669	23.4.10 22.10.10 22.4.12 21.10.10 20.10.15
21.10.10	23.4.67.63183	23.4.67.63183	23.4.10 22.10.10 22.4.12 21.10.10 20.10.15
20.10.15	23.4.67.63183	20.10.8676.29744	23.4.10 22.10.10 22.4.12 21.10.10 20.10.15
19.11.5	22.4.43.27553	19.10.7601.15369	22.4.7 21.10.7 20.10.12 19.11.5 18.4.8
18.4.8	22.4.43.27553	10.0.7772.19184	22.4.7 21.10.7 20.10.12 19.11.5 18.4.8

可以在 UiPathRemoteRuntime.msi 文件的“属性”的“详细信息”选项卡的“注释”字段中验证 Remote Runtime 内部版本号。

如果您使用的 UiPath.UIAutomation.Activities 包版本具有 UiPath 依赖项，而该依赖项不属于远程计算机上已安装的 UiPath 依赖项集，则不会生成选取器，并会引发以下异常：The UiPath.UIAutomation.Activities package is incompatible with the UiPath Remote Runtime running on the server。

添加远程运行时依赖项

目标应用程序的交互式选取无法构建正确的选取器，除非 UiPath.UIAutomation.Activities 与 Citrix 应用程序服务器、VMware 虚拟机或远程桌面计算机上的 UiPath Remote Runtime 依赖项匹配。

例如，如果要使用 UiPath.UIAutomation.Activities 包版本 23.10.8 构建自动化项目，您需要将客户端计算机（其中已安装 Studio/Robot）中的相应 UiPath 依赖项复制到 Citrix 应用程序服务器、VMware 虚拟机或远程桌面计算机上。

操作方法如下：

1. 在客户机（安装 Studio 的计算机）上，导航至 %UserProfile%\.nuget\packages\uipath 文件夹。所有已安装的 UiPath 依赖项均位于该文件夹中。
2. 复制与您要使用的 UiPath.UIAutomation.Activities 包对应版本的文件夹。您可以在“关于用户界面自动化活动”页面中查看 UiPath.UIAutomation.Activities 包随附的依赖项列表，也可以按照“并行支持”中的说明检查包依赖项。
   
   

   

   
   
3. 在 Citrix 应用程序服务器、VMware 虚拟机或远程桌面计算机上，导航到 %ProgramFiles(x86)%\UiPath\RemoteRuntime\packages\uipath 文件夹，然后在此粘贴之前复制的 UiPath 依赖项版本。
   • 例如，对于 UiPath.UIAutomation.Activities 版本 23.10.8，相应的 UiPath 依赖项为 23.10.71.64399。这是您需要从 Studio/Robot 计算机复制到远程计算机的文件夹的名称。
   
   

   

   
   

现已使用当前版 UiPath.UIAutomation.Activities 生成恰当的选取器。复制依赖项后，更改即可生效。

设计时和执行时都需要上述 Remote Runtime 依赖项。

远程运行时架构

在启动流程时，机器人会通过 RPC 通道向 Citrix 扩展程序或 Windows 远程桌面扩展程序发出必要的命令。此信息包还包含用于构建流程的用户界面自动化包的版本详情。

相应的扩展程序随后通过 ICA 虚拟通道将此信息包转发给 Citrix 应用程序服务器或远程桌面机器上的 UiPath 远程运行时组件。

UiPath 远程运行时组件会根据构建流程所使用的用户界面自动化包版本，指示机器人执行程序应使用哪种驱动程序。

多个 ICA 通道

远程运行时组件与对应扩展程序之间的通信通过内部开发的 ICA 通道完成。您可使用多个 ICA 通道，但 Citrix Receiver 等程序已为剪贴板、音频及其他组件使用多个通道。

数据传输及带宽注意事项

安装远程运行时组件后，即可创建自动化项目，且无需创建任何防火墙规则。

在 Remote Runtime 和扩展程序之间数据传输几乎不需要使用带宽。例如，机器人执行的每个操作（例如单击活动）只会传输大约 3 KB 的数据。

多个 RDP 连接

如果您跳过多个 RDP 连接以到达开发自动化的目标远程计算机，则必须在每台中间远程计算机上安装远程运行时，而不仅仅是在目标计算机上。

请考虑以下场景：计算机 A（带有机器人）通过 RDP 连接到计算机 B，并从计算机 B 打开另一个 RDP 连接以连接到计算机 C，而我们必须在计算机 C 中执行自动化。在此示例中，需要进行以下配置：

1. 计算机 A – 安装 RDP 扩展程序。

2. 计算机 B – 安装 RDP 扩展程序和 RemoteRuntime.msi。
3. 计算机 C – 安装 RemoteRuntime.msi。

硬件和软件要求

UiPath Remote Runtime 的要求与 UiPath Robot 相同。请参阅硬件和软件要求中的完整要求列表。