Dépannage

Dernière publication : Oct 24, 2026

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 :
  1. Ouvrez le Play Store.
  2. 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 le dernier correctif.
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 EAR

Vous pouvez donner votre avis sur EAR à l'adresse : https://forms.gle/joYc7K5teg4zcWNr7.

Problèmes courants et conseils de dépannage

Échecs d'installation

Lorsque 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.
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.
baiMobile Credentials

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 -v dans 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.

Confiance sélective du client

Activez les paramètres pour le microphone, la localisation et la caméra. Accédez à l'application Citrix Workspace Paramètres > Paramètres du magasin et activez les paramètres CST pour un magasin sélectionné.
À ajouter dans le dossier média

Activer le pointeur de la souris

Après avoir démarré une session, appuyez sur la barre d'out'ils, puis sur l'icône du pointeur de la souris pour activer le pointeur de la souris.
Icône du pointeur de la souris

Activer le clavier

Si l'administrateur de votre organisation n'a pas activé la fonction d'affichage automatique du clavier par défaut, contactez l'administrateur de votre organisation pour obtenir de l'aide.
Les administrateurs doivent activer la stratégie Affichage automatique du clavier dans le paramètre DDC.
Stratégie de clavier automatique

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.
Alerte
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 peu puissants ou les appareils mobiles ?
  • 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 récurrents Protocol Driver Error
    Solution de contournement :
    • Désactivez les propriétés de l'adaptateur Ethernet Citrix PV pour l'interface réseau sur :
    • le serveur Citrix Virtual Apps™
    • Citrix Secure Web Gateway™
    • le 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 :
Code d'erreur Article du Centre de connaissances
Code d'erreur 437 https://support.citrix.com/article/CTX463401
Code d'erreur 41E https://support.citrix.com/article/CTX235177
Code d'erreur 546 ou 547 https://support.citrix.com/article/CTX231798
Code d'erreur 518 https://support.citrix.com/article/CTX277571
Code d'erreur 42B https://support.citrix.com/article/CTX260992
Code d'erreur 548 https://support.citrix.com/article/CTX250706
https://support.citrix.com/article/CTX578359
Adresse de serveur incorrecte et code d'erreur 548 https://support.citrix.com/article/CTX554245
Code d'erreur 451 https://support.citrix.com/article/CTX256708
Erreur générale https://support.citrix.com/article/CTX219073
Essayez de vous reconnecter Désactivez l'option UDP. Accédez à Paramètres de l'application > Avancé > EDT

Messages d'erreur et description

Le tableau suivant répertorie les erreurs et leur description. La solution probable consiste à 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 la connexion.
SessionManager.Launch.LogonFailed Session déconnectée sans avoir terminé la connexion
SessionManager.LeaseResolution.Failed Impossible de tenter le lancement du bail.
SessionManager.clxmtp.SoftDeny La négociation du moteur CLXMTP a échoué (refus implicite).
SessionManager.clxmtp.SoftDeny_Implicit La connexion du moteur CLXMTP a échoué (refus implicite).
Transport.Connect.NoCGP_Fail Échec de la connexion (CGP désactivé).
Transport.Connect.FallbackFail Échec de la connexion, tentative de repli ICA.
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 à l'agent de livraison virtuel (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

La fonctionnalité diagnostique les problèmes potentiels de lancement d'applications et de bureaux virtuels à travers les 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 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é Citrix Troubleshoot Connection inclut des étapes que les utilisateurs peuvent suivre pour se remettre 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 correction guidée :
  • Redémarrer le VDA
  • Redémarrer l'application Citrix Workspace. En d'autres termes, se reconnecter à l'application Citrix Workspace.
  • Actualiser la liste des ressources
  • Actualiser l'application et réessayer
  • Reconfigurer le Store
  • 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, vous devez disposer 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 et des recommandations détaillés 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.