Dépannage
Comment vérifier la version de l’application
Pour connaître la version de l’application Citrix Workspace que vous utilisez, consultez l’article Comment vérifier la version de l’application dans la documentation d’aide.
Comment mettre à niveau vers la dernière version
Pour mettre à niveau manuellement l’application Citrix Workspace vers la dernière version, procédez comme suit :
- Ouvrez le Play Store.
-
Recherchez Citrix Workspace.
Si une mise à jour est disponible, appuyez sur Mettre à jour.
Mettre à jour l’application automatiquement
Par défaut, les applications sont mises à jour automatiquement lorsque les conditions suivantes sont remplies :
- L’appareil est connecté à un réseau Wi-Fi.
- L’appareil est en charge.
- L’appareil est inactif (non utilisé activement).
- L’application Citrix Workspace n’est pas exécutée au premier plan.
Remarque :
Le Google Play Store vérifie les mises à jour des applications une fois par jour. Il peut donc s’écouler jusqu’à 24 heures avant qu’une mise à jour d’application ne soit ajoutée à la file d’attente des mises à jour. Une fois qu’une application est ajoutée à la file d’attente, elle sera automatiquement mise à jour la prochaine fois que les conditions seront remplies.
Comment réinitialiser l’application Citrix Workspace
Pour réinitialiser l’application, vous pouvez effectuer l’une des opérations suivantes :
-
Effacez les données de stockage de l’application Citrix Workspace. Accédez aux Paramètres de l’appareil Android > Applications > sélectionnez Citrix Workspace app > Stockage > Vider le cache.
ou
-
Désinstallez l’application Citrix Workspace et installez la dernière version de l’application Citrix Workspace pour Android depuis Google Play qui contient la dernière correction.
Remarque
La suppression des comptes existants de l’application Citrix Workspace réinitialise le compte et non l’application Citrix Workspace elle-même.
Comment collecter les journaux
La collecte de journaux est importante car elle peut aider à identifier les problèmes. À partir de la version 24.3.5, le fichier journal contient désormais des informations plus complètes qui peuvent aider les administrateurs informatiques et les équipes de support client à mieux analyser le scénario.
Pour plus d’informations, consultez l’article Comment collecter les journaux dans la documentation d’aide.
Comment fournir des commentaires
Vous pouvez nous envoyer des commentaires sur l’application Citrix Workspace pour Android et signaler des problèmes en utilisant la même interface. Pour plus d’informations, consultez l’article Comment fournir des commentaires dans la documentation d’aide.
Comment demander des améliorations
Pour demander des améliorations de fonctionnalités pour l’application Citrix Workspace pour Android, remplissez le formulaire Google.
Comment accéder aux fonctionnalités en préversion technique
Pour en savoir plus sur les fonctionnalités en préversion technique, consultez Fonctionnalités en préversion technique.
Comment fournir des commentaires sur l’EAR
Vous pouvez donner votre avis sur l’EAR à l’adresse suivante : https://forms.gle/joYc7K5teg4zcWNr7.
Problèmes courants et conseils de dépannage
Échecs d’installation
Si l’application Citrix Workspace n’est pas prise en charge par défaut sur Android TV, contactez-nous via les demandes d’amélioration.
Authentification et ajout de magasin
Si vous rencontrez des problèmes d’authentification ou d’ajout de magasin, vérifiez les points suivants.
Saisie non valide
Vous avez peut-être saisi :
- informations d’identification non valides
- URL de magasin incorrecte
- fautes de frappe lors de la saisie des informations d’identification et de l’URL du magasin
- HTTP au lieu de HTTPS.
Mode d’interface Web
Vous pouvez également essayer d’utiliser le mode Interface Web. Sur la première page de l’application, appuyez sur Démarrer. Sur la page Bienvenue, saisissez l’URL du magasin et activez Ajouter le type de compte comme Interface Web.

Carte à puce
Si l’authentification par carte à puce ne fonctionne pas, installez l’application baiMobile Credentials. Si l’application baiMobile Credentials détecte votre carte à puce, contactez-nous pour examiner le problème plus en détail.

Configurations de stratégie NetScaler®
Pour résoudre les problèmes de connexion, consultez l’article du centre de connaissances NetScaler Gateway pour appareils mobiles.
Lancement de session
Pour afficher les statistiques de session :
-
depuis la barre d’outils de session, appuyez quatre fois sur l’icône du pointeur de la souris
ou
-
exécutez la commande
ctxsession -vdans le terminal de session.
Échec du lancement du bureau
Pour résoudre les problèmes, consultez les articles suivants du centre de connaissances :
Autorisations d’accès aux périphériques
Activez les autorisations de paramètres appropriées.
Client Selective Trust
Activez les paramètres pour le microphone, la localisation et la caméra. Accédez aux Paramètres de l’application Citrix Workspace > Paramètres du magasin et activez les paramètres CST pour un magasin sélectionné.

Activer le pointeur de la souris
Après avoir démarré une session, appuyez sur la barre d’outils, puis sur l’icône du pointeur de la souris pour l’activer.
![]()
Activer le clavier
Si l’administrateur de votre organisation n’a pas activé la fonction d’affichage automatique du clavier par défaut, contactez-le pour obtenir de l’aide.
Les administrateurs doivent activer la stratégie Affichage automatique du clavier dans le paramètre DDC.

Appareils débridés
Les appareils débridés sont ceux que leurs propriétaires ont modifiés, généralement pour contourner les protections de sécurité. Les appareils Android débridés présentent des risques de sécurité pour votre déploiement lorsque les utilisateurs s’y connectent. Lorsque l’application Citrix Workspace pour Android détecte un appareil Android débridé, elle affiche une alerte à l’utilisateur.

Pour renforcer la sécurité de votre environnement, vous pouvez configurer StoreFront™ ou Web Interface afin d’empêcher les appareils débridés détectés d’exécuter des applications.
Remarque :
L’application Citrix Workspace™ se désactive si elle détecte un appareil débridé afin de protéger les données et de maintenir la sécurité. Cela garantit que l’application ne peut pas être utilisée sur des appareils présentant des modifications non autorisées.
Prérequis :
- Application Citrix Workspace pour Android 24.7.0 ou version ultérieure.
- Accès à StoreFront ou Web Interface via un compte administrateur.
Pour plus d’informations, consultez Appareils débridés.
Traçage permanent (AOT)
À partir de la version 26.3.0 (2603), l’application Citrix Workspace pour Android prend en charge le traçage permanent (AOT), capturant en continu des journaux de diagnostic lisibles pour les sessions utilisateur et les événements système afin de simplifier le dépannage et de réduire la dépendance vis-à-vis du support Citrix.
Pour plus d’informations, consultez Chargement des journaux AOT à partir des composants principaux de Citrix Virtual Apps and Desktops dans la documentation de Citrix Virtual Apps and Desktops™.
FAQ
-
Comment améliorer l’expérience utilisateur vidéo des applications virtuelles et des bureaux virtuels pour les appareils à faible puissance ou les appareils mobiles ?
- Pour plus d’informations, consultez l’article du Centre de connaissances sur l’expérience utilisateur vidéo.
-
Accès aux ressources - Je ne vois pas mes applications ou mes bureaux après m’être connecté à l’application Citrix Workspace ?
- Contactez le service d’assistance de votre entreprise ou l’administrateur de votre équipe de support informatique pour obtenir de l’aide.
-
Comment dépanner les connexions lentes ?
-
Suivez la solution de contournement si vous rencontrez l’un des problèmes suivants :
- connexions lentes au site Citrix Virtual Apps and Desktops
- icônes d’application manquantes
- messages d’erreur Protocol Driver Error récurrents
Solution de contournement :
-
Désactivez les propriétés de l’adaptateur Ethernet Citrix PV pour l’interface réseau sur :
- serveur Citrix Virtual Apps™
- Citrix Secure Web Gateway™
-
serveur Web Interface
-
Les propriétés de l’adaptateur Ethernet Citrix PV incluent (toutes activées par défaut) :
- Déchargement d’envoi volumineux
- Déchargement de la somme de contrôle IP
- Déchargement de la somme de contrôle TCP
- Déchargement de la somme de contrôle UDP
Aucun redémarrage du serveur n’est nécessaire. Cette solution de contournement s’applique à Windows Server 2003 et 2008 32 bits. Ce problème n’affecte pas Windows Server 2008 R2.
-
-
Problème avec les touches numériques et les caractères spéciaux
- Si les touches numériques ou les caractères IME chinois ne fonctionnent pas correctement, désactivez l’option Clavier Unicode. Pour ce faire, accédez à Paramètres > Options du clavier > et définissez Utiliser le clavier Unicode sur désactivé.
Dépannage des codes d’erreur
Le tableau suivant vous donne la liste des codes d’erreur et une solution probable :
| Error code | Knowledge Center article |
|---|---|
| Error code 437 | https://support.citrix.com/article/CTX463401 |
| Error code 41E | https://support.citrix.com/article/CTX235177 |
| Error code 546 or 547 | https://support.citrix.com/article/CTX231798 |
| Error code 518 | https://support.citrix.com/article/CTX277571 |
| Error code 42B | https://support.citrix.com/article/CTX260992 |
| Error code 548
|
https://support.citrix.com/article/CTX250706 |
| https://support.citrix.com/article/CTX578359 | |
| Incorrect server address + Error code 548 | https://support.citrix.com/article/CTX554245 |
| Error code 451 | https://support.citrix.com/article/CTX256708 |
| General error | https://support.citrix.com/article/CTX219073 |
| Try connecting again | Disable the UDP option. Go to app Settings > Advance > EDT |
Messages d’erreur et description
Le tableau suivant vous donne la liste des erreurs et leur description. La solution probable est de contacter le support technique Citrix pour obtenir une assistance supplémentaire :
| Erreur | Description |
|---|---|
| SessionManager.Launch.EngineLoadFailed | Le moteur ICA n’a pas pu se charger/s’initialiser. |
| SessionManager.Launch.ConnectionFailed | Le moteur ICA s’est arrêté avant de se connecter. |
| SessionManager.Launch.LogonFailed | La session s’est déconnectée sans terminer la connexion. |
| SessionManager.LeaseResolution.Failed | Impossible de tenter le lancement du bail. |
| SessionManager.clxmtp.SoftDeny | La négociation CLXMTP du moteur a échoué (refus souple). |
| SessionManager.clxmtp.SoftDeny_Implicit | La connexion CLXMTP du moteur a échoué (refus souple implicite). |
| Transport.Connect.NoCGP_Fail | Échec de la connexion (CGP désactivé). |
| Transport.Connect.FallbackFail | Échec de la connexion, le repli ICA a été tenté. |
| Transport.Connect.Fail | La connexion est indisponible. |
Dépannage de la connexion Citrix
La fonctionnalité de dépannage de la connexion Citrix est conçue pour permettre aux utilisateurs finaux de résoudre efficacement eux-mêmes les éventuels échecs de lancement de bureaux ou d’applications. Cette amélioration vise à fournir aux utilisateurs des diagnostics clairs, des recommandations potentielles et la possibilité d’exécuter des correctifs en un simple clic.
Fonctionnement
Cette fonctionnalité fournit des messages d’erreur plus granulaires et améliorés pour aider les utilisateurs à comprendre clairement la cause première des échecs de lancement. La fonctionnalité de dépannage de la connexion analyse les problèmes de connexion au Virtual Delivery Agent (VDA) en temps réel pendant le processus de lancement. Elle présente ensuite des messages d’erreur et des recommandations conviviaux, permettant aux utilisateurs de résoudre le problème directement ou de collecter des journaux pour un ticket de support si nécessaire.
Chemins de connexion analysés
Cette fonctionnalité diagnostique les problèmes potentiels de lancement d’applications et de bureaux virtuels à travers des points de connexion critiques, notamment :
- Connectivité réseau du client à la passerelle.
- Connexion de la passerelle au serveur StoreFront.
- Connexion du serveur StoreFront au Broker.
- Connexion du Broker au VDA.
Messages d’erreur et diagnostics améliorés
En cas d’échec de lancement, Citrix affiche désormais des messages d’erreur clairs et conviviaux qui identifient les problèmes de connexion spécifiques, tels que les erreurs réseau, l’indisponibilité du serveur ou les défaillances du VDA. Pour les administrateurs, des codes d’erreur détaillés sont fournis dans les journaux, classés en erreurs côté serveur et côté client, servant de références précieuses pour une investigation plus approfondie.
Actions d’auto-récupération et de correction
La fonctionnalité de dépannage de connexion Citrix inclut des étapes que les utilisateurs peuvent suivre pour se rétablir automatiquement des problèmes courants, minimisant ainsi le besoin d’intervention du support. Voici les problèmes potentiels qui peuvent être résolus avec une remédiation guidée :
- Redémarrer le VDA
- Redémarrer l’application Citrix Workspace. En d’autres termes, connectez-vous à nouveau à l’application Citrix Workspace.
- Actualiser la liste des ressources
- Actualiser l’application et réessayer
- Reconfigurer le magasin
- Mettre à niveau l’application Citrix Workspace
- Réinstaller l’application Citrix Workspace
- Vérifier le réseau
- Attendre et réessayer
Configuration système requise
Pour utiliser la fonctionnalité de dépannage de connexion, disposez des versions suivantes de l’application Citrix Workspace :
Application Citrix Workspace pour Android : version 25.9.0 et ultérieure
Remarque :
Les messages d’erreur incluent les codes d’erreur du serveur pour les magasins cloud de la section Codes d’erreur.
La fonctionnalité de dépannage de connexion est activée par défaut dans les environnements DaaS. Des messages d’erreur granulaires et des recommandations sont disponibles pour les sessions lancées via un navigateur et les sessions démarrées avec l’application Citrix Workspace. Les codes d’erreur et les ID de transaction sont enregistrés dans les journaux pour référence de l’administrateur. Les codes d’erreur sont classés comme côté serveur ou côté client. Pour certaines erreurs, une option de correction pour redémarrer le Virtual Delivery Agent (VDA) est fournie. Cette fonctionnalité ne prend pas en charge les sessions en mode hybride. Par exemple, elle ne peut pas être utilisée lorsque vous téléchargez un fichier ICA dans un navigateur, puis ouvrez ce fichier à l’aide de l’application Citrix Workspace.
Dans cet article
- Comment vérifier la version de l’application
- Comment mettre à niveau vers la dernière version
- Comment réinitialiser l’application Citrix Workspace
- Comment collecter les journaux
- Comment fournir des commentaires
- Comment demander des améliorations
- Comment accéder aux fonctionnalités en préversion technique
- Comment fournir des commentaires sur l’EAR
- Problèmes courants et conseils de dépannage
- Traçage permanent (AOT)
- FAQ
- Dépannage des codes d’erreur
- Messages d’erreur et description
- Dépannage de la connexion Citrix