安装 UiPath Citrix 扩展程序后，您便能以原生方式自动化 Citrix Apps。您可通过 Studio 或“命令提示符”安装此扩展程序。

📘

重要提示：

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

安装 Citrix 扩展程序

从 UiPath Studio

1. 从“Studio 后台视图”中访问“工具”页面。您可以安装的扩展程序将显示出来。
2. 单击“Citrix”按钮。系统会显示确认对话框。
3. 重新启动所有 Citrix 应用程序以使更改生效。UiPath Citrix 扩展程序现已安装。

从命令提示符中

1. 单击“Windows 开始”按钮，然后在搜索字段中键入 cmd。
2. 右键单击“命令提示符”并以管理员身份运行。
3. 将目录更改为 UiPath 安装文件夹（企业版为 cd C:\Program Files\UiPath\Studio\UiPath，社区版为 cd %LocalAppData%\UiPath\app-19.x.x\UiPath\SetupExtensions.exe）。
4. 使用 SetupExtensions /CitrixClient 命令安装扩展程序。系统会显示确认对话框。
5. 重新启动所有 Citrix 应用程序以使更改生效。UiPath Citrix 扩展程序现已安装。

📘

备注：

若要为 Citrix 技术生成原生选取器，您还需在所有 Citrix 应用程序服务器上部署 UiPath 远程运行时组件，详情请参阅此页面。您可从此处请求获取 UiPathRemoteRuntime.msi 安装程序。

卸载 UiPath Citrix 扩展程序

1. 关闭所有正在运行的 Citrix Apps。
2. 单击“Windows 开始”按钮，然后在搜索字段中键入 cmd。
3. 右键单击“命令提示符”并以管理员身份运行。
4. 将目录更改为 UiPath 安装文件夹（企业版为 cd C:\Program Files\UiPath\Studio\UiPath，社区版为 cd %LocalAppData%\UiPath\app-19.x.x\UiPath\SetupExtensions.exe）。
5. 使用 SetupExtensions /CitrixClient /uninstall 命令卸载扩展程序。系统会显示确认对话框。
   Citrix 的 UiPath 扩展程序现已卸载。

常见问题

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 注册表键：‘SOFTWARE\Citrix\Install\ICA 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 应用程序留出加载时间。