UiPath Remote Runtime is a component which facilitates the communication between a remote application or desktop, such as Citrix Virtual Apps, and the dedicated UiPath extension – the UiPath Extension for Citrix, the UiPath Extension for Windows Remote Desktop and Apps, or the UiPath Extension for VMware Horizon. It gathers info about targeted UI elements of remote applications and sends them to the corresponding extension, so that selectors are natively generated in UIExplorer.
备注：
从 Citrix Virtual Apps 和 Desktops 7 2109 开始，默认情况下会阻止所有自定义虚拟通道。
这会导致 UiPath Remote Runtime 无法正常工作。
要解决此问题，必须将 UiPath 虚拟通道添加到允许列表策略中：
UIPCTX,C:\Program Files (x86)\UiPath\RemoteRuntime\UiPathRemoteRuntime.exe
The Remote Runtime component was granted a Citrix Ready certification, making it a trusted, effective solution for working with Citrix technologies.
根据您构建的自动化项目所要基于的环境类型，您可以按照按照如下方式安装 UiPath 远程运行时组件：
- On Citrix Application servers – communicates with the UiPath Extension for Citrix.
- On VMware Horizon servers – communicates with the UiPath Extension for VMware Horizon.
- On Windows Remote Desktop machines – communicates with the UiPath Extension for Windows Remote Desktop and Apps.
必须在客户机上安装相应的 UiPath 扩展程序。
可从以下位置下载 UiPathRemoteRuntime.msi 安装程序：
- Product Downloads in the UiPath Customer Portal
- Resource Center in the UiPath Automation Cloud. To access Resource Center, log in to your Automation Cloud Organization and click the Help button on the navigation bar.
Once the UiPath Remote Runtime component is installed, it registers a task in the Task Scheduler so that the UiPathRemoteRuntime.exe process is started at every user login, for every user logged in to the remote server.
需要 UiPath 远程运行时组件，以便在应用程序或桌面服务器和客户端计算机上的 UiPath 扩展程序之间建立连接。这样，选取器会在安装了 Studio 的客户端计算机上原生生成，而不必依赖于 OCR 和图像识别活动。
任务调度程序
默认情况下，UiPath 远程运行时组件会在 Windows 任务调度程序中创建条目，以在每次相应用户登录时自动启动。此功能由 UiPathRemoteRuntime.msi 安装程序中的“创建启动 UiPath 远程运行时任务”选项进行管理。如有必要，可以选择禁用。
The Remote Runtime Task Scheduler entry can be added or removed via the installer or the Command Prompt, as explained in the following sections. If the entry is removed, you must launch the UiPathRemoteRuntime.exe process using another method, like a startup script.
The Remote Runtime Task Scheduler entry can also be edited to start only for a specific user, by clicking the Edit button from the Triggers tab. Multiple tasks can be created for multiple users.
安装 UiPath 远程运行时
从安装程序
- 运行
UiPathRemoteRuntime.msi文件以安装 UiPath 远程运行时。您需要将其安装到您要创建自动化项目的所有 Citrix 应用程序服务器、VMware Horizon 服务器或 Windows 远程桌面机器上。 - 从客户端计算机上的当前 Citrix 窗口、VMware Horizon 窗口或 RDP 会话注销，再重新登录。需要这一步操作，以便您的更改生效。
- Install either the UiPath Extension for Citrix, UiPath Extension for VMware Horizon, or the UiPath Extension for Windows Remote Desktop and Apps on the client machine, depending on the technology on which you want to create your automation projects.
您还可以通过选择相应的选项，从安装程序中选择适用于 Java、Chrome、Microsoft Edge 和 Citrix 的扩展以及任务调度条目，如下所示：
可以随时添加或删除远程运行时的任务调度程序条目。只需运行 UiPathRemoteRuntime.msi 安装程序并选择相应的选项即可。
从命令提示符中
备注：
安装 UiPathRemoteRuntime.msi 需要管理员权限。
- 单击“Windows 开始”按钮，然后在搜索字段中键入
cmd。 - 右键单击“命令提示符”并以管理员身份运行。
- 将目录更改到
UiPathRemoteRuntime.msi文件夹（例如：cd C:\Tools\Studio）。 - 使用
UiPathRemoteRuntime.msi ADDLOCAL=RemoteRuntime,RemoteRuntimeTask命令安装UiPath 远程运行时组件。 - 从客户端计算机上的当前 Citrix 窗口、VMware Horizon 窗口或 RDP 会话注销，再重新登录。需要这一步操作，以便您的更改生效。
- Install either the UiPath Extension for Citrix, UiPath Extension for VMware Horizon, or the UiPath Extension for Windows Remote Desktop and Apps on the client machine, depending on the technology on which you want to create your automation projects.
此外，您可以使用 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 依赖项
The UiPath Remote Runtime has a dependency on the version of the UiPath.UIAutomation.Activities package, not on the version of UiPath Studio/Robot.
安装在远程计算机上的 Remote Runtime 必须具有您要在项目中使用的最新 UIAutomation 包版本，并且它与以前的 UIAutomation 版本兼容（向后兼容）。
The UiPath.UIAutomation.Activities package and the UiPath Remote Runtime have the same UiPath driver dependency. For each UIAutomation package released version, a download link for the UiPath Remote Runtime component with the same version number is provided.
可以从以下位置下载 UiPathRemoteRuntime.msi 安装程序：
- Product Downloads in the UiPath Customer Portal.
- Resource Center in the UiPath Automation Cloud. To access the Resource Center, you need to log in your Automation Cloud Organization, click the Help button on the toolbar and choose Resources > Downloads.
- Or you can request it through the Contact Technical Support page.
并行支持
The UiPath Remote Runtime component is installed on the Citrix Application server, VMware server, or Remote Desktop machine in the %ProgramFiles(x86)\UiPath folder. All installed versions are visible in the %ProgramFiles(x86)%\UiPath\RemoteRuntime\packages\uipath folder.
When you build or execute a process, you need to use a UiPath.UIAutomation.Activities package which is compatible with the deployed driver version of the UiPath Remote Runtime.
The version of the UiPath driver dependency for the UiPath.UIAutomation.Activities package is displayed in Studio, in the Package Manager info section.
The same UiPath version must be present on the remote machine, in the %ProgramFiles(x86)%\UiPath\RemoteRuntime\packages\uipath folder.
Each UiPathRemoteRuntime.msi installer contains the latest UiPath dependency, as well as the latest supported Long Term Support (LTS) UiPath dependencies.
The table below enlists the dependencies between the UiPath.UIAutomation.Activities package and UiPath Remote Runtime:
| UIAutomation package version | UiPathRemoteRuntime build number | UiPath driver dependency | UIAutomation compatible versions for UiPathRemoteRuntime |
|---|---|---|---|
| 22.10.5 | 22.10.53.5031 | 22.10.52.8892 | 22.10.5 22.4.8 21.10.8 20.10.13 19.11.5 18.4.8 |
| 22.10.3 | 22.10.46.47635 | 22.10.46.47635 | 22.10.3 22.4.7 21.10.7 20.10.12 19.11.5 18.4.8 |
| 22.4.8 | 22.4.52.11405 | 22.4.52.11405 | 22.4.8 21.10.8 20.10.13 19.11.5 18.4.8 |
| 22.4.7 | 22.4.42.61951 | 22.4.42.61951 | 22.4.7 21.10.7 20.10.12 19.11.5 18.4.8 |
| 21.10.8 | 21.10.49.13436 | 21.10.49.13436 | 21.10.8 20.10.13 19.11.5 18.4.8 |
| 21.10.7 | 21.10.42.64905 | 21.10.42.64905 | 21.10.7 20.10.12 19.11.5 18.4.8 |
| 20.10.13 | 20.10.8363.32849 | 20.10.8363.32849 | 20.10.13 19.11.5 18.4.8 |
| 20.10.12 | 20.10.8242.23238 | 20.10.8242.23238 | 20.10.12 19.11.5 18.4.8 |
| 19.11.5 | 19.10.7601.15369 | 19.10.7601.15369 | 19.11.5 18.4.8 |
| 18.4.8 | 10.0.7772.19184 | 10.0.7772.19184 | 19.11.5 18.4.8 |
You can verify the Remote Runtime build number from the UiPathRemoteRuntime.msi file Properties, in the Details tab, in the Comments field.
If you use a version of the UiPath.UIAutomation.Activities package that has a UiPath dependency which is not part of the set of installed UiPath dependencies on the remote machine, selectors are not generated and the following exception is thrown: The UiPath.UIAutomation.Activities package is incompatible with the UiPath Remote Runtime running on the server.
添加远程运行时依赖项
Interactive selection on the target application does not build correct selectors unless the UiPath.UIAutomation.Activities matches the UiPath Remote Runtime dependency on the Citrix Application server, VMware server, or the Remote Desktop machine.
For example, if you want to build an automation project using the UiPath.UIAutomation.Activities package version 21.10.7, you also need to copy the corresponding UiPath dependency from the client machine (where Studio is installed) on the Citrix Application server, VMware server, or the Remote Desktop machine.
操作方法如下：
- On the client machine (where Studio is installed), navigate to the
%UserProfile%\.nuget\packages\uipathfolder. All installed UiPath dependencies are located here. - Copy the version which corresponds to the UiPath.UIAutomation.Activities package you want to use. You can view the list of dependencies shipped with the UiPath.UIAutomation.Activities package on the About UIAutomation Activities page or by checking the package dependencies in Studio > Manage Packages.
- On the Citrix Application server, VMware server, or the Remote Desktop machine, navigate to the
%ProgramFiles(x86)%\UiPath\RemoteRuntime\packages\uipathfolder and paste the previously copied UiPath dependency version here.
现已使用当前版 UiPath.UIAutomation.Activities 生成恰当的选取器。复制依赖项后，更改即可生效。
设计时和执行时都需要上述 Remote Runtime 依赖项。
远程运行时架构
在启动流程时，机器人会通过 RPC 通道向 Citrix 扩展程序或 Windows 远程桌面扩展程序发出必要的命令。此信息包还包含用于构建流程的用户界面自动化包的版本详情。
相应的扩展程序随后通过 ICA 虚拟通道将此信息包转发给 Citrix 应用程序服务器或远程桌面机器上的 UiPath 远程运行时组件。
UiPath 远程运行时组件会根据构建流程所使用的用户界面自动化包版本，指示机器人执行程序应使用哪种驱动程序。
多个 ICA 通道
远程运行时组件与对应扩展程序之间的通信通过内部开发的 ICA 通道完成。您可使用多个 ICA 通道，但 Citrix Receiver 等程序已为剪贴板、音频及其他组件使用多个通道。
数据传输及带宽注意事项
安装远程运行时组件后，即可创建自动化项目，且无需创建任何防火墙规则。
远程运行时与扩展程序之间的数据传输只需使用少量带宽。例如，机器人执行的每个操作（如“单击”活动）约仅传输 3 KB 数据。
硬件和软件要求
The UiPath Remote Runtime has the same requirements as the UiPath Robot. See the full list of requirements here.
约一个月前更新