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


iOS + (plates-formes Apple)

Pour les applications de plate-forme Apple qui utilisent 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 la création de rapports sur les plantages du NDK, ce qui permet à Crashlytics de signaler automatiquement les plantages d'Unity IL2CPP sur Android. Toutefois, pour afficher les traces de pile symbolisées des plantages de bibliothèques natives dans le tableau de bord Crashlytics, vous devez importer des informations sur les symboles 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 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 version ultérieure) 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 > Fichier manifeste principal personnalisé).

      2. Ouvrez le modèle de fichier manifeste situé dans Assets/Plugins/Android/AndroidManifest.xml.

      3. (uniquement pour les applications utilisant une version de SDK antérieure à la version 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 cette procédure chaque fois que vous créez un build 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 Build Settings (Paramètres de compilation), effectuez l'une des opérations suivantes:

      • Exporter vers un projet Android Studio pour compiler votre projet ; ou

      • Créez votre APK directement depuis l'éditeur Unity.
        Avant la compilation, 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 compilation).

    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: votre ID d'application Android Firebase (et non votre nom de 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 correspond au répertoire unityLibrary/symbols, qui est créé dans la racine du projet exporté après avoir compilé l'application via Gradle ou Android Studio.

        • L'APK a été créé directement dans Unity. PATH/TO/SYMBOLS est le chemin d'accès du fichier de symboles compressé généré dans le répertoire racine du projet à la fin de la compilation (par exemple : myproject/myapp-1.0-v100.symbols.zip).

      Afficher les options avancées pour utiliser la commande 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

      Non recommandé. 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 la génération de fichiers de symboles par défaut est Breakpad. N'utilisez cet indicateur que si vous avez ajouté symbolGenerator { csym() } dans votre configuration de compilation et que vous souhaitez le remplacer pour utiliser Breakpad à la place.

      --dry-run

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

      Cet indicateur est utile si vous souhaitez inspecter le contenu des fichiers envoyés.

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