Obtenir des rapports d'erreur lisibles dans le tableau de bord Crashlytics (Unity)

Sélectionnez une plate-forme : iOS+ Android Flutter Unity


iOS+ (plates-formes Apple)

Pour les applications de la plate-forme Apple utilisant le SDK Unity Crashlytics 8.2.0 ou version ultérieure, le plug-in Firebase Unity Editor configure automatiquement votre projet Xcode pour importer des symboles. Téléchargez la dernière version.

Android

Pour les applications Android, le SDK Unity Crashlytics 8.6.1 ou version ultérieure inclut automatiquement les rapports d'erreur NDK, ce qui permet à Crashlytics de signaler automatiquement les plantages IL2CPP Unity sur Android. Toutefois, pour afficher les traces de la pile symbolisées pour les plantages de bibliothèques natives dans le tableau de bord Crashlytics, vous devez importer les informations de symbole au moment de la compilation à l'aide de la CLI Firebase.

  1. Assurez-vous d'utiliser le SDK Unity Crashlytics v8.6.1 ou une version ultérieure. Téléchargez la dernière version.

  2. Configurez votre environnement et votre projet pour l'importation de symboles :

    1. Suivez les instructions pour installer la CLI Firebase.

      Si vous l'avez déjà installée, veillez à la mettre à jour vers la dernière version.

    2. (Uniquement pour les applications utilisant le niveau d'API Android 30 ou supérieur) Mettez à jour le modèle AndroidManifest.xml de votre application pour désactiver le taggage des pointeurs :

      1. Cochez la case Android Player Settings > Publishing Settings > Build > Custom Main Manifest (Paramètres du lecteur Android > Paramètres de publication > Compilation > Fichier manifeste principal personnalisé).

      2. Ouvrez le modèle de fichier manifeste situé à l'emplacement Assets/Plugins/Android/AndroidManifest.xml.

      3. (Uniquement pour les applications utilisant une version du SDK antérieure à la 8.8.0) Ajoutez l'attribut suivant à la balise d'application : <application android:allowNativeHeapPointerTagging="false" ... />

  3. Créez votre projet et importez des symboles.

    Suivez ces étapes chaque fois que vous créez un build de version ou tout build pour lequel vous souhaitez afficher des traces de la pile symbolisées dans le tableau de bord Crashlytics.

    1. Dans la boîte de dialogue Build Settings (Paramètres de compilation), effectuez l'une des opérations suivantes :

      • Exporter vers un projet Android Studio pour créer votre projet

      • Créez votre APK directement depuis l'éditeur Unity.
        Avant de créer le build, assurez-vous que la case Create symbols.zip (Créer symbols.zip) est cochée dans la boîte de dialogue Build Settings (Paramètres de build).

    2. Une fois la compilation terminée, générez un fichier de symboles compatible avec Crashlytics et importez-le sur les serveurs Firebase en exécutant la commande CLI Firebase suivante :

      firebase crashlytics:symbols:upload --app=FIREBASE_APP_ID PATH/TO/SYMBOLS

      • FIREBASE_APP_ID : ID de votre application Android Firebase (et non le nom de votre package)
        Exemple d'ID d'application Android Firebase : 1:567383003300:android:17104a2ced0c9b9b

      • PATH/TO/SYMBOLS : chemin d'accès au fichier de symboles généré par la CLI

        • Exporté vers un projet Android Studio : PATH/TO/SYMBOLS est le répertoire unityLibrary/symbols, qui est créé à la racine du projet exporté après la compilation de l'application via Gradle ou Android Studio.

        • Vous avez créé l'APK directement dans Unity : PATH/TO/SYMBOLS est le chemin d'accès au fichier de symboles compressé généré dans le répertoire racine du projet une fois la compilation terminée (par exemple, myproject/myapp-1.0-v100.symbols.zip).

      Afficher les options avancées d'utilisation de la commande de la CLI Firebase pour générer et importer des fichiers de symboles

      Option Description
      --generator=csym

      Utilise l'ancien générateur de fichiers de symboles cSYM au lieu du générateur Breakpad par défaut

      Utilisation déconseillée. Nous vous recommandons d'utiliser le générateur de fichiers de symboles Breakpad par défaut.

      --generator=breakpad

      Utilise le générateur de fichiers de symboles Breakpad

      Notez que le format par défaut pour la génération de fichiers de symboles est Breakpad. N'utilisez cette option que si vous avez ajouté symbolGenerator { csym() } dans votre configuration de compilation et que vous souhaitez la remplacer pour utiliser Breakpad à la place.

      --dry-run

      Génère les fichiers de symboles, mais ne les importe pas

      Cette option est utile si vous souhaitez inspecter le contenu des fichiers envoyés.

      --debug Fournit des informations de débogage supplémentaires.