配置指南

功能标志管理

功能标志用于动态启用或禁用功能。如果在生产环境中 Citrix Workspace™ 应用程序出现问题，即使功能已发布，受影响的功能也可以动态禁用。

如何配置

无需配置即可启用功能管理流量，除非防火墙或代理正在阻止出站流量。在这种情况下，您需要根据策略要求使用特定的 URL 或 IP 地址启用流量。

注意：

• 应用功能标志后，您将在下次启动 Citrix Workspace 应用程序后看到功能标志更新。即使在隐身模式下，您也将在下次启动后看到更新。

迄今为止，对于云客户，无法访问 StoreFront 来自定义适用于 HTML5 的 Citrix Workspace 应用程序。

为功能标志管理启用流量

对于 Citrix Workspace 应用程序版本 2409 及更高版本：

为确保最佳功能和对预览功能的访问，您需要启用到 URL features.netscalergateway.net 的流量。

已知问题和解决方法

如果您无法升级到适用于 HTML5 的 Citrix Workspace 应用程序 2409 或更高版本，并且在 2409 之前的版本中遇到以下功能不一致的问题，请按如下方式设置建议的配置值：

• 启动应用程序会话时，会话内可能会出现一个白条。作为解决方法，请禁用增强型应用程序切换器支持功能。有关配置的更多信息，请参阅增强型应用程序切换器支持。[CVADHELP-18625]

• 当您将适用于 HTML5 的 Citrix Workspace 应用程序 2308 或 2309 版本与 F5 负载均衡器结合使用时，会话会间歇性地启动失败或无响应。此问题发生在 2409 之前的版本中功能标志管理被弃用之后。作为解决方法：

  1. 导航到 StoreFront 服务器中的 C:\Program Files\Citrix\Receiver StoreFront\HTML5Client 并找到 configuration.js 文件。

  2. 导航到文件末尾并粘贴以下内容：

     //Script to disable CGP WASM
     Object.defineProperty(globalThis["HTML5_CONFIG"]["transport"], 'wasmCgpEnabled', {
     get() {
         return false;
         },
     set(value) {
         },
     configurable: true,
     enumerable: true,
     });
     <!--NeedCopy-->
     

  3. 单击“保存”。[RFHTMCRM-14936]

• 在多显示器设置中，在 ChromeOS 设备的第二个屏幕上键入字符会导致键盘发送双击。例如，按“t”会产生“tt”。[CVADHELP-27464]

  解决方法：

  将适用于 HTML5 的 Citrix Workspace 应用程序升级到版本 2409 或更高版本，并确保允许流量访问 URL features.netscalergateway.net。如果无法升级，请在配置设置中禁用 IME 多显示器功能：

   'features' : {
       'ime': {
           'multiMonitor' : false
           }
   }
   <!--NeedCopy-->
  

全局应用程序配置服务

管理员可以使用全局应用程序配置服务自定义在 Citrix Workspace 应用程序中启动的会话的用户设置。管理员可以为本地和 Workspace（云）部署自定义用户设置。

以前，管理员只能为此目的使用 configuration.js，并且它仅适用于 StoreFront 用户。

功能中的局限性

• 如果您在浏览器上安装了 AdBlock 扩展，全局应用程序配置服务设置可能无法按预期工作。[CVADHELP-23003]
• 自定义域 URL 功能不遵循全局应用程序配置服务 (GACS) 设置。

如何配置

适用于 Citrix Workspace 的全局应用程序配置服务允许 Citrix 管理员通过集中管理的服务交付 Workspace 服务 URL 和 Workspace 应用程序设置。

有关详细信息，请参阅 全局应用程序配置服务 文档。

注意：

• 此功能仅适用于工作区和基于 HTTPS 的商店。
• 要使全局应用配置服务正常工作，请验证您的用户可以访问 URL 。

剪贴板

在引入此功能之前，Citrix Workspace 应用程序不支持使用“选择性粘贴”功能从本地应用程序复制和粘贴 HTML 格式的文本到另一个应用程序。因此，目标应用程序（在本例中为 Microsoft Excel）将无法保留其 HTML 格式特性。

适用于 HTML5 的 Citrix Workspace 应用程序除了纯文本之外，还支持在客户端和会话之间使用 HTML 格式。此支持对于 Office 应用程序和浏览器非常有用。增强型剪贴板支持仅适用于 Chrome 和 Safari 浏览器。您可以复制 HTML 内容并保留格式。在 Chrome 中复制链接时，会以 HTML 格式添加一个 <img> 标签，这有效地允许您复制图像和文本。此 HTML 格式功能比纯文本更丰富，但并非适用于所有应用程序。

有关详细信息，请参阅 Citrix Virtual Apps and Desktops 文档中的客户端剪贴板重定向。

增强型剪贴板体验

您可以在会话和最终用户设备之间复制和粘贴文本。当您使用基于浏览器的适用于 HTML5 的 Citrix Workspace 应用程序在 Windows、Mac 或 Chrome 操作系统上启动多个 Virtual Desktops 托管应用程序或桌面时，可以执行此操作。

借助此功能，您可以使用 Ctrl C 和 Ctrl V 热键（适用于 Windows 或 Chrome 操作系统）以及 CMD C 和 CMD V 热键（适用于 Mac 操作系统）进行复制和粘贴。

此功能默认情况下处于启用状态。

在 Firefox 和 Edge 浏览器上，要将文本从远程会话复制到本地设备，请按 Ctrl C，然后单击“确认”。

通过选择工具栏上“首选项”中的“禁用复制确认”复选框来禁用复制确认对话框。清除该复选框可再次启用此选项。

如何禁用增强型剪贴板体验

To disable this feature, edit the configuration.js file located inside the HTML5Client folder (C:\Program Files\Citrix\Receiver StoreFront\HTML5Client) and set the value of directClipboard to false.

功能中的已知限制

• 您只能复制和粘贴 HTML、纯文本、图像，但不能复制和粘贴文件。
• 此功能不支持大数据。
• “Ctrl”键可能会保持按下状态。当您长时间按住右侧“Ctrl”键，然后按“C”复制文本时，会出现此问题。作为一种解决方法，请多次单击右侧“Ctrl”键。
• 有时，当您使用 Google Chrome、Safari、Edge 和 Firefox 浏览器时，复制文本需要通过“复制”确认对话框进行额外点击。
• 使用 Ctrl c 或 CMD C 和 Ctrl V 或 CMD V 键进行复制和粘贴。有时，使用“编辑”菜单或右键单击选项复制文本可能需要通过“确认”对话框进行额外点击。
• 右键单击功能仅在您从虚拟桌面和应用程序会话复制并粘贴到本地设备时有效。当您从本地设备复制并粘贴到虚拟桌面和应用程序会话时，此功能无效。

支持复制图像剪辑

现在，您可以使用标准键盘快捷方式在本地设备与虚拟桌面和应用程序会话之间复制和粘贴图像剪辑。在使用以下应用程序时，您可以使用标准键盘快捷方式进行复制和粘贴：

• Microsoft Word
• 微软画图
• 奥多比 Photoshop 图像编辑软件

以前，此功能仅适用于 Google Chrome 浏览器和带有 HTTPS 存储的 Microsoft Edge (Chromium) 浏览器中的文本。现在，此功能适用于文本和图像。它适用于 Google Chrome 浏览器和带有 HTTPS 存储的 Microsoft Edge (Chromium) 浏览器。

注意：

• 通常，出于安全原因，我们建议您仅使用基于 HTTPS 的商店。
• 由于网络带宽限制，当您尝试复制和粘贴大于 2 MB 的图像剪辑时，会话可能会变得无响应。
• 在微软 Windows 操作系统和 ChromeOS 设备中，使用 Ctrl + C 和 Ctrl + V 进行复制和粘贴。在苹果 Mac 设备中，使用 Command + C 和 Command + V 进行复制和粘贴。
• 右键单击功能仅在您从虚拟桌面和应用程序会话复制并粘贴到本地设备时有效。当您从本地设备复制并粘贴到虚拟桌面和应用程序会话时，此功能无效。
• 我们已使用 BMP、PNG、JPEG 和 GIF 格式测试了此功能。

剪贴板支持 HTML 格式

您可以使用 HTML 格式在虚拟桌面和端点设备之间执行剪贴板操作。复制 HTML 数据时，会复制源内容格式；粘贴数据时，目标内容会保留格式。此外，HTML 格式提供了更好的外观和体验。

有关如何设置策略的更多信息，请参阅 Citrix Virtual Apps and Desktops 文档中的 客户端剪贴板写入允许的格式。

切换应用程序

此功能允许最终用户在同一会话中切换多个已发布的应用程序。当您打开或关闭应用程序时，应用程序计数会相应更新。如果某些应用程序在另一个会话中打开，则应用程序计数会包括所有已打开的应用程序。

注意：

此功能默认是启用的。

如何使用

您可以使用应用切换功能，在浏览器选项卡中轻松切换应用程序。此功能有两种模式：

• 任务栏模式
• 网格视图模式

任务栏模式

此模式优化了在笔记本电脑和台式机等大屏幕上运行的会话。对于从同一 VDA 启动的应用程序，任务栏允许在应用程序之间轻松导航。

任务栏显示会话中当前活动的所有应用程序，允许用户轻松地在它们之间切换。在应用切换器的右键菜单中，用户有两个首选项选项，这些选项会在下次启动时记住。

• 自动隐藏：应用切换器在不使用时自动隐藏任务栏，当用户将鼠标指针悬停在屏幕底部时重新出现。
• 仅显示图标：仅显示应用程序图标，其标题被隐藏。

网格视图模式

此模式优化了在移动设备或触摸设备上运行的会话。要显示网格，请触摸或点击工具栏中的切换应用图标。

网格视图显示从同一 VDA 启动的应用程序，与常规任务栏相比，为移动设备用户提供了更清晰、更大的视图。此外，还有一个选项可以启用或禁用应用程序切换器任务栏，允许用户根据需要调整视口大小。

网格视图(/zh-cn/citrix-workspace-app-for-html5/media/grid-view.png)

增强的应用程序切换器支持

在全屏或信息亭模式下启动已发布的应用程序会话时，会话不会与桌面任务栏重叠。应用程序切换器不再隐藏会话。此增强功能仅在单显示器模式下受支持。

注意：

此功能在默认情况下是启用的。

如何配置

您可以通过以下方式禁用此功能：

• 配置.js
• 全局应用程序配置服务

配置.js

在适用于 HTML5 的 Citrix Workspace 应用程序中，configuration.js 文件位于 C:\Program Files\Citrix\Receiver StoreFront\HTML5Client 文件夹下。编辑此文件以配置此功能。

注意：

• Citrix 建议您在修改 configuration.js 文件之前对其进行备份。
• 编辑 configuration.js 文件需要管理员级别的凭据。

要禁用此功能：

1. 导航到 HTML5Client 文件夹中的 configuration.js 文件。

2. 添加 enhancedAppswitcher 属性并将该属性设置为 false。例如：

   'ui': {
       'appSwitcher': {
           'enhancedAppSwitcher': false
       }
   }
   <!--NeedCopy-->
   

注意：

configuration.js 文件位于 StoreFront 计算机上的 C:\Program Files\Citrix\Receiver StoreFront\HTML5Client 文件夹中。

全局应用程序配置服务

在云设置中，管理员可以通过将 Enhanced App Switcher Support 属性设置为 False 来禁用增强型应用程序切换功能。

改进的虚拟应用程序和桌面启动体验

从 2306 版本开始，改进的应用程序和桌面启动体验可提供有关启动状态的及时相关信息。

注意：

管理员必须升级 HDX SDK 文件才能使用适用于 HTML5 2306 版本的 Citrix Workspace 应用程序。较旧的 HDX SDK 文件与 2306 版本及更高版本不兼容。要下载最新的 HDX SDK 文件，请单击此处。有关详细信息，请参阅 适用于 HTML5 HDX SDK 的 Citrix Workspace 应用程序 开发人员文档。

配置会话启动通知的显示方式

从 2307 版本开始，管理员可以使用以下配置启用或禁用启动进度通知的显示。如果启用此配置，您将在屏幕右下角看到会话启动进度通知。如果禁用此配置，您将无法看到会话启动进度通知。

注意：

• 默认情况下，此配置已启用。

启用通知后，将显示以下屏幕截图。

当通知被禁用时，以下屏幕截图将会显示。

如何配置

您可以通过以下方式配置此功能：

在适用于 HTML5 的 Citrix Workspace 应用程序中，configuration.js 文件位于 C:\Program Files\Citrix\Receiver StoreFront\HTML5Client 文件夹中。编辑此文件以配置该功能。

注意：

• Citrix 建议您在修改 configuration.js 文件之前对其进行备份。
• 编辑 configuration.js 文件需要管理员级别的凭据。

要禁用此功能，请执行以下操作：

1. Navigate to the configuration.js file in the HTML5Client folder.

2. 添加 CTXTUI 属性并将其设置为 false。

   以下是 JSON 数据示例：

   {
    "vc_channel": {
    "CTXTUI": false
     }
   }
   <!--NeedCopy-->
   

3. 保存更改。

阻止全局应用配置服务 (GACS) 请求的配置

借助 2509 版本，管理员可以使用 configuration.js 文件针对本地应用商店阻止全局应用配置服务 (GACS) 请求。属性名称为 disableGACS。当您将此属性设置为 true 时，Citrix Workspace 应用程序不会连接到任何 GACS 端点。

注意：

默认情况下，属性 disableGACS 被设置为 false。

如何配置

注意：

• Citrix 建议您在进行更改之前备份 configuration.js 文件。
• 编辑 configuration.js 文件需要管理员级别的凭据。
• configuration.js 文件可以在 C:\Program Files\Citrix\Receiver StoreFront\HTML5Client 文件夹中找到。

To set disableGACS to true using configuration.js:

1. Navigate to the configuration.js file.

2. Add the disableGACS setting and set the disableGACS attribute to true.

   以下是 JSON 数据示例：

   {
     "thirdPartyServices": {
           "disableGACS": true
             }
   }
   <!--NeedCopy-->
   

3. 保存更改。

用于阻止功能标志请求的配置

通过 2509 版本，管理员可以使用 configuration.js 阻止本地商店的功能标志请求。属性名称为 disableFeatureFlag。当您将此属性设置为 true 时，Citrix Workspace 应用程序不会连接到任何功能标志端点。

注意：

The attribute disableFeatureFlag is set as false by default.

如何配置

注意：

• Citrix 建议您在进行更改之前备份 configuration.js 文件。
• 编辑 configuration.js 文件需要管理员级别的凭据。
• The configuration.js file is located under the C:\Program Files\Citrix\Receiver StoreFront\HTML5Client folder.

To set disableFeatureFlag to true using configuration.js:

1. Navigate to the configuration.js file.

2. Add the disableFeatureFlag setting and set the disableFeatureFlag attribute to true.

   以下是 JSON 数据示例：

   {
     "thirdPartyServices": {
           "disableFeatureFlag": true
             }
   }
   <!--NeedCopy-->
   

3. 保存更改。