更新
对自动更新计划的支持
从版本 2411 开始,管理员可以在方便的时间为 Citrix Workspace™ 应用程序安排自动更新。此功能允许他们确定推出周期,最大程度地减少对最终用户的影响,并提高自动更新服务的采用率,该服务以前由 Citrix 控制。
最终用户在管理员安排的时间接收 Citrix Workspace 应用程序的自动更新,确保更新按计划进行。管理员可以通过以下方式控制 macOS 上的更新:
- 管理员可以设置适用于 macOS 的 Citrix Workspace 应用程序更新的日期和时间范围。
- 客户管理员设置的计划更新优先于 Citrix Catalog 中定义的任何推出周期。
您可以使用移动设备管理 (MDM) 和全局应用程序配置服务 (GACS) 配置此功能。
使用 MDM:
<array>
<dict>
<key>AutoUpdateSchedulerSettings</key>
<string>
{
"startTime":"20:30",
"endTime":"23:30",
"deferCount":"4"
}
</string>
<key>PayloadDisplayName</key>
<string>Citrix Workspace #1</string>
<key>PayloadIdentifier</key>
<string>com.citrix.receiver.nomas</string>
<key>PayloadType</key>
<string>com.citrix.receiver.nomas</string>
<key>PayloadUUID</key>
<string>3BE38AD3-7D95-423F-BD7B-8A4D1F5208EF</string>
<key>PayloadVersion</key>
<integer>1</integer>
</dict>
</array>
<!--NeedCopy-->
Using GACS:
- 导航到 工作区配置 > 应用配置 > URL 配置。
- 单击 思杰工作区应用程序版本 并配置所需设置。
- 接下来,单击 自动更新时间范围 > 编辑 以定义自动更新触发器发生的时间窗口。
- 输入所需值。延迟天数指定最终用户可以延迟自动更新的次数。
有关详细信息,请参阅 自动更新时间范围。
活跃用户的自动更新增强功能
从适用于 Mac 的 Citrix Workspace 应用程序 2411 版本开始,自动更新功能得到了增强,仅针对活动用户触发,确保更新仅适用于具有全局应用程序配置服务 (GACS) 或移动设备管理 (MDM) 策略的用户,或那些正在积极使用该应用程序的用户。在此基础上,2505 版本通过引入定义活动用户的附加条件,进一步完善了自动更新功能。此增强功能通过仅将自动更新功能应用于符合更新活动条件的用户,提供更精确和受控的更新,从而在更新过程中提供更大的灵活性和控制。
如果满足以下任一条件,则用户被视为活动用户:
- 用户已启动至少一个会话(桌面、Citrix Virtual 应用程序或 SaaS 应用程序)。
- 用户已登录到本机 Citrix Workspace 应用程序,从而可以将更新定向到那些积极使用该应用程序的用户。
- 已为自动更新版本控制配置了移动设备管理 (MDM) 策略,确保具有特定更新策略的受管环境中的设备及时接收更新。
- 用户是受管用户,其系统和配置文件由 IT 管理员控制和维护,并且已添加具有全局应用程序配置服务 (GACS) 设置的商店。
如果不满足这些条件,则用户被视为非活动用户,并且自动更新功能不可用。当用户从非活动状态转换为活动状态时,应用程序会触发自动更新功能(如果适用),确保应用程序是最新的。
用户组的自动更新支持
从 2411 版本开始,客户可以通过全局应用程序配置服务 (GACS) 中的配置配置文件为不同的用户组配置不同的应用程序版本。有关详细信息,请参阅自动更新管理设置支持配置配置文件。
手动更新
要手动更新适用于 Mac 的 Citrix Workspace 应用程序,请从Citrix 下载页面下载并安装最新版本的应用程序。
自动更新
当 Citrix Workspace 应用程序发布新版本时,Citrix 会将更新推送到已安装 Citrix Workspace 应用程序的系统上。您会收到可用更新的通知。
注意:
- 如果您已配置 SSL 拦截出站代理,请将 Workspace 自动更新服务器
https://downloadplugins.citrix.com/添加到例外中,以接收来自 Citrix 的更新。- 自动更新不适用于早于 2301.1 版本的 Citrix Workspace 应用程序。有关详细信息,请参阅知识中心文章 CTX491310。
- 您的系统必须连接到互联网才能接收更新。
- Workspace for web users can’t download the StoreFront policy automatically.
- Citrix HDX RTME for macOS is included in Citrix Workspace Updates. You’re notified of the available HDX RTME update on the Citrix Workspace app.
- 从版本 2111 开始,Citrix Workspace 更新日志路径已修改。Workspace 更新日志位于
/Library/Logs/Citrix Workspace Updater。有关收集日志的信息,请参阅日志收集部分。
支持限制用户修改更新通道的功能
以前,用户可以使用“高级”设置中提供的“选择更新通道”选项将更新通道修改为发布版或测试版。
从 2409 版本开始,适用于 Mac 的 Citrix Workspace 应用程序允许管理员管理“选择更新通道”选项。借助此功能,您可以控制更新通道首选项,确保最终用户无法修改它。这可确保更新通道根据您的管理设置保持一致和安全。

您可以通过全局应用程序配置服务 (GACS)、移动设备管理 (MDM) 和 web.config 文件配置此功能。
使用 MDM
要为发布版或测试版通道推送自动更新,管理员必须使用以下设置:
<key>AutoUpdateChannel</key><string>release</string>
或
<key>AutoUpdateChannel</key><string>beta</string>
web.config 文件的使用方法
要为发布或 Beta 通道推送自动更新,请执行以下步骤:
- 使用文本编辑器打开 web.config 文件,该文件通常位于
C:\inetpub\ wwwroot\Citrix\Roaming目录中。 -
在文件中找到用户帐户元素(Store 是您的部署的帐户名称)。 例如:
<account id=... name="Store"> -
导航到该用户帐户的属性,并在 </account> 标记之前添加以下属性:
<property name=“autoUpdateChannel” value=“release” /><property name=“autoUpdateChannel” value=“beta” />
安装 Citrix Workspace 应用程序测试版计划
当 Citrix Workspace 应用程序配置为自动更新时,您会收到更新通知。要在系统上安装 Beta 版本,请执行以下步骤:
- 打开 思杰工作区应用程序。
- 右键单击工具栏中的 Citrix Workspace,然后单击“首选项”>“高级”。
-
当 Beta 版本可用时,从下拉列表中选择“Beta”。

要从 Beta 版本切换到发布版本,请执行以下步骤:
- 打开 思杰工作区应用程序。
- 右键单击工具栏中的 Citrix Workspace,然后单击“首选项”>“高级”。
-
从“选择更新通道”下拉列表中选择“发布”。

注意:
客户可以在其非生产或有限生产环境中测试 Beta 版本,并分享反馈。Citrix 不接受针对 Beta 版本的支持案例,但欢迎提供反馈以改进这些版本。Citrix 可能会或可能不会根据反馈的严重性、关键性和重要性采取行动。建议您不要在生产环境中部署 Beta 版本。
自动更新版本控制
管理员现在可以管理组织中设备的 Citrix Workspace 应用程序的自动更新版本。 管理员可以通过在全局应用程序配置服务中设置 maximumAllowedVersion 和 minimumAllowedVersion 属性的范围来控制版本。
全局应用程序配置服务中的 JSON 文件示例:
{
"serviceURL": {
"url": "https://serviceURL:443"
},
"settings": {
"name": "Version Control for Citrix Workspace",
"description": "Provides admin ability to Version Control for Citrix Workspace",
"useForAppConfig": true,
"appSettings": {
"macos": [
{
"category": "AutoUpdate",
"userOverride": false,
"assignedTo": [
"AllUsersNoAuthentication"
],
"settings": [
{
"name": "Auto update plugins settings",
"value": [
{
"pluginName": "Citrix Workspace",
"pluginId": "D99C3E77-FBF5-4B97-8EDA-4E381A1E0826",
"pluginSettings": {
"deploymentMode": "Update",
"upgradeToLatest": false,
"minimumAllowedVersion": "23.07.0.63",
"maximumAllowedVersion": "23.07.0.63",
"delayGroup": "Medium",
"detectRule": ""
}
}
]
}
]
}
]
}
}
}
<!--NeedCopy-->
设置范围后,用户设备上的 Citrix Workspace 应用程序将自动更新到介于指定范围内的最高可用版本。
如果您想将 Citrix Workspace 应用程序自动更新到特定版本,请在全局应用程序配置服务中的 maximumAllowedVersion 和 minimumAllowedVersion 属性中输入相同的版本。
注意:
- To enable auto-update version control, set the upgradeToLatest setting to false in the Global App Configuration service. If the upgradeToLatest setting is true, maximumAllowedVersion and minimumAllowedVersion is ignored.
- 请勿修改插件ID。插件ID已映射到 Citrix Workspace 应用程序。
- 如果管理员未在全局应用程序配置服务中配置版本,则 Citrix Workspace 应用程序将默认更新到最新可用版本。
- 您只能使用为更新 Citrix Workspace 应用程序设置的版本范围。但是,不支持降级。
- 此功能从版本 2307 开始受支持。
改进的自动更新体验
自动更新功能可将 Citrix Workspace 应用程序自动更新到最新版本,无需任何用户干预。
Citrix Workspace 应用程序会定期检查并下载最新可用版本。Citrix Workspace 应用程序会根据用户活动确定最佳安装时间,以避免造成任何中断。
自动更新的高级配置 (Citrix Workspace 更新)
您可以使用以下方法配置 Citrix Workspace 更新:
- 图形用户界面 (GUI)
- 全局应用程序配置服务 (GACS)
- 移动设备管理 (MDM)
- 思拓方
使用图形用户界面配置 Citrix Workspace 自动更新
个人用户可以使用“高级”首选项对话框覆盖 Citrix Workspace 更新设置,这是一个按用户配置,并且设置仅适用于当前用户。要使用 GUI 配置更新,请执行以下步骤:
- 在 Mac 上选择 Citrix Workspace 应用程序助手图标。
- 从下拉列表中,选择“首选项 > 高级 > 更新”。
- 选择要安装自动更新的版本。它可以是 Apple Silicon 或 Intel 版本(仅适用于使用 Apple 芯片 (M1 系列) 的 Mac 用户)。

使用思拓方配置 Citrix Workspace 自动更新
-
使用文本编辑器打开
web.config文件,该文件通常位于C:\inetpub\wwwroot\Citrix\Roaming directory。 -
在文件中找到用户帐户元素(Store 是您的部署的帐户名称)。
例如:
<account id=... name="Store">在
</account>标记之前,导航到该用户帐户的属性:<properties> <clear/> </properties> <!--NeedCopy--> -
在 <clear /> 标记之后添加自动更新标记。
<account> <clear /> <account id="d1197d2c-ac82-4f13-9346-2ee14d4b0202" name="F84Store" description="" published="true" updaterType="Citrix" remoteAccessType="None"> <annotatedServices> <clear /> <annotatedServiceRecord serviceRef="1__Citrix_F84Store"> <metadata> <plugins> <clear /> </plugins> <trustSettings> <clear /> </trustSettings> <properties> <property name="Auto-Update-Check" value="Disabled" /> <property name="Auto-Update-DeferUpdate-Count" value="1" /> <property name="Auto-Update-Rollout-Priority" value="fast" /> <property name="Auto-Update-Architecture" value="Universal" or "Intel" /> </properties> </metadata> </annotatedServiceRecord> </annotatedServices> <metadata> <plugins> <clear /> </plugins> <trustSettings> <clear /> </trustSettings> <properties> <clear /> </properties> </metadata> </account> <!--NeedCopy-->
属性的含义及其可能的值详细信息如下所示:
-
自动更新检查:表示 Citrix Workspace 应用程序在可用时自动检测更新。
- 自动(默认)– 自动检查并执行更新
- 手动 – 仅当用户从 Citrix Workspace 应用程序系统托盘菜单发出检查请求时才获取更新,
- 禁用 – 不执行更新检查。
-
自动更新发布优先级:指示您可以接收更新的交付期。
- 快速 – 更新会在交付期的早期阶段向用户推出。
- 中等 – 更新在交付期中期向用户推出。
- 慢速 – 更新在交付期结束时向用户推出。
-
Auto-Update-DeferUpdate-Count:指示您可以推迟接收更新通知的最大次数。
注意:
此配置仅适用于交互式更新,不适用于启用静默自动更新功能的情况,因为用户无法选择推迟更新。
- -1:用户可以无限次推迟自动更新。
- 0:用户无法查看稍后提醒选项。
- number:用户可以查看具有给定次数的稍后提醒选项。
Configure Citrix Workspace automatic updates using the GACS
管理员可以使用 GACS 通过以下设置将自动更新配置为 Apple Silicon 或 Intel 版本:
“name”:“autoUpdateArchitecture”
“value”:“通用” 或 “英特尔”
使用移动设备管理配置思杰工作区自动更新
管理员可以使用 MDM 通过以下设置将自动更新配置为 Apple Silicon 或 Intel 版本:
<key>AutoUpdateArchitecture</key>
<string>Universal</string> or <string>Intel</string>
<key>AutoUpdateState</key>
<string>Auto</string> or <string>Manual</string> or <string>Disabled</string>
有关如何使用 MDM 的更多信息,请参阅 移动设备管理。
日志收集
日志收集简化了 Citrix Workspace 应用程序日志的收集过程。这些日志有助于 Citrix 进行故障排除,并在遇到复杂问题时提供支持。
您可以使用 GUI 收集日志。
收集日志:
- 打开 思杰工作区应用程序。
- 右键单击工具栏中的 Citrix Workspace,然后单击首选项 > 高级。
-
选择日志记录。

- 选择以下会话日志级别之一:
- 已禁用(默认):收集最少日志以进行基本故障排除。
- 连接诊断:识别连接时发生的错误。在会话被视为成功之前,所有日志记录都将启用。
- 完整:捕获所有内容,包括连接诊断。启用后,Citrix Workspace 应用程序将存储最多 10 个会话日志,之后会从最旧的日志开始删除,以保持 10 个日志。
注意:
选择完整日志记录选项可能会影响性能,并且由于数据量大,只能在排查问题时使用。请勿在正常使用期间启用完整日志记录。启用此级别的日志记录会触发一个警告对话框,您必须确认才能继续。
- 选择以下商店日志级别之一:
- 已禁用(默认):收集最少日志以进行基本故障排除。
- 正常:仅收集商店通信日志。
- 详细:收集详细的身份验证和商店通信日志。
- 单击通过电子邮件发送日志文件以收集日志并将其作为 .zip 文件共享。
用于虚拟应用和桌面会话的增强型通用架构版本
从 2311 版本开始,通用架构版本现在可以自动选择以原生 Apple Silicon 模式或 Intel 模式运行虚拟会话。它使用 Rosetta 仿真在 Intel 模式下启动虚拟会话。如果虚拟通道 SDK 是基于原生 Apple Silicon 架构构建的,或者没有虚拟通道 SDK,则虚拟会话将在原生 Apple Silicon 模式下启动。但是,如果虚拟通道 SDK 是基于 x86_64 Intel 架构构建的,则虚拟会话将使用 Rosetta 仿真在 Intel 模式下启动。
通用架构版本的此项增强改进了配备 Apple Silicon 芯片组的 Mac 上的启动体验。对于配备 Intel 芯片组的 Mac 用户,没有变化,通用架构版本将继续以原生方式运行虚拟会话。