Citrix 版扩展程序

安装 Citrix 扩展程序后，您可以原生地自动化 Citrix Apps。您可通过 Studio 或命令提示符安装此扩展程序。

备注：

• 自动化 Citrix Workspace v2409 或更高版本需要 UiPath.UiAutomation.Activities v24.10.11 或更高版本。

• 您需要为每台计算机安装 Citrix 客户端（Citrix Receiver 或 Citrix Workspace），以便能够安装适用于 Citrix 的 UiPath 扩展程序。

从 UiPath Studio

1. 打开 Studio。
2. 导航至“主页”>“工具”>“UiPath 扩展程序”。
3. 选择“Citrix”>“安装”。系统会显示确认对话框。
4. 重新启动所有 Citrix 应用程序，使更改生效。

UiPath Citrix 扩展程序现已安装到 Citrix 安装目录中。

从命令提示符中

1. 单击 Windows 开始按钮，然后在搜索字段中键入 cmd。
2. 右击命令提示符并以管理员身份运行。
3. 将目录更改为 UiPath 安装文件夹（对于按计算机安装，路径为 cd C:\Program Files\UiPath\Studio\UiPath；对于按用户安装，则为 cd %localappdata%\Programs\UiPath\Studio\UiPath）。
4. 使用 SetupExtensions /CitrixClient 命令安装扩展程序。系统会显示确认对话框。
5. 重新启动所有 Citrix 应用程序以使更改生效。UiPath Citrix 扩展程序现已安装。
   Note: To generate native selectors for Citrix technology, you also need to deploy the UiPath Remote Runtime component on all your Citrix Application servers, as explained on this page. The UiPathRemoteRuntime.msi installer is obtained by requesting it here.

卸载 UiPath Citrix 扩展程序

来自 Studio

1. 打开 Studio。
2. 导航至“主页”>“工具”>“UiPath 扩展程序”。
3. 选择“Citrix”>“卸载”，然后确认您的选择。

Citrix 的 UiPath 扩展程序现已卸载。

使用命令行

1. 关闭所有正在运行的 Citrix Apps。
2. 单击 Windows 开始按钮，然后在搜索字段中键入 cmd。
3. 右击命令提示符并以管理员身份运行。
4. 将目录更改为 UiPath 安装文件夹（对于按计算机安装，路径为 cd C:\Program Files\UiPath\Studio\UiPath；对于按用户安装，则为 cd %localappdata%\Programs\UiPath\Studio\UiPath）。
5. 使用 SetupExtensions /CitrixClient /uninstall 命令卸载扩展程序。系统会显示确认对话框。

Citrix 的 UiPath 扩展程序现已卸载。

故障排除

本页介绍如何解决在 Citrix 环境中运行自动化时可能遇到的问题。

Citrix Apps 中交互式选择冻结并且任何对象均未选中

观察到的行为

安装 UiPath Citrix 扩展程序并尝试从 Citrix App 中选择用户界面元素后，交互式选取会冻结一分钟，随后所有对象都将取消选中。

原因

如果 Citrix 应用程序会话中没有运行 UiPath 远程运行时，就会出现这种情况。

解决方案

• 在打开 Citrix 应用程序的 Citrix 应用程序服务器上，检查是否安装了 UiPathRemoteRuntime.msi。

• 在 Citrix 应用程序服务器上，检查 UiPathRemoteRuntime.exe 进程是否正在运行。如果已安装 UiPathRemoteRuntime.msi，则该流程将在 Citrix 应用程序会话登录时自动启动。

  
  

  

  
  
  注意：如果您无法在 Citrix 应用程序服务器上安装 UiPathRemoteRuntime.msi，我们建议从客户机中卸载 UiPath Citrix 扩展程序，如此处所述。

无法复制文件“C:\Program Files (x86)\Citrix\ICA Client\UIPathPluginCitrix.dll”。另一个进程正在使用此文件。

观察到的行为

尝试安装 UiPath Citrix 扩展程序时，系统将显示以下错误：

原因

若已安装 UiPath Citrix 扩展程序且某个打开的 Citrix App 正在使用此扩展程序，则会出现此错误。

解决方案

关闭所有处于活动状态的 Citrix App 会话（如此处所述），然后再次尝试安装 UiPath Citrix 扩展程序。

无法读取 Citrix 注册表键：“SOFTWARECitrixInstallICA Client”值：“InstallFolder”

观察到的行为

尝试安装 UiPath Citrix 扩展程序时，系统将显示以下错误：

原因

如果未安装 Citrix Receiver，就会显示此错误消息。如果未安装 Citrix Receiver for Universal Windows Platform，也会显示此消息。

解决方案

下载并安装 Citrix Receiver 或 Citrix Workspace。

wfica32.exe 0xC0000094 中的未处理异常：整数除零

观察到的行为

目标 Citrix 应用程序无法启动，Citrix ICA 客户端崩溃。

原因

使用 GetWindowText 函数的活动（如“存在元素”）在 Citrix 应用程序可以加载之前执行。

解决方案

通过添加活动前的延迟，为 Citrix 应用程序留出加载时间。