Avec l’outil bureautique Console, capturez la sortie de la console, identique à celle que vous voyez actuellement dans Qt Creator, à partir d’une application AppStudio à l’aide d’un outil bureautique. À l’instar de la console Qt Creator, vous pouvez utiliser l’outil Console avec une application s’exécutant sur la même machine, mais il peut également recevoir la sortie d’un autre appareil sur le même réseau. Ceci est idéal pour capturer la sortie de la console à partir de votre appareil iOS ou Android et l’afficher sur votre bureau.
Lorsque vous exécutez une application AppStudio sur un appareil Android et que l’application s’arrête de façon inattendue, vous pouvez extraire les fichiers journaux système générés pour établir un diagnostic et procéder au dépannage. L’utilisation des outils Android SDK est nécessaire. Pour en savoir plus, consultez l’article de la base de connaissances Procédure : exporter un journal de débogage (logcat) à partir d’un appareil Android.
Activer l'outil Console
Lorsque vous démarrez ArcGIS AppStudio version 1.2 ou ultérieure, le bouton Console apparaît sur la barre d’outils en haut de l’application. Il permet d’ouvrir l’outil Console.
Remarque :
Pour accéder à cet outil, il n'est pas nécessaire de se connecter.
A part les détails de l'ordinateur hôte, cette page semble de premier abord vide, car une application doit être dirigée vers une console pour que des informations y soient générées. Cela ne peut s’effectuer que dans une application AppStudio dans laquelle la consignation est activée.
Activer la consignation dans AppStudio Player
Pour les applications d’entreprise ou en développement, AppStudio Player bénéficie d’une compatibilité intégrée avec la console. Pour activer la consignation dans le lecteur, ouvrez le menu latéral et appuyez sur l’option Connect remote console (Connecter une console distante). Vous avez ensuite le choix entre trois méthodes de connexion à votre appareil.
- Scan QR code (Numériser le code QR) est utile lors de l’exécution d’applications dans AppStudio Player sur des appareils mobiles. Avant de numériser le code, sélectionnez l’adresse IP dans l’outil Console. Comme plusieurs adresses IP peuvent être attribuées au système exécutant la console AppStudio, le code QR est généré pour l’adresse sélectionnée dans la liste déroulante et apparaît en regard. Cliquez sur ce code QR pour afficher une version agrandie, ce qui est utile si l'appareil ne parvient pas à numériser le code de plus petite taille. Numérisez le code QR généré à la taille souhaitée pour établir la connexion.
- Connect via network (Se connecter via le réseau) permet de choisir une console AppStudio en cours d’exécution sur votre réseau pour établir la connexion.
- Enter IP Address (Saisir une adresse IP) permet d’ouvrir une nouvelle page dans laquelle vous saisissez manuellement l’adresse IP et le port ; par exemple, syslog://10.112.25.174:514. Appuyez sur Next (Suivant) pour vous connecter à la console.
Avec l’ensemble de ces méthodes, toutes les actions que vous effectuez dans AppStudio Player envoient des messages à la console sur le bureau sélectionné.
Consigner des messages avec la console
Une fois AppStudio Player connecté à l’outil Console, le champ Log output locations (Emplacement en sortie du journal) est automatiquement renseigné avec les détails de l’appareil connecté.
La console sur le bureau sélectionné affiche immédiatement des informations de diagnostic émanant à la fois de AppStudio Player et de l’application qui s’exécute à l’intérieur. Les messages du lecteur et de l’application sont différenciés dans la colonne App (Application). La console reçoit les informations jusqu’à ce que vous désactiviez la consignation dans AppStudio Player ou cliquiez sur Stop (Arrêter) dans la console.
Se connecter à d'autres consoles en ligne
L’outil Console fait appel au protocole syslog, une méthode largement prise en charge et compatible qui permet de consigner des informations au sein d’un réseau ou en ligne. Cela signifie que les fonctionnalités de consignation de AppStudio Player, ainsi que les applications prenant en charge la console, peuvent servir à envoyer des messages à d’autres consoles syslog, telles que Loggly.
Pour ce faire, saisissez manuellement l'URL ou l'adresse IP de votre emplacement syslog dans la zone de texte Emplacement en sortie du journal. Vous pouvez également être amené à fournir des informations d'ID utilisateur. Entrez ces informations dans la zone de texte Données utilisateur. Pour en savoir plus sur les informations d’ID utilisateur et Loggly, consultez la documentation de Loggly.
Enregistrer les messages consignés de la console dans un fichier
L’outil Console peut également exporter les messages reçus vers un fichier journal qu’il est possible de consulter ultérieurement ou d’envoyer à d’autres utilisateurs. Pour ce faire, cliquez sur le bouton Enregistrer sur la console pendant ou après la consignation. Une boîte de dialogue permettant de choisir la destination et le nom du fichier, et d’enregistrer les résultats en tant que fichier .log, apparaît.
Ajouter la compatibilité de la console à votre application
Vous pouvez ajouter la possibilité de générer des messages de la console dans votre propre application. Au minimum, la ligne de code suivante permet à votre application de générer des messages de la console vers un fichier journal externe dans l'emplacement par défaut sur l'appareil :
AppFramework.logging.enabled = true;
Remarque :
Pour vous assurer que ce fichier peut être créé lors de l'exécution de votre application sur un appareil Android, dans Paramètres, sur l'onglet Fonctionnalités, vérifiez que Stockage externe est sélectionné.
Pour d’autres exemples détaillés d’implémentation de la consignation, consultez les modèles d’entreprise de AppStudio Player fournis avec AppStudio.
Vous avez un commentaire à formuler concernant cette rubrique ?