Désobscurcir ou décoder les traces de la pile de plantage

Pour désobscurcir les traces de la pile Java, vous devez d'abord générer un fichier de mappage ProGuard. Pour savoir comment procéder, accédez au site Google Developers.

Plug-in Android Gradle 4.1 ou version ultérieure

Si votre projet compile un Android App Bundle, vous pouvez y inclure automatiquement le fichier de décodage. Pour inclure ce fichier, ajoutez les éléments suivants au fichier build.gradle de votre application :

• android.defaultConfig.ndk.debugSymbolLevel = 'FULL'

Remarque : Le fichier de décodage ne doit pas dépasser 800 Mo. Si l'empreinte de vos symboles de débogage est trop importante, utilisez SYMBOL_TABLE au lieu de FULL pour réduire la taille du fichier.

Si votre projet crée un fichier APK, utilisez le paramètre de compilation build.gradle ci-dessus pour générer le fichier de symboles de débogage séparément. Importez manuellement le fichier de symboles de débogage dans la Google Play Console, comme décrit ci-dessous à l'Étape 2 : Importez un fichier de désobscurcissement ou de décodage. Dans le cadre du processus de compilation, le plug-in Android Gradle génère ce fichier à l'emplacement de projet suivant :

• app/build/outputs/native-debug-symbols/variant-name/native-debug-symbols.zip

Plug-in Android Gradle 4.0 ou version antérieure (et autres systèmes de compilation)

Dans le cadre du processus de création d'un app bundle ou d'un APK, le plug-in Android Gradle conserve une copie des bibliothèques intactes dans un répertoire de projet. La structure de ce répertoire est semblable à celle-ci :

app/build/intermediates/cmake/universal/release/obj

├── armeabi-v7a/

│   ├── libgamenegine.so

│   ├── libothercode.so

│   └── libvideocodec.so

├── arm64-v8a/

│   ├── libgamenegine.so

│   ├── libothercode.so

│   └── libvideocodec.so

├── x86/

│   ├── libgamenegine.so

│   ├── libothercode.so

│   └── libvideocodec.so

└── x86_64/

    ├── libgameengine.so

    ├── libothercode.so

    └── libvideocodec.so

Remarque : Si vous utilisez un autre système de compilation, vous pouvez le modifier pour stocker les bibliothèques non nues dans un répertoire avec la structure requise ci-dessus.

1. Compressez le contenu de ce répertoire :
   • $ cd app/build/intermediates/cmake/universal/release/obj
   • $ zip -r symbols.zip .
2. Importez manuellement le fichier symbols.zip dans la Play Console, comme décrit ci-dessous à l'Étape 2 : Importez un fichier de désobscurcissement ou de décodage.

Le fichier de décodage ne doit pas dépasser 800 Mo. Si votre fichier est trop volumineux, cela signifie probablement que vos fichiers .so contiennent une table de symboles (noms de fonction), ainsi que des informations de débogage DWARF (noms de fichiers et lignes de code). Ces données ne sont pas nécessaires pour décoder votre code et peuvent être supprimées en exécutant la commande suivante :

• $OBJCOPY --strip-debug lib.so lib.so.sym

Remarque : $OBJCOPY pointe vers la version spécifique de l'ABI que vous supprimez, par exemple : ndk-bundle/toolchains/aarch64-linux-android-4.9/prebuilt/linux-x86_64/bin/aarch64-linux-android-objcopy.

Pour importer un fichier de désobscurcissement ou de décodage, procédez comme suit :

1. Ouvrez la Play Console.
2. Sélectionnez une application.
3. Dans le menu de gauche, sélectionnez Tester et publier > Explorateur d'app bundle.
4. À l'aide de l'outil de sélection situé dans l'angle supérieur droit, choisissez l'artefact approprié.
5. Sélectionnez l'onglet Téléchargements, puis faites défiler la page jusqu'à la section "Éléments".
6. Cliquez sur la flèche d'importation du fichier de mappage ou sur les symboles de débogage pour importer le fichier de désobscurcissement ou de décodage correspondant à la version de votre application.

Pour importer des fichiers via l'API Google Play Developer, accédez au site Google Developers.

La Play Console utilise ndk-stack pour décoder les traces de la pile pour les applications natives et ReTrace pour les plantages Java. Si vous choisissez de ne pas partager vos fichiers de désobscurcissement, vous pouvez copier les piles de plantage obscurcies depuis la Play Console et utiliser hors connexion l'outil approprié pour les décoder. Toutefois, vous devez effectuer ce processus manuellement pour chaque pile de plantage, ce qui demande beaucoup de temps. Si vous fournissez vos fichiers de désobscurcissement, la Play Console se charge de cette opération.

Une fois que vous avez importé un fichier de mappage ProGuard ou un fichier de décodage pour une version de votre application, seuls les plantages et les erreurs ANR qui se produisent après seront désobscurcis. Vous devrez patienter le temps que les nouveaux plantages et erreurs ANR soient signalés par les appareils des utilisateurs avant de voir les plantages et les erreurs ANR désobscurcis dans la Play Console.

Ce problème résulte de l'importation d'un fichier de désobscurcissement/décodage incomplet. Veillez à inclure les fichiers de décodage pour l'ensemble de votre application, en particulier si vous utilisez un processus de compilation complexe ou en plusieurs étapes. L'utilisation d'une bibliothèque tierce est l'une des raisons les plus courantes du désobscurcissement partiel. Dans ce cas, vous pouvez obtenir les fichiers de désobscurcissement auprès du fournisseur de la bibliothèque.

Sans fichiers de désobscurcissement, le même plantage ou la même erreur ANR sur un appareil 32 bits et 64 bits, ou un ARM et un appareil Intel seront affichés séparément. Si vous fournissez des fichiers de désobscurcissement, nous pouvons regrouper ces plantages, ce qui vous donne une meilleure idée des plantages et des erreurs ANR ayant le plus de conséquences pour votre application.

Si vous oubliez d'importer le fichier pour une nouvelle version de votre application, les plantages et les erreurs ANR seront à nouveau obscurcis. Suivez les instructions ci-dessus pour l'importer dès maintenant. Une fois que vous avez importé un fichier de mappage ProGuard ou un fichier de symboles de débogage pour une version de votre application, seuls les plantages et les erreurs ANR qui se produisent après seront désobscurcis. Vous devrez patienter le temps que les nouveaux plantages et erreurs ANR soient signalés par les appareils des utilisateurs avant de voir les plantages et les erreurs ANR désobscurcis dans la Play Console.

Pour éviter d'oublier d'importer le fichier, envisagez de modifier votre processus de compilation afin d'utiliser des app bundles avec le plug-in Android Gradle 4.1 ou version ultérieure. Dans ce cas, vous pouvez inclure automatiquement le fichier de symboles de débogage dans l'app bundle en suivant les instructions du site pour les développeurs Android.

Si vous importez le mauvais fichier pour une nouvelle version de votre application, les plantages et les erreurs ANR seront à nouveau obscurcis. Pour importer une version corrigée, procédez comme suit :

1. Ouvrez la Play Console.
2. Sélectionnez une application.
3. Dans le menu de gauche, sélectionnez Tester et publier > Explorateur d'app bundle.
4. À l'aide de l'outil de sélection situé dans l'angle supérieur droit, choisissez l'artefact approprié.
5. Sélectionnez l'onglet Téléchargements, puis faites défiler la page jusqu'à la section "Éléments".
6. Cliquez sur l'icône Supprimer à côté du mauvais fichier de désobscurcissement ou de décodage.
7. Une fois la version incorrecte supprimée, cliquez sur l'icône d'importation, puis importez le fichier correspondant à la version de votre application.

Une fois que vous avez importé le bon fichier de mappage ProGuard ou de symboles de débogage pour une version de votre application, seuls les plantages et les erreurs ANR qui se produisent après seront désobscurcis. Vous devrez patienter le temps que les nouveaux plantages et erreurs ANR soient signalés par les appareils des utilisateurs avant de voir les plantages et les erreurs ANR désobscurcis dans la Play Console.

Astuce : Pour éviter d'importer le mauvais fichier, envisagez de modifier votre processus de compilation afin d'utiliser des app bundles avec le plug-in Android Gradle 4.1 ou version ultérieure. Dans ce cas, vous pouvez inclure automatiquement le fichier de symboles de débogage dans l'app bundle en suivant les instructions du site pour les développeurs Android.

Pour commencer, consultez le site pour les développeurs Android.

Oui.

Il arrive que le système rencontre une erreur ANR, mais ne parvienne pas à recueillir la trace de la pile. Dans ce cas, l'erreur ANR s'affiche pour vous donner plus d'informations sur la stabilité de votre application, mais vous ne pouvez pas consulter la trace de la pile. Les erreurs ANR sans trace de pile étant regroupées par type et activité, examiner et corriger les ANR similaires peut contribuer à réduire le nombre d'ANR sans trace de pile.