Afficher et analyser les rapports d'erreur et d'application qui ne répond pas

Cette page propose des contenus d'aide pour les fournisseurs de SDK utilisant la Google Play SDK Console.

Si vous êtes un développeur d'applications et si vous recherchez du contenu d'aide concernant la Google Play Console, utilisez la barre de recherche ou revenez à la page d'accueil.

Vous pouvez consulter des rapports d'erreur pour les problèmes de plantage ou d'application qui ne répond pas (ANR) dans la SDK Console afin de hiérarchiser et de résoudre les problèmes de stabilité dans votre SDK. Vous pouvez aussi ajouter des notes aux plantages et aux ANR afin d'aider les développeurs d'applications à en connaître la cause et ainsi les éviter.

Rapports de plantage et ANR dans la SDK Console

Lorsqu'une application plante ou ne répond pas sur un appareil Android dont l'utilisateur a accepté de partager automatiquement ses données d'utilisation et de diagnostic, Google Play reçoit un rapport de plantage ou ANR. Nous partageons ensuite ce rapport avec les développeurs d'applications pour les aider à déboguer et à résoudre les problèmes. Si cette application utilise votre SDK et que nous constatons qu'il a pu être impliqué, vous pouvez consulter un rapport d'erreur ou ANR dans la SDK Console. Les plantages et les erreurs ANR sont regroupés en clusters pour vous aider à déterminer quand plusieurs problèmes peuvent avoir la même cause. Pour préserver l'anonymat des utilisateurs et des développeurs d'applications, les plantages et les erreurs ANR ne sont consignés que si leur nombre dépasse le seuil défini.

Pour savoir comment les utilisateurs Android activent le partage de données, consultez le Centre d'aide des comptes Google.

Afficher un aperçu des plantages et des ANR

Vous pouvez afficher un aperçu des plantages et des ANR au fil du temps sur la page Plantages et ANR :

1. Ouvrez la SDK Console et sélectionnez SDK dans le menu de gauche.
2. Cliquez sur le SDK pour lequel vous souhaitez consulter les informations de plantage ou d'ANR.
3. Dans le menu de gauche, sélectionnez Plantages et ANR.
4. Utilisez le filtre en haut à droite de la page pour sélectionner la période pour laquelle vous souhaitez consulter les données. Vous pouvez sélectionner 7 derniers jours, 14 derniers jours, 28 derniers jours ou 56 derniers jours. Le graphique filtre les données affichées en fonction de votre sélection.
5. Vous pouvez également filtrer les résultats par version du SDK, version d'Android, modèle d'appareil et nombre d'applications concernées. Par défaut, le rapport est filtré pour n'afficher que les problèmes qui affectent au moins cinq applications.
6. Tous les nouveaux problèmes signalés sont classés dans la catégorie "Ouvert" par défaut. Vous pouvez modifier la classification d'un problème (en choisissant la catégorie "Résolu", par exemple) sur une page Informations détaillées sur le plantage ou Informations détaillées de l'ANR spécifique ou sur la page générale Plantages et ANR, puis filtrer les problèmes par classification sur cette page.
   • Remarque : Nous vous conseillons d'ajouter une note pour tout problème classé. Les notes de problème vous permettent de transmettre des informations importantes et du contexte sur la résolution du plantage ou de l'ANR. Elles s'affichent dans la Google Play Console pour les applications concernées par le problème. Pour en savoir plus sur les notes de problème, consultez Afficher les détails du problème.

Le graphique affiché sur la page Plantages et ANR indique le nombre d'occurrences, le nombre d'utilisateurs affectés et le nombre d'applications concernées par jour.

Tous les problèmes signalés sont recensés sous "Problèmes" sous le graphique. Pour chaque problème, vous pouvez afficher le nombre d'utilisateurs et d'applications concernés, le nombre d'occurrences et la date du dernier problème. La liste des problèmes est classée par ordre décroissant du nombre d'occurrences.

Afficher les détails du problème

Pour afficher les détails d'un plantage ou d'une ANR spécifique :

1. Ouvrez la SDK Console et sélectionnez SDK dans le menu de gauche.
2. Cliquez sur le SDK pour lequel vous souhaitez consulter les informations de plantage ou d'ANR.
3. Dans le menu de gauche, sélectionnez Plantages et ANR.
4. Faites défiler la page jusqu'au tableau "Problèmes".
5. Cliquez sur la flèche vers la droite () à côté du problème que vous souhaitez consulter.
6. Comme pour la page Plantages et ANR, sélectionnez la période à partir de laquelle vous souhaitez afficher les données à l'aide du filtre en haut à droite. Vous avez le choix entre 7 derniers jours, 14 derniers jours, 28 derniers jours et 56 derniers jours. Le graphique filtre les données affichées en fonction de votre sélection.
7. Si vous avez déjà ajouté une note pour les développeurs concernant ce problème, vous pouvez la consulter en cliquant sur Voir plus à côté de "Note pour les développeurs d'applis". Vous pouvez également cliquer sur Modifier la note si vous souhaitez la modifier. Vous trouverez plus d'informations sur les notes de problèmes ci-dessous.

La page Informations détaillées sur le plantage ou Informations détaillées de l'ANR affiche les mêmes informations que la page Plantages et ANR, c'est-à-dire des détails propres à un seul cluster de plantages ou d'ANR, y compris le nombre d'utilisateurs et d'applications concernés, le nombre d'occurrences et la date de la dernière occurrence. Tout comme le graphique de la page Plantages et ANR, le graphique de la page Informations détaillées sur le plantage ou Informations détaillées de l'ANR présente ces données par jour.

Sous le graphique, vous pouvez consulter des informations plus détaillées sur les problèmes, classées par version du SDK (pour identifier les versions concernées), par version d'Android et par modèle d'appareil.

Pour afficher la liste complète des versions du SDK, des versions Android ou des appareils, cliquez sur Tout afficher sous les graphiques. Sous ces répartitions, vous trouverez la trace de la pile. Pour copier la trace de la pile dans le presse-papiers, cliquez sur l'icône Copier à côté de la trace de la pile.

Afin de protéger les informations des développeurs, les cadres d'application sont indiqués comme étant <private>. Chaque cadre <private> représente un ou plusieurs cadres adjacents masqués, car ils proviennent de l'application qui a planté ou qui ne répond pas, d'une bibliothèque de codes dont votre SDK ne dépend pas, ou encore d'une bibliothèque dont dépend votre SDK, mais que le système ne connaît pas.

Il peut souvent y avoir plusieurs variantes de la trace de la pile pour le même problème. Utilisez la barre de navigation en haut à droite de la section "Trace de la pile" pour naviguer entre les variantes. Cela peut être dû à des modifications au niveau des numéros de lignes sur différentes versions du SDK ou à des différences entre les appareils et les versions d'OS. S'il n'y a qu'une seule trace de la pile, cela peut être dû au fait que d'autres variantes sont masquées pour des raisons de confidentialité.

Remarque : Si votre SDK est obscurci, vous devez importer vos fichiers de désobscurcissement afin d'obtenir les traces de la pile désobscurcies et permettre à la SDK Console de regrouper les plantages ou les ANR identiques entre les différentes versions du SDK.

Utiliser les notes de problèmes pour aider les développeurs d'applications

Vous pouvez ajouter des notes à tous les plantages ou ANR listés sur la page Plantages et ANR de la SDK Console afin d'aider les développeurs d'applications à comprendre la cause du problème ou la façon de l'éviter.

En communiquant clairement par le biais de ces notes, vous pouvez aider les développeurs d'applications à comprendre la nature d'un plantage ou d'un ANR. Cela inclut de préciser si le problème concerne le SDK, l'intégration ou un facteur externe. Cela peut vous aider à renforcer vos relations avec les développeurs, à limiter la confusion, à potentiellement diminuer les demandes d'assistance directe et à permettre aux développeurs d'applications de prendre les mesures appropriées, comme mettre à jour le SDK, corriger leur intégration ou comprendre les limites connues.

Nous vous recommandons d'inclure autant d'informations que possible, par exemple sur la cause du plantage ou de l'ANR, la façon de résoudre le problème ou comment l'éviter. Vous pouvez également ajouter des liens vers la documentation du SDK, les outils de suivi des problèmes ou d'autres conseils. Ce message s'affiche pour tous les développeurs d'applications concernés par ce problème. Il ne doit donc pas s'adresser à un développeur individuel ni inclure de salutations.

Lorsque vous ajoutez une note, elle s'affiche dans la Google Play Console, sur la page Plantages et ANR de chaque application concernée par le plantage ou l'ANR.

Remarque : Les notes ne peuvent pas être supprimées, mais sont modifiables, ce qui vous permet d'adapter les informations fournies.

Pour ajouter une note à un plantage ou à un ANR :

1. Ouvrez la SDK Console et sélectionnez SDK dans le menu de gauche.
2. Cliquez sur le SDK pour lequel vous souhaitez consulter les informations de plantage ou d'ANR.
3. Dans le menu de gauche, sélectionnez Plantages et ANR.
4. Faites défiler la page jusqu'au tableau Problèmes.
5. Cliquez sur la flèche vers la droite à côté du problème auquel vous souhaitez ajouter une note.
6. En haut à droite de la page Informations détaillées sur le plantage ou Informations détaillées de l'ANR, cliquez sur Ajouter une note pour les développeurs d'applis. Choisissez un état de plantage et ajoutez ou modifiez votre note dans l'écran qui s'ouvre alors, comme sur la capture d'écran ci-dessous.
7. À côté de État du plantage ou État de l'ANR, sélectionnez une catégorie.
8. Saisissez votre note dans la zone de texte.
   • Rédigez une note claire, concise et pratique (voir les exemples ci-dessous). Vous pouvez écrire jusqu'à 500 caractères.
   • Remarque : Vous pouvez ajouter des liens vers la documentation du SDK, les outils de suivi des problèmes ou toute autre destination externe où vous fournissez aux développeurs des consignes concernant les plantages.
   • Recommandation : Demandez à un membre de votre équipe de vérifier le contenu de la note avant de continuer.
9. Lorsque vous avez terminé, cliquez sur Ajouter une note. Une fois la note ajoutée, vous ne pouvez pas la supprimer. Cependant, vous pouvez la modifier en revenant sur la page Informations détaillées sur le plantage pour un plantage ou Informations détaillées de l'ANR pour un ANR, puis en cliquant sur Modifier la note.
10. Une fois envoyée, la note est associée à l'état En attente. Quelques jours peuvent s'écouler avant que la nouvelle note soit mise en ligne et que les développeurs la voient dans la Play Console.

Que se passe-t-il lorsqu'une note est modifiée dans la SDK Console ?

• Une fois la note pour les développeurs envoyée via l'interface de la SDK Console, elle est placée dans une file d'attente pour être examinée.
• L'examen sera réalisé par l'équipe dédiée aux développeurs Google Play. 
• Une fois la note examinée et approuvée, elle est publiée.
• Ensuite, les développeurs d'applications qui utilisent votre SDK et sont concernés par ce cluster de plantages ou d'ANR spécifique pourront voir la note dans la Google Play Console.

Catégories de notes pour les développeurs et exemples de notes

Vous trouverez ci-dessous les catégories de note et des exemples pour vous guider :

Catégorie de plantage	Description	État général	Exemple de note
Problème résolu dans une version plus récente	Ce plantage est résolu dans une version plus récente de votre SDK.	Résolu	Veuillez passer à com.mysdk.android.foo:foo-android:6.9.5 ou version ultérieure. Vous trouverez les notes de version concernant ce correctif sur [LIEN].
Problème causé par une mauvaise intégration	Ce problème peut être dû à une utilisation incorrecte d'une API, d'une méthode ou d'un paramètre du SDK par l'application.	Non résolu	Ce plantage est dû à une intégration incorrecte de la fonctionnalité [fonctionnalité] du SDK mysdk. Plus précisément, il semble que la méthode ne soit pas appelée lorsque l'activité ou le fragment associé est détruit, ce qui entraîne une fuite de mémoire et un plantage. Recommandation : Veuillez examiner votre implémentation pour vous assurer que la fonctionnalité [fonctionnalité] est appelée dans les méthodes de cycle de vie onPause() ou onDestroy() de votre activité ou fragment afin de désenregistrer correctement l'écouteur. Pour obtenir des instructions détaillées sur l'intégration de mysdk, veuillez consulter notre documentation : [link].
Problème connu (mais non résolu)	Un plantage qui se produit (par exemple, sur un appareil/OS non compatible) ou un problème de SDK connu que le fournisseur du SDK n'a pas l'intention de résoudre.	Non résolu	Ce plantage se produit principalement sur les appareils exécutant des versions d'Android antérieures à X.Y, qui ne sont plus activement prises en charge par notre SDK. État : Nous reconnaissons l'existence du problème, mais nous ne fournirons pas de correctif spécifique pour ces anciennes versions de l'OS. Nous concentrons nos efforts de développement sur la prise en charge d'Android X.Y et versions ultérieures. Nous vous recommandons de cibler des versions plus récentes d'Android pour des performances et une stabilité optimales du SDK.
Problème non causé par le SDK	Vous pensez que le code de votre SDK n'est pas responsable de ce plantage, et que le problème se situe au niveau de l'application cliente ou qu'il est causé par un autre SDK.	Non résolu	Ce plantage est probablement dû à un problème dans votre application. Veuillez examiner votre code et envisager de le déboguer à l'aide des outils appropriés.
Autre	Ce problème est dû à un autre problème non indiqué ici. À utiliser avec parcimonie.		com.mysdk.android.gms:mysdk:18.6.0 et versions ultérieures incluent des API à activer qui peuvent aider à éviter cet ANR. Pour en savoir plus, [lien]

Modifier l'état général

Modifiez l'état du cluster d'erreurs de la SDK Console et ajoutez des notes pour les développeurs afin de refléter les informations sur l'état pour les développeurs d'applications.

• Accédez à la page Informations détaillées sur le plantage.
• Recherchez le menu déroulant Marqué comme. Cliquez dessus pour afficher les options d'état.
• Sélectionnez l'état général le plus approprié en fonction des critères suivants :

État	Description/Quand l'utiliser
Ouvert	L'enquête est en cours ou aucune résolution/décision définitive n'a encore été prise. Il s'agit généralement de l'état par défaut des nouveaux problèmes.
Résolu	La cause du problème a été résolue. Par exemple, le problème se trouvait dans le code de votre SDK, et un correctif est publié dans une version spécifique du SDK (par exemple, 17.0.1).
Non résolu	L'équipe du SDK ne traitera pas directement ce problème. Cet état couvre plusieurs scénarios : Général (côté application/externe) : le plantage est dû à des facteurs indépendants de la volonté de l'équipe du SDK (par exemple, une erreur de code d'application dans un rappel, une utilisation incorrecte de l'API par le développeur de l'application ou un problème de dépendance externe non résolu).  Problème connu du SDK (aucun correctif prévu) : problème connu du SDK, mais aucun correctif n'est prévu (par exemple, impact faible, complexité élevée, affecte des plates-formes non prises en charge). Obsolète : le problème n'est plus d'actualité (par exemple, en raison de l'abandon d'une fonctionnalité ou de modifications architecturales importantes).

Afficher les problèmes signalés par les développeurs

Les développeurs d'applications peuvent partager les problèmes impliquant votre SDK afin de vous aider à les déboguer. Les plantages ou les erreurs ANR partagés sont affichés dans la SDK Console (Plantages et ANR > Problèmes signalés par les développeurs). Les problèmes signalés incluent le nom de l'application, une trace complète de la pile du plantage ou de l'ANR, ainsi que des informations supplémentaires sur le plantage ou l'ANR. Si vous ne voyez pas de Problèmes signalés par les développeurs, cela signifie que les développeurs d'applications n'ont pas encore partagé de plantages ni d'ANR. Nous vous recommandons d'encourager les développeurs d'applications à partager les problèmes qu'ils rencontrent à l'aide de l'article Afficher les plantages et les erreurs ANR.

La capture d'écran ci-dessous montre un exemple de problème signalé par un développeur :

Si vous avez des conseils à fournir aux développeurs d'applications au sujet du plantage ou de l'ANR signalés, vous pouvez ajouter une note sur le problème (voir la section Utiliser les notes de problèmes pour aider les développeurs d'applications).

Nous vous enverrons un e-mail lorsqu'un développeur d'applications partagera un plantage ou une ANR concernant votre SDK. Si vous ne souhaitez pas recevoir d'e-mails, vous pouvez vous désinscrire en sélectionnant Boîte de réception > Gérer les préférences relatives aux e-mails.