Aller au contenu principal

Journaux de plantage

Aperçu​

Les journaux de plantage sont des outils de diagnostic précieux qui aident les développeurs à identifier et à corriger les problèmes et les bogues qui provoquent le plantage ou le comportement inattendu de l'application. Il est possible de partager les journaux de votre appareil Android avec l'équipe de développement d'OsmAnd. Actuellement, les utilisateurs iOS n'ont qu'un seul type de journal de plantage à envoyer.

Journaux de plantage et journaux d'application​

OsmAnd vous permet d'envoyer deux types de données aux développeurs :

  • Journaux de plantage. Générés lorsque l'application OsmAnd rencontre une erreur critique ou une exception qui la fait planter. Ces journaux fournissent des informations détaillées sur l'état de l'application pendant l'échec, y compris les données de build, les traces de pile, les messages d'erreur et d'autres détails pertinents.
  • Journaux de session/application en cours. Un enregistrement du flux de journaux OsmAnd capturant divers événements et messages. Ces journaux aident les développeurs à surveiller le comportement de l'application, à suivre le flux d'exécution, à tracer des actions spécifiques et à enquêter sur les problèmes non liés aux plantages. Les journaux Logcat contiennent généralement des enregistrements d'activité depuis le dernier démarrage de l'application.
Vos informations privées

Soyez prudent lorsque vous envoyez des journaux d'application, car ils peuvent contenir des informations privées telles que la localisation de l'appareil, les requêtes de recherche, les résultats de construction d'itinéraire et les données de navigation.

Envoyer des journaux depuis l'application OsmAnd​

Envoyer les journaux de plantage depuis Android 1 Envoyer les journaux de plantage depuis Android 2

  1. Allez dans Menu → Aide → Envoyer les journaux des plantages de l'application ou Envoyer les journaux de la session actuelle (Envoyer le journal d'application en cours sur iOS). Selon votre situation, sélectionnez le type de journal approprié. Vous pouvez vous référer à la section Journaux de plantage et journaux d'application pour plus de détails sur les différences entre les types de journaux.
  2. Dans le menu contextuel, choisissez Gmail ou votre application de messagerie préférée. Nous vous recommandons d'envoyer les journaux à support@osmand.net.
  3. Appuyez sur le bouton Envoyer.

Histogramme de tas pour les problèmes de mémoire (Android)​

Android uniquement

Un histogramme de tas est un tableau de ce qui remplit la mémoire Java de l'application : noms de classes avec le nombre d'objets et leurs tailles. Il aide les développeurs à trouver ce qui consomme la mémoire lorsque l'application devient lente, se fige ou se ferme après un certain temps. Il ne contient pas vos positions, les noms de vos traces ni vos requêtes de recherche. OsmAnd effectue un vidage complet de la mémoire sur l'appareil, le transforme en histogramme, puis supprime immédiatement le vidage.

La réalisation du vidage fige l'application pendant 5 à 10 secondes. Si vous touchez l'écran pendant ce temps, Android peut afficher OsmAnd ne répond pas. C'est pourquoi la collecte automatique est désactivée par défaut.

Quand l'activer :

  • OsmAnd se ferme tout seul ou affiche ne répond pas de façon répétée, surtout après un certain temps d'utilisation ou lorsque vous ouvrez la recherche, la carte avec beaucoup de POI, ou Mes lieux avec beaucoup de traces.
  • L'application devient plus lente au fil du temps et un redémarrage aide.
  • Le rapport de plantage indique que l'application a manqué de mémoire (OutOfMemoryError).
  • Le support d'OsmAnd vous a demandé de collecter un histogramme de tas.

Quand le laisser désactivé :

  • L'utilisation quotidienne et la navigation, lorsque l'application fonctionne bien.
  • Les plantages qui se produisent immédiatement à chaque démarrage, ou avec une action précise comme l'ouverture d'un fichier. Un journal de plantage ordinaire suffit dans ce cas.

Comment le collecter et l'envoyer :

  1. Activez le plugin de développement OsmAnd et allez à Menu principal → Plugins → Développement OsmAnd → Paramètres → Mémoire → Mémoire Java.
  2. Dans le panneau Vidage du tas, choisissez l'une des options suivantes :
    • Collecter en cas d'utilisation élevée. L'histogramme est collecté automatiquement lorsque la mémoire Java est presque pleine, au maximum une fois toutes les 30 minutes, et il est joint au prochain rapport de plantage. Continuez à utiliser l'application normalement jusqu'à ce que le problème se reproduise.
    • Collecter et analyser maintenant. Collecte l'histogramme immédiatement et affiche le résultat. Utilisez-le lorsque l'application est déjà lente et que Mémoire Java indique une utilisation élevée.
  3. Appuyez sur Partager le rapport pour envoyer le dernier rapport aux développeurs, ou envoyez-le depuis la boîte de dialogue de plantage au prochain démarrage de l'application.
  4. Désactivez Collecter en cas d'utilisation élevée une fois le rapport envoyé.

Mémoire Java Android Panneau de vidage du tas Android

Envoyer des fichiers Tombstone (Android)​

Crucial

Pour les utilisateurs avancés uniquement !

Dans certains cas complexes ou inhabituels, des fichiers Tombstone peuvent être nécessaires. Ces fichiers fournissent des traces de pile détaillées pour tous les threads d'un processus en cours de plantage (pas seulement celui qui a causé l'erreur), une carte mémoire complète et une liste de tous les descripteurs de fichiers ouverts. Les fichiers Tombstone sont essentiels pour le débogage et le diagnostic des problèmes liés au code natif sur la plateforme Android.

Utilisation de votre appareil​

Pour exporter les fichiers tombstone, vous devez générer un rapport de bogue à l'aide des paramètres système Android :

  1. Activez les Options pour les développeurs (cet écran est masqué par défaut).

    • Allez dans Paramètres → À propos du téléphone → Informations sur le logiciel (ce chemin est valable pour les appareils Samsung).
    • Appuyez sept fois sur Numéro de build jusqu'à ce qu'une fenêtre contextuelle confirme que le mode développeur est actif.

  2. Allez dans Options pour les développeurs, généralement situées en bas de la liste des paramètres. Vous pouvez également utiliser la fonction de recherche.

    • Appuyez sur l'option Prendre un rapport de bogue.
    • Sélectionnez le type de rapport de bogue et appuyez sur Rapport.

Une fois le rapport de bogue prêt, vous recevrez une notification. Appuyez sur la zone de notification pour télécharger le rapport sur votre appareil. Décompressez le fichier et envoyez les fichiers tombstone à l'équipe de développeurs OsmAnd (e-mail : support@osmand.net).

Envoyer les journaux de plantage depuis Android 3 Envoyer les journaux de plantage depuis Android 4

remarque

Veuillez noter que les rapports de bogue peuvent contenir des données privées, y compris l'utilisation de l'application ou la localisation.

Utilisation d'ADB​

L'Android Debugging Bridge (ADB) est un outil en ligne de commande qui permet aux développeurs de déboguer leurs applications. Pour utiliser ADB pour exporter les fichiers tombstone, vous devez d'abord le télécharger et l'installer. Suivez les instructions fournies sur le site officiel des développeurs Android.

Préparer votre appareil​

Assurez-vous que les Options pour les développeurs sont activées (cet écran est masqué par défaut) et que le Débogage USB est activé :

  • Naviguez vers Paramètres → À propos du téléphone → Informations sur le logiciel.
  • Appuyez sept fois sur Numéro de build jusqu'à ce qu'une fenêtre contextuelle confirme que le mode développeur est actif.
  • Dans les Options pour les développeurs, activez le Débogage USB.

Ensuite, connectez votre appareil à votre poste de travail via USB. S'il s'agit de la première connexion, une fenêtre contextuelle apparaîtra demandant l'autorisation d'autoriser le débogage.

Générer un rapport de bogue​

  1. Ouvrez un terminal en ligne de commande. Sur Mac ou Linux, utilisez l'application Terminal, et sur Windows, utilisez l'Invite de commandes.
  2. Naviguez vers le dossier platform-tools où se trouve ADB à l'aide de la commande cd (par exemple, « cd /Users/NomUtilisateur/Téléchargements/Outils »).
  3. Générez le rapport de bogue :
    • Sur Mac : adb bugreport
    • Sur Windows : adb.exe bugreport
  4. Attendez quelques minutes que le rapport soit généré. Le fichier résultant sera enregistré dans le dossier platform-tools.
  5. Décompressez le fichier.
  6. Trouvez le dossier tombstones avec des fichiers comme tombstone_00, tombstone_01, et similaires.
  7. Envoyez les fichiers tombstone à support@osmand.net.

Utilisation d'appareils rootés ou de l'émulateur Android Studio​

  • Avec un accès root à votre appareil, vous pouvez ouvrir directement le dossier /data/tombstones.

  • Dans Android Studio, utilisez l'émulateur pour naviguer vers Explorateur de fichiers de l'appareil et trouver le dossier /data/tombstones. À l'intérieur, vous trouverez des fichiers nommés comme tombstone_00, tombstone_01, et d'autres. Téléchargez ces fichiers et envoyez-les à support@osmand.net.

Pour plus de détails sur les rapports de bogue, consultez la documentation Android.