关于 UiPath 远程运行时

UiPath 远程运行时是一个组件，可促进 Citrix Virtual Apps 等远程应用程序或桌面与专用 UiPath 扩展程序（UiPath Citrix 扩展程序或 UiPath Windows 远程桌面扩展程序或 UiPath VMware Horizon 扩展程序）之间进行通信。此组件可收集远程应用程序目标用户界面元素的相关信息，并将这些信息发送到相应扩展程序，以便在用户界面探测器中原生生成选取器。

备注：

从 Citrix Virtual Apps 和 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 扩展程序。

UiPathPlatformInstaller.exe 中附带 UiPathRemoteRuntime.msi 安装程序，您也可联系我们的支持团队获取该程序。请注意，UiPathPlatformInstaller.exe 不支持命令行参数。

安装 UiPath 远程运行时组件后，该组件将在“任务计划程序”中注册任务，以便在用户每次登录时启动 UiPathRemoteRuntime.exe 流程。

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

任务调度程序

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

可以通过安装程序或命令提示符添加或删除“远程运行时任务调度”条目，如以下各部分所示。

安装 UiPath 远程运行时

从安装程序

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

您还可以通过选择相应的选项，从安装程序中选择适用于 Java、Chrome 和 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 窗口或 RDP 会话注销，再重新登录。需要这一步操作，以便您的更改生效。
6. 根据您要基于哪种技术创建自动化项目，在客户端计算机上安装 UiPath Citrix 扩展程序或 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 组件和任务计划程序条目。

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

远程运行时架构

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

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

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

多个 ICA 通道

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

数据传输及带宽注意事项

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

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

驱动程序依赖项

UiPath 远程运行时和 UiPath.UIAutomation.Activities 包的 UiPath 驱动程序依赖项必须使用相同版本。但是，如果升级 UiPath 远程运行时以匹配 UiPath.UIAutomation.Activities 包的新 UiPath 驱动程序依赖项，则 UiPath 远程运行时仍会与以前安装的所有版本向后兼容。

Remote Runtime 版本由 UiPathRemoteRuntime.msi 属性“详细信息”选项卡的“注释”字段规定。

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

您可以在此页查看各版 UiPath.UIAutomation.Activities 包附带的依赖项。

并行支持

我们在 v2018.4 版本中首次引入 UiPath 远程运行时组件。为确保向后兼容性，新版机器人（例如 v2019.10.1 机器人）可以执行使用用户界面自动化包 18.4.5 版及更高版本创建的流程，而不会出现任何问题。

此组件安装在 Citrix 应用程序服务器或远程桌面计算机上，安装程序位于 %ProgramFiles(x86)%\UiPath 文件夹中。所有安装版本均可在 %ProgramFiles(x86)%\UiPath\RemoteRuntime\packages\uipath 文件夹中找到。

在构建或执行进程时，需要使用 UiPath.UIAutomation.Activities 程序包，该程序包与 UiPath 远程运行时的已部署驱动程序版本兼容。该驱动程序由 UiPath.UIAutomation.Activities 程序包的 UiPath 依赖项表示。

此页面显示包含 UiPath Remote Runtime 的兼容驱动程序版本的具体 UiPath.UIAutomation.Activities 程序包。

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

请注意，如果您所用 UiPath.UIAutomation.Activities 包的版本不包含上述 UiPath 依赖项之一，则系统不会生成选取器并会抛出异常，如下所示。

添加远程运行时依赖项

目标应用程序的交互式选取无法构建正确的选取器，除非 UiPath.UIAutomation.Activities 与 Citrix 应用程序服务器或远程桌面机器上的 UiPath 远程运行时依赖项匹配。

例如，如果要使用 UiPath.UIAutomation.Activities 包版本 19.6.0 构建自动化项目，您还需要将客户端计算机（其中已安装 Studio）中的相应 UiPath 依赖项复制到 Citrix 应用程序服务器或远程桌面机器上。操作方法如下：

1. 在客户机（安装 Studio 的计算机）上，导航至 %UserProfile%\.nuget\packages\uipath 文件夹。所有已安装的 UiPath 依赖项均位于该文件夹中。
2. 复制与您要使用的 UiPath.UIAutomation.Activities 包对应的版本。您可以在此页查看 UiPath.UIAutomation.Activities 包附带的依赖项列表。
3. 在 Citrix 应用程序服务器或远程桌面机器上，导航到 %ProgramFiles(x86)%\UiPath\RemoteRuntime\packages\uipath 文件夹，然后在此粘贴之前复制的 UiPath 依赖项版本。

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

硬件和软件要求

UiPath Remote Runtime 的要求与 UiPath Robot 相同。请在此处查看完整的要求列表。