Toutes les collections
Matériel éducatif
Journaux de plantage sur les appareils mobiles
Journaux de plantage sur les appareils mobiles

Comment générer et récupérer des journaux de plantage sur les appareils mobiles?

Andrew Radchanka avatar
Écrit par Andrew Radchanka
Mis à jour il y a plus d’une semaine

"Où localiser les journaux de plantage sur les appareils mobiles et comment les obtenir ? Quelle est la méthode la plus simple?"

Motivation

En cas de plantage d'une application mobile, les journaux de l'appareil deviennent un élément essentiel du rapport de bug, nécessaire pour comprendre les causes du dysfonctionnement. Ils sont également utiles pour les blocages de l'application, car seules les informations enregistrées permettent d'obtenir un aperçu détaillé des circonstances entourant le problème.

Dans cet article, découvre comment obtenir des informations de journal pour les appareils Android et iOS. En appliquant ces techniques, tu pourras enregistrer et joindre des fichiers de journal significatifs à tes rapports.

Obtenir des journaux de plantage sur les appareils Android

Pour les appareils Android, deux méthodes principales sont disponibles: l'utilisation du Débogage Android Bridge (ADB) et la fonctionnalité de Rapport de bug intégrée dans les outils de développement de ton téléphone. Dans un premier temps, nous expliquerons comment utiliser ADB.

Journaux de plantage en utilisant ADB

Sur Windows, pour obtenir des journaux de plantage via ADB, tu devras télécharger les Outils de la plateforme SDK. Tu peux les télécharger ici.

Sur macOS, tu devras installer android-platform-tools à l'aide de Homebrew. Les instructions d'installation se trouvent plus loin dans cet article.

Lancement d'ADB sur Windows et macOS

Windows

Une fois que tu as téléchargé les Outils de la plateforme SDK, tu dois extraire les fichiers (le dossier) de là. Une fois les fichiers (le dossier) extraits, ouvre le dossier extrait. Ensuite, dans la barre d'adresse de l'Explorateur de fichiers, clique dans un espace vide. Lorsque le chemin d'accès aux fichiers est affiché, tape cmd et appuie sur ENTREE sur ton clavier. Cela lancera cmd (Invite de commandes) à l'intérieur du dossier, et de cette manière, ADB sera essentiellement démarré.

macOS

La première étape consiste à installer Homebrew à l'aide du Terminal, puis à installer android-platform-tools. Pour installer Homebrew sur ton macOS, visite le site Web de Homebrew et copie le lien d'installation sous la section ❝Installer Homebrew❞. Après avoir copié le lien d'installation, colle-le dans le Terminal et appuie sur ENTREE sur ton clavier. L'installation de Homebrew débutera. Suis les instructions d'installation jusqu'au bout.

Remarque: Dans certains cas, l'installation peut prendre plus de temps en raison de l'installation de composants supplémentaires, mais ne t'inquiète pas, tout va bien.

Après avoir terminé l'installation de Homebrew, tu devras installer android-platform-tools. Pour ce faire, visite le site des formules Homebrew d'android-platform-tools et copie la commande d'installation. Ensuite, colle-la dans le Terminal et appuie sur ENTREE sur ton clavier. L'installation commencera. Une fois l'installation terminée, tape adb dans le Terminal et appuie sur ENTREE. Si tu vois les commandes adb, cela signifie que l'installation a réussi.

Remarque: Après l'installation de android-platform-tools, pour chaque utilisation ultérieure, il te suffira d'ouvrir le Terminal et de saisir les commandes pour obtenir les journaux, comme décrit plus loin dans cet article.

Création de journaux

Pour générer des journaux, active le Débogage USB dans les Options pour les développeurs sur ton téléphone, puis exécute les commandes dans cmd (Windows) ou Terminal (macOS) déjà ouvert. Si tu as déjà activé les outils pour les développeurs et le débogage USB, tu peux passer à la partie 2.

Partie 1 : Activation du débogage USB sur ton appareil Android

  1. Ouvre l'application Paramètres.

  2. Recherche le Numéro de build (généralement situé dans la section ❝Informations sur le logiciel❞ sous "À propos du téléphone")

  3. Appuie plusieurs fois sur le Numéro de build jusqu'à ce que tu voies le message ❝Vous êtes maintenant développeur!❞

  4. Maintenant que tu as activé les options pour les développeurs, recherche-les dans les Paramètres et ouvre-les.

  5. Si les options pour les développeurs ne sont pas encore activées, active-les en appuyant sur le bouton bascule.

  6. Cherche l'option de débogage USB et active-la en appuyant sur le bouton bascule.

Partie 2 : Création de journaux

1. Dans cmd (Windows) ou dans le Terminal (macOS) déjà ouvert, tape adb start-server et appuie sur ENTREE sur ton clavier. Cela démarrera le serveur adb.

2. Ensuite, connecte ton téléphone à ton PC à l'aide d'un câble USB. Si le débogage USB n'est pas encore activé sur ton téléphone Android, une invite Autoriser le débogage USB? devrait apparaître. Appuie sur OK. Tu peux également cocher Toujours autoriser depuis cet ordinateur et appuyer sur OK pour éviter d'être constamment interrogé lorsque tu essaies d'obtenir des journaux de plantage.

3. Maintenant, tape adb devices dans cmd ou dans le Terminal et appuie sur ENTREE. Cela affichera la liste des appareils connectés à ton PC. Assure-toi que ton appareil figure dans la liste.

Remarque : Si, après le nom de ton appareil, tu vois le texte non autorisé, cela signifie probablement que tu n'as pas autorisé le débogage USB. Assure-toi que le texte dispositif suit immédiatement le nom de ton appareil.

4. Pour créer un journal des problèmes reproductibles, commence par effacer l'historique du journal pour supprimer le contenu inutile en entrant adb logcat -c et en appuyant sur Entrée.

5. Maintenant, il est temps de capturer les journaux.

5a. Si tu veux créer un journal dans le dossier actuel (où se trouvent les outils de la plateforme sur Windows), tu peux entrer adb logcat -v time > crashlog.txt dans cmd et appuyer sur Entrée sur le clavier. Le processus de journalisation démarrera après avoir appuyé sur Entrée.

5b. Si tu veux créer un journal dans un autre dossier, copie le chemin d'accès au fichier de ce dossier (sous Windows: Accède au dossier cible --> Clique dans un espace vide dans la barre d'adresse de l'Explorateur de fichiers --> Copie le chemin du fichier; sous macOS: Sélectionne le dossier souhaité --> Fais un clic droit dessus --> Clique sur Copier). Une fois que tu auras copié le chemin du fichier, tape adb logcat -v time > paste_file_path_here\log.txt dans cmd ou Terminal et appuie sur Entrée sur le clavier (la commande sous Windows devrait ressembler à ceci: adb logcat -v time > D:\testIO\Logs\crashlog.txt; tandis que sous Mac, elle devrait ressembler à ceci: adb logcat -v time > /Users/testIO/log/crashlog.txt). Le processus de journalisation démarrera après avoir appuyé sur Entrée.

6. Maintenant que tu as commencé à enregistrer, reproduis le bogue ou le plantage pour lequel tu veux créer un journal. Une fois que tu as terminé, appuie sur CTRL + C dans cmd ou dans Terminal. Cela arrêtera le processus de journalisation, et tu devrais maintenant pouvoir voir ton fichier journal dans le dossier spécifié.

Explication en vidéo: 5a. - Création d'un journal dans le dossier actuel où se trouvent les outils de la plateforme

Explication en vidéo: 5b. - Création d'un journal dans un autre emplacement (Windows)

Explication en vidéo: 5b. - Création d'un journal dans un autre emplacement (Mac)

Fonctionnalité de Rapport de Bogue

Une autre façon d'obtenir des journaux à partir de ton téléphone Android est d'utiliser la fonctionnalité de Rapport de bogue Android directement dans les options pour les développeurs de ton appareil. Tu peux créer des rapports de bug à tout moment, qui incluront toute l'activité du journal dans un certain laps de temps en fonction de la taille de ta mémoire tampon de journal et de l'activité du journal sur ton appareil. Ce laps de temps peut varier de quelques minutes à plusieurs heures, voire plusieurs jours.

Comment créer un rapport de bug via les options pour les développeurs

1. Ouvre l'application Paramètres.

2. Recherche le Numéro de build (généralement situé dans la section "Informations sur le logiciel" sous "À propos du téléphone").

3. Appuie plusieurs fois sur le Numéro de build jusqu'à ce que tu voies le message ❝Vous êtes maintenant développeur!❞.

4. Maintenant que tu as activé les options pour les développeurs, cherche-les dans les Paramètres et ouvre-les.

5. Si les options pour les développeurs ne sont pas encore activées, active-les en appuyant sur le bouton bascule.

6. Appuie sur Soumettre un rapport de bogue ou Prendre un rapport de bug (le nom de cette fonction dépend de l'appareil), sélectionne Rapport interactif et appuie sur le bouton Rapport.

7. Ton rapport sera maintenant créé. Tu peux suivre la progression de la création dans ton centre de notifications. Une fois que le rapport de bogue est prêt, partage-le en te l'envoyant par e-mail ou en le téléchargeant vers la destination de ton choix, comme Google Drive ou Dropbox.

8. Ouvre le fichier texte du rapport sur ton ordinateur (décompresse-le si nécessaire).

9. Recherche la section SYSTEM LOG du rapport et joins-la à ton rapport de bogue.

Remarque: Si ton journal de plantage fait plus de 25 MB, extrait la partie pertinente incluant quelques parties avant et après l'événement de bogue, et télécharge le journal de plantage dans ton rapport de bogue.

Obtenir des journaux de plantage sur les appareils iOS

Récupérer des informations de journal sur les appareils iOS ne demande pas beaucoup d'efforts. En fonction de l'ordinateur que tu utilises (Windows ou Mac), nous te montrerons dans le texte suivant comment extraire rapidement les journaux et les joindre à ton rapport de bogue.

Lorsqu'un plantage survient sur ton appareil iOS, dans la plupart des cas, un fichier .ips sera automatiquement créé et ajouté aux données d'analyse. Tu devras joindre ce fichier .ips à ton rapport de bogue lorsque tu signaleras un bogue lié au plantage sur un appareil iOS. Tu peux trouver les journaux de plantage sur ton appareil iOS en suivant les étapes ci-dessous :

  1. Ouvre les Paramètres sur ton appareil iOS.

  2. Recherche et ouvre Confidentialité et sécurité.

  3. Ouvre Analyses et améliorations.

  4. Accède à Données d'analyse.

Une fois que tu as ouvert les Données d'analyse, tu y trouveras tous les journaux créés sur ton appareil iOS. Maintenant, nous expliquerons comment les extraire rapidement en fonction de ton ordinateur (Windows ou Mac).

Windows

Utilisation de 3uTools. Avec 3uTools, tu pourras rapidement trouver et extraire des journaux sur ton PC Windows, et tout ce dont tu as besoin est un câble USB. Pour ce faire, suis les étapes suivantes:

  1. Télécharge 3uTools. Tu peux le télécharger ici.

  2. Installe 3uTools, puis ouvre-le après l'installation.

  3. Connecte ton appareil iOS à ton PC à l'aide d'un câble USB.

    3a. Si tu vois l'invite ❝Faire confiance à cet ordinateur?❞ sur ton appareil, appuie sur Faire confiance et saisis ton code d'accès si nécessaire.

  4. Assure-toi que ton appareil est visible dans 3uTools.

  5. Clique sur Toolbox dans le menu de navigation.

  6. Ouvre l'Analyse des plantages, puis clique sur Fichiers.

  7. Trouve le fichier journal correspondant et exporte-le vers la destination de ton choix.

  8. Joins le fichier journal exporté à ton rapport de bogue.

macOS

Extraire les fichiers journaux sur macOS depuis un appareil iOS est encore plus facile que sur Windows. La manière la plus rapide d'extraire les fichiers journaux de ton appareil iOS vers ton Mac est d'utiliser la fonction AirDrop. Pour ce faire, suis les étapes suivantes:

  1. Dans les Données d'analyse déjà ouvertes, ouvre un fichier journal correspondant.

  2. Appuie sur le bouton Partager dans le coin supérieur droit de l'écran.

  3. Appuie sur AirDrop.

  4. Envoie le journal vers ton appareil Mac.

  5. Joins le fichier journal à ton rapport de bogue.

Si tu rencontres des difficultés à extraire des journaux de ton appareil iOS sur ton ordinateur Windows ou Mac avec les étapes précédemment données, il existe également une solution de contournement facile. Tu n'as qu'à ouvrir le fichier journal correspondant dans les Données d'analyse, appuyer sur le bouton Partager, sélectionner l'application Mail, puis t'envoyer le journal par e-mail. Ensuite, rends-toi dans ta messagerie sur ton ordinateur Windows ou Mac, télécharge le journal et joins-le à ton rapport de bogue. Bien sûr, si tu as tes propres méthodes d'extraction des journaux, tu peux également les utiliser.

Remarque: Parfois, tu pourras peut-être rencontrer un bogue "d'incident", mais tu ne pourras pas trouver un journal de plantage. Dans ce cas, tu devras télécharger le journal de la console dans ton rapport de bogue. Tu peux vérifier comment créer un journal de la console sur ton appareil iOS.

Avez-vous trouvé la réponse à votre question ?