故障排除

如何检查应用程序版本

要了解您正在使用的 Citrix Workspace 应用程序版本，请参阅帮助文档中的文章 如何检查应用程序版本。

如何升级到最新版本

要手动将 Citrix Workspace 应用程序升级到最新版本，请执行以下操作：

1. 打开 Play 商店。

2. 搜索 思杰工作区。

   如果有可用更新，请点击更新。

自动更新应用程序

默认情况下，满足以下条件时，应用程序会自动更新：

• 设备已连接到 Wi-Fi 网络。
• 设备正在充电。
• 设备处于空闲状态（未被主动使用）。
• Citrix Workspace 应用程序未在前台运行。

注意：

Google Play 商店每天检查一次应用更新。因此，应用更新可能需要长达 24 小时才能添加到更新队列中。应用添加到队列后，在满足条件时，它将在下次自动更新。

如何重置 思杰工作区应用程序

要重置应用程序，您可以执行以下操作之一：

• 清除 Citrix Workspace 应用程序存储数据。转到 Android 设备上的设置 > 应用 > 选择 Citrix Workspace 应用程序 > 存储 > 清除缓存。

  或

• 卸载 Citrix Workspace 应用程序，然后从 Google Play 安装已包含最新修复的适用于 Android 的最新版本。

注意

从 Citrix Workspace 应用程序中删除现有帐户会重置帐户，而不是重置 Citrix Workspace 应用程序本身。

如何收集日志

日志收集很重要，因为它可以帮助识别问题。从 24.3.5 版本开始，日志文件现在包含更全面的信息，可以帮助 IT 管理员和客户支持团队更好地分析情况。

有关详细信息，请参阅帮助文档中的文章 如何收集日志。

如何提供反馈

您可以使用相同的界面向我们发送有关 Citrix Workspace 应用程序（适用于 Android）的反馈并报告问题。有关详细信息，请参阅帮助文档中的文章 如何提供反馈。

如何请求增强功能

要请求 Citrix Workspace 应用程序（适用于 Android）的功能增强，请填写 Google 表单。

如何访问技术预览功能

要了解技术预览功能，请参阅技术预览中的功能。

如何提供有关 EAR 的反馈

您可以提供关于早期访问版本的反馈，链接如下：https://forms.gle/joYc7K5teg4zcWNr7。

常见问题和故障排除技巧

安装失败问题

如果 Android TV 默认不支持 Citrix Workspace 应用程序，请通过增强请求联系我们。

身份验证和应用商店添加

如果您发现身份验证或应用商店添加方面的问题，请检查以下内容。

无效输入

您可能输入了：

• 提供的凭据无效
• 不正确的应用商店 URL
• 输入凭据和应用商店 URL 时出现拼写错误
• 使用 HTTP 协议而非 HTTPS。

网页界面模式

您也可以尝试使用 Web Interface 模式。在应用程序的第一页上，点击开始。在欢迎页面上，输入商店 URL 并启用将帐户类型添加为 Web Interface。

智能卡

如果智能卡身份验证不起作用，请安装 baiMobile Credentials 应用程序。如果 baiMobile Credentials 应用程序检测到您的智能卡，请联系我们以进一步调查此问题。

NetScaler® policy configurations

要解决连接问题，请参阅知识中心文章 适用于移动设备的 NetScaler Gateway。

会话启动

要查看会话统计信息：

• 在会话工具栏中，点击鼠标指针图标四次

  或

• 在会话终端中运行 ctxsession -v 命令。

无法启动桌面

要进行故障排除，请参阅以下知识中心文章：

• 错误代码 2524

• 错误代码 2523

• 错误代码 2502(https://support.citrix.com/article/CTX255861/failed-to-launch-session-sessionname-error-code-2502-on-citrix-workspace-app-during-appdesktop-launch?recommended)

• 错误代码 2517

访问外设所需的权限

启用正确的设置权限。

客户端选择性信任

启用麦克风、位置和摄像头的设置。转到 Citrix Workspace 应用程序设置 > 应用商店设置，并为选定的应用商店启用 CST 设置。

启用鼠标指针

启动会话后，轻按工具栏，然后轻按鼠标指针图标以启用鼠标指针。

启用键盘

如果您的组织管理员尚未默认启用自动键盘显示功能，请联系您的组织管理员以获得进一步帮助。

管理员必须在 DDC 设置中启用自动键盘显示策略。

自动键盘策略(/zh-cn/citrix-workspace-app-for-android/media/automatic-keyboad-display-policy.png)

已越狱的设备

越狱设备是指其所有者已对其进行修改的设备，通常是为了绕过安全保护。当用户连接越狱的 Android 设备时，它们会对您的部署构成安全风险。当适用于 Android 的 Citrix Workspace 应用程序对越狱的 Android 设备进行基本检测时，该应用程序会向用户显示警报。

警报(/zh-cn/citrix-workspace-app-for-android/media/jailbroken-alert.png)

为了进一步帮助保护您的环境，您可以配置 StoreFront™ 或 Web Interface，以帮助阻止检测到的越狱设备运行应用程序。

注意：

如果 Citrix Workspace™ 应用程序检测到越狱设备，它会自行停用以保护数据并维护安全性。这确保了该应用程序不能在未经授权修改的设备上使用。

要求：

• 适用于安卓的 Citrix 工作区应用程序 24.7.0 或更高版本。
• 通过管理员帐户访问应用商店或 Web 界面。

有关详细信息，请参阅越狱设备。

始终开启跟踪 (AOT)

从版本 26.3.0 (2603) 开始，适用于 Android 的 Citrix Workspace 应用程序支持始终开启跟踪 (AOT)，持续捕获用户会话和系统事件的可读诊断日志，以简化故障排除并减少对 Citrix 支持的依赖。

有关详细信息，请参阅 Citrix 虚拟应用和桌面™ 文档中的从 Citrix 虚拟应用和桌面 核心组件上传 AOT 日志。

常见问题

• 如何改善低功耗设备或移动设备的虚拟应用和虚拟桌面视频用户体验？

  • 有关更多信息，请参阅视频用户体验知识中心文章。

• 访问资源 - 登录 Citrix Workspace 应用程序后，我无法看到我的应用程序或桌面？

  • 请联系您公司的帮助台或 IT 支持团队管理员以获得进一步的帮助。

• 如何排查连接缓慢的问题？

  • 如果您遇到以下任何问题，请遵循此变通办法：

  • 到 Citrix 虚拟应用和桌面 站点的连接速度缓慢
  • 应用程序图标缺失
  • 反复出现 协议驱动程序错误 消息

  变通办法：

  • 禁用以下设备上网络接口的 Citrix PV 以太网适配器属性：

  • 思杰虚拟应用™ 服务器
  • Citrix 安全网络网关™

  • Web 界面服务器

  • Citrix PV 以太网适配器属性包括（默认全部启用）：

  • 大量发送卸载
  • 卸载 IP 校验和
  • 卸载 TCP 校验和
  • 卸载 UDP 校验和

  无需重新启动服务器。此解决方法适用于 Windows Server 2003 和 2008 32 位版本。此问题不影响 Windows Server 2008 R2。

• 数字键和特殊字符使用方面的问题

  • 如果数字键或中文 IME 字符无法正常工作，请禁用“Unicode 键盘”选项。为此，请转到“设置”>“键盘选项”> 并将“使用 Unicode 键盘”设置为“已禁用”。

故障排除错误代码

下表提供了错误代码及其可能的解决方案列表：

错误消息及其描述

下表列出了错误及其描述。可能的解决方案是联系 Citrix 技术支持 以获取进一步的帮助：

Citrix 连接故障排除

Citrix 连接故障排除功能旨在赋能最终用户，使其能够有效地自行排除潜在的桌面或应用程序启动失败。此增强功能旨在为用户提供清晰的诊断、潜在的建议以及通过简单点击运行修复的能力。

工作原理

此功能提供更精细和增强的错误消息，以帮助用户清楚地了解启动失败的根本原因。连接故障排除功能在启动过程中实时分析与虚拟投递代理 (VDA) 的连接问题。然后，它会提供用户友好的错误消息和建议，使用户能够直接解决问题，或在需要时收集日志以提交支持工单。

分析的连接路径

此功能诊断跨关键连接点的潜在虚拟应用程序和桌面启动问题，包括：

• 从客户端到网关的网络连接。
• 网关到 StoreFront 服务器的连接。
• 店面服务器到代理的连接。
• 代理到 VDA 的连接。

增强的错误消息和诊断

在启动失败的情况下，Citrix 现在会显示清晰、用户友好的错误消息，精确定位特定的连接问题，例如网络错误、服务器不可用或 VDA 故障。对于管理员，日志中提供了详细的错误代码，分为服务器端错误和客户端错误，作为深入调查的宝贵参考。

自我恢复以及补救行动

Citrix 故障排除连接功能包含用户可以采取的步骤，以自动从常见问题中恢复，从而最大程度地减少对支持干预的需求。以下是可以通过引导式修复解决的潜在问题：

• 重启 VDA
• 重启 Citrix Workspace app。换句话说，请重新登录该应用程序。
• 刷新您的资源列表
• 刷新应用程序并重试
• 重新配置应用商店
• 升级 思杰工作区应用程序
• 重新安装思杰工作区应用程序
• 检查网络连接
• 等待并重试

系统配置要求

要使用故障排除连接功能，请确保您的 Citrix Workspace 应用程序版本如下：

适用于 Android 的 Citrix Workspace 应用程序： 版本 25.9.0 及更高版本

注意：

错误消息包含来自 错误代码 部分的云应用商店的服务器错误代码。

连接故障排除功能在 DaaS 环境中默认启用。详细的错误消息和建议适用于浏览器启动的会话以及通过 Citrix Workspace 应用程序启动的会话。错误代码和事务 ID 记录在日志中，供管理员参考。错误代码分为服务器端或客户端。对于某些错误，提供了重新启动虚拟投递代理 (VDA) 的修复选项。此功能不支持混合模式下的会话。例如，当您在浏览器中下载 ICA 文件，然后使用 Citrix Workspace 应用程序打开该文件时，无法使用此功能。