Obtenez des rapports d'erreur lisibles dans le tableau de bord Crashlytics

iOS+ (plates-formes Apple)

Pour les applications de plate-forme Apple utilisant le SDK Unity 8.2.0 ou version ultérieure, le plug-in Firebase Unity Editor configure automatiquement votre projet Xcode pour importer les symboles.Crashlytics 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 Unity IL2CPP sur Android. Toutefois, pour afficher les traces de pile symbolisées pour les plantages de la bibliothèque native dans le tableau de bord Crashlytics, vous devez importer les informations sur les symboles au moment de la compilation à l'aide de l'interface de ligne de commande Firebase.

1. Assurez-vous d'utiliser le SDK Unity v8.6.1 ou version ultérieure.Crashlytics 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 avez déjà installé la CLI, veillez à passer à 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 du pointeur :

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

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

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

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

   Effectuez ces étapes chaque fois que vous créez un build de version ou un build pour lequel vous souhaitez afficher des traces de pile symbolisées dans la console Firebase.

   1. Dans la boîte de dialogue 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 à partir de l'éditeur Unity.
        Avant de compiler, assurez-vous que la case Créer symbols.zip est cochée dans la boîte de dialogue Paramètres de compilation.

   2. Une fois votre 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

        Vous avez besoin de trouver l'ID de votre application Firebase ?

        Voici deux façons de trouver l'ID de votre application Firebase :

        • Dans votre fichier google-services.json, votre ID d'application correspond à la valeur mobilesdk_app_id.

        • Dans la console Firebase, accédez à vos Paramètres du projet. Faites défiler la page jusqu'à la fiche Vos applications, puis cliquez sur l'application Firebase de votre choix pour trouver son ID.

      • PATH/TO/SYMBOLS : chemin d'accès au fichier de symboles généré par l'interface de ligne de commande

        • Exporté vers un projet Android Studio : PATH/TO/SYMBOLS est le répertoire unityLibrary/symbols, qui est créé dans 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 correspond au chemin d'accès du 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 pour utiliser la commande CLI Firebase afin de générer et d'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. L'utilisation n'est pas recommandé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 Breakpad est le paramètre par défaut pour la génération de fichiers de symboles. N'utilisez cette option que si vous avez ajouté symbolGenerator { csym() } dans votre configuration de compilation et que vous souhaitez la remplacer par Breakpad.
      --dry-run	Génère les fichiers de symboles, mais ne les importe pas Ce flag est utile si vous souhaitez inspecter le contenu des fichiers envoyés.
      --debug	Fournit des informations de débogage supplémentaires