exporter un journal de débogage (logcat) à partir d’un appareil Android

Résumé

Lorsque vous utilisez les produits Esri sur la plateforme mobile Android (Collector for ArcGIS, par exemple) et que l’application s’arrête de façon inattendue, il est possible d’extraire les fichiers journaux générés (logcat) pour établir un diagnostic et procéder au dépannage. Toutefois, comme le mode de développement n’est pas activé par défaut sur ces produits, les fichiers journaux ne peuvent être récupérés qu’à l’aide du jeu d’outils pour développeurs SDK Android.

Procédure

Le processus suivant peut être appliqué pour les appareils Android non-root afin d’extraire les fichiers journaux. Toutefois, avant de reproduire l’erreur afin de générer et extraire le fichier journal, il est nécessaire d’activer le mode de développement sur l’appareil Android. Vous devez avoir un ordinateur à votre disposition pour procéder à l’extraction.

Avertissement : 
Ce processus implique l’utilisation des outils SDK Android ; aucun support n’est fourni par Esri.

1. Sur l’appareil Android, accédez à Settings > About device et appuyez sur l’option Build Number à sept reprises pour activer le mode de développement.

   Remarque :
   Sur certains appareils Android, l’option Build Number est accessible via Settings > About phone > Software information.
   

2. Revenez dans le menu Settings, ouvrez Developer options > activez l’option USB debugging.
3. Pour les appareils Android exécutant la version 5.0 ou une version suivante, réglez Log buffer sizes à 4 Mo par zone tampon de journal.

   Remarque :
   4 Mo suffit pour stocker les journaux. Ce volume peut toutefois être augmenté, si besoin est.

4. Ouvrez l’application mobile (Collector for ArcGIS dans le présent exemple) et reproduisez l’erreur. Cela permet de générer le fichier journal.
5. Raccordez l’appareil Android à un ordinateur via un câble USB.
6. Téléchargez Android SDK Platform Tools et extrayez le contenu sur l’ordinateur.
7. Ouvrez le dossier extrait platform-tools et assurez-vous qu’adb.exe existe.
8. Appuyez sur Ctrl+Maj et cliquez avec le bouton droit sur la zone de l’espace de travail vide, puis sélectionnez Open command window here (Ouvrir une fenêtre de commandes ici).
   
   
    
9. Dans l’invite de commande, procédez comme suit :
   1. Changez de répertoire en tapant CD, suivi par le répertoire de destination de l’extraction. Par exemple :

      CD C:\AndroidLog

   2. Entrez la commande suivante :

      adb logcat -v threadtime -d > C:\AndroidLog\logcat.txt

   
   
    
10. Le fichier journal (logcat.txt) est alors extrait dans le dossier de destination à l’aide du niveau de consignation détaillé.

Remarque :
Pour plus d’informations sur le fonctionnement du fichier journal, reportez-vous à Reading Bug Reports.