This guide contains instructions for the latest version of the Firebase Crashlytics SDK. If you migrated your app from Fabric, make sure it's been upgraded and no longer uses the deprecated legacy Fabric SDK.
Cette page a été traduite par l'API Cloud Translation.
Switch to English

Premiers pas avec Firebase Crashlytics

Ce guide de démarrage rapide décrit comment configurer Firebase Crashlytics dans votre application avec le SDK Firebase Crashlytics, afin que vous puissiez obtenir des rapports d'incidents complets dans la console Firebase .

Avant que tu commences

  1. Si vous ne l'avez pas déjà fait, ajoutez Firebase à votre projet Unity. Si vous n'avez pas de projet Unity, vous pouvez télécharger un exemple d'application .

    Notez que l'ajout de Firebase à votre projet Unity implique des tâches à la fois dans la console Firebase et dans votre projet Unity ouvert (par exemple, vous téléchargez les fichiers de configuration Firebase depuis la console, puis les déplacez dans votre projet Unity).

  2. Facultatif : pour obtenir des métriques de plantage telles que les utilisateurs sans plantage, le fil d'Ariane et les événements personnalisés, vous devez activer Google Analytics dans votre projet Firebase.

    1. Si votre projet Firebase existant n'a pas activé Google Analytics, vous pouvez activer Google Analytics à partir de l' onglet Intégrations de vos > Paramètres du projet .

      Si vous créez un nouveau projet Firebase, activez Google Analytics pendant le processus de création de projet.

    2. Enfin, dans la console Google Analytics, activez le partage de données dans l'onglet Admin > Paramètres du compte > Paramètres de partage de données .

      Pour les projets Firebase plus anciens, notez que vous devrez peut-être activer le partage de données dans l' onglet Intégrations de vos > Paramètres du projet (dans la console Firebase).

Étape 1 : configurer Crashlytics dans la console Firebase

  1. Cliquez sur Crashlytics dans le panneau de navigation de gauche de la console Firebase .

  2. Si votre projet Firebase contient plusieurs applications enregistrées, sélectionnez l'application que vous venez d'ajouter dans la liste déroulante à côté de Crashlytics dans la barre supérieure de la console.

  3. Cliquez sur Activer Crashlytics .

Étape 2 : ajoutez Firebase Crashlytics à votre application

  1. Téléchargez le SDK Firebase Unity , puis décompressez le SDK dans un endroit pratique.

    Le SDK Firebase Unity n'est pas spécifique à la plate-forme.

  2. Dans votre projet Unity ouvert, accédez à Assets > Importer un package > Package personnalisé .

  3. À partir du SDK décompressé, sélectionnez pour importer le SDK Crashlytics ( FirebaseCrashlytics.unitypackage ).

    Vous pouvez également importer tout autre produit Firebase pris en charge .

  4. Dans la fenêtre Importer un package Unity , cliquez sur Importer .

Étape 3 : initialiser Crashlytics

  1. Créez un nouveau script C #, puis ajoutez-le à un GameObject dans la scène.

    1. Ouvrez votre première scène, puis créez un GameObject vide nommé CrashlyticsInitializer .

    2. Cliquez sur Ajouter un composant dans l' inspecteur pour le nouvel objet.

    3. Sélectionnez votre script CrashlyticsInit pour l'ajouter à l'objet CrashlyticsInitializer .

  2. Initialisez Crashlytics dans la méthode Start du script:

    using System.Collections;
    using System.Collections.Generic;
    using UnityEngine;
    
    // Import Firebase
    using Firebase;
    
    public class CrashlyticsInit : MonoBehaviour {
        // Use this for initialization
        void Start () {
            // Initialize Firebase
            Firebase.FirebaseApp.CheckAndFixDependenciesAsync().ContinueWith(task => {
                var dependencyStatus = task.Result;
                if (dependencyStatus == Firebase.DependencyStatus.Available)
                {
                    // Create and hold a reference to your FirebaseApp,
                    // where app is a Firebase.FirebaseApp property of your application class.
                    // Crashlytics will use the DefaultInstance, as well;
                    // this ensures that Crashlytics is initialized.
                    Firebase.FirebaseApp app = Firebase.FirebaseApp.DefaultInstance;
    
                    // Set a flag here for indicating that your project is ready to use Firebase.
                }
                else
                {
                    UnityEngine.Debug.LogError(System.String.Format(
                      "Could not resolve all Firebase dependencies: {0}",dependencyStatus));
                    // Firebase Unity SDK is not safe to use here.
                }
            });
        }
    
      // Update is called once per frame
      void Update()
        // ...
    }

Avec l'ajout et l'initialisation du SDK, Crashlytics se met automatiquement au travail en écoutant et en collectant les rapports d'erreur.

Étape 4 : Exécutez votre projet

Après avoir exporté votre projet vers iOS ou Android , vérifiez que le projet s'est correctement exporté.

S'il semble que des fichiers manquent après avoir comparé votre projet aux exemples de configurations d'exportation ci-dessous, ouvrez votre éditeur Unity, puis exécutez le résolveur de services Google Play .

iOS

Android

Exécutez le résolveur (facultatif)

Les résolveurs des services Google Play s'assurent que votre projet Unity possède les dépendances appropriées pour exporter votre application vers iOS ou Android .

Pour plus d'informations sur le résolveur, visitez le fichier README pour le résolveur Unity Jar .

iOS

Le résolveur iOS s'exécute automatiquement et exploite les Cocoapods pour placer les dépendances iOS dans le répertoire Pods exporté.

  • Pour télécharger des Cocoapods sur votre machine:

    • Accédez à Assets > Play Services Resolver > iOS Resolver > Install Cocoapods
  • Pour activer ou désactiver la génération de podfiles (facultatif) :

    • Accédez à Assets > Play Services Resolver > iOS Resolver > Paramètres.

Android

Le résolveur Android s'exécute automatiquement et exploite gradle pour placer les dépendances Android dans Assets/Plugins/Android .

  • Pour exécuter manuellement le résolveur:

    • Accédez à Assets > Play Services Resolver > Android Resolver > Resolve.
  • Pour activer ou désactiver la résolution automatique (activée par défaut):

    • Accédez à Actifs > Résolveur des services Play > Résolveur Android > Paramètres.

Prochaines étapes