Google 致力于为黑人社区推动种族平等。查看具体举措

Premiers pas avec Firebase Crashlytics

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

La configuration de Crashlytics nécessite des tâches à la fois dans la console Firebase et dans votre IDE (comme l'ajout d'un fichier de configuration Firebase et du SDK Crashlytics). Pour terminer la configuration, vous devrez forcer un test de plantage pour envoyer votre premier rapport de plantage à Firebase.

Avant que tu commences

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

  2. Recommandé: Pour obtenir des fonctionnalités comme les utilisateurs sans accident, les journaux panés et les alertes de vitesse, vous devez activer Google Analytics dans votre projet Firebase.

    • Si votre projet Firebase existant ne pas Google Analytics activé, vous pouvez activer Google Analytics à partir de l' onglet Intégrations de vos > Paramètres du projet dans la console Firebase.

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

Étape 1: Activer Crashlytics dans la console Firebase

  1. Accédez au tableau de bord Crashlytics dans la console Firebase.

  2. Assurez - vous que votre application est sélectionnée dans le menu déroulant à côté de Crashlytics en haut de la page.

  3. Cliquez sur Activer Crashlytics.

Étape 2: Ajouter le Firebase Crashlytics SDK à votre application

  1. Télécharger le Unity Firebase SDK , puis décompressez le SDK endroit pratique.

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

  2. Dans votre projet open Unity, accédez à l' actif> Importer le package> Package personnalisé.

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

    Vous pouvez importer tout autre produit Firebase pris en charge , ainsi.

  4. Dans la fenêtre d' importation Package unité, cliquez sur Importer.

Étape 3: Initialiser Crashlytics

  1. Créer un nouveau script C #, puis l' ajouter à un GameObject dans la scène.

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

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

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

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

    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()
        // ...
    }

Étape 4: Lancez votre projet

  1. Exportez votre projet vers iOS ou vers Android.

  2. Une fois l'exportation terminée, vérifiez que le projet a été correctement exporté en comparant votre projet exporté aux exemples de configurations d'exportation ci-dessous.

    S'il semble que des fichiers manquent après avoir comparé votre projet, ouvrez votre éditeur Unity, puis exécutez Google Play Services Resolver (retrouvez les instructions ci-dessous).

    iOS

    Android

Exécutez le résolveur si les fichiers sont manquants après l' exportation (au besoin)

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 README pour le pot unité résolveur .

Étape 5: Force un accident de test pour terminer l' installation

Pour terminer la configuration de Crashlytics et voir les données initiales dans le tableau de bord Crashlytics de la console Firebase, vous devez forcer un crash test.

  1. Dans la fenêtre Hiérarchie, créer un nouvel objet:

    1. Faites un clic droit et sélectionnez Créer un vide pour ajouter un nouveau vide GameObject à une scène dans votre jeu.

    2. Nommez le nouvel objet CrashlyticsTester .

    3. Assurez - vous que le CrashlyticsTester objet est sélectionné avant de poursuivre.

  2. Dans l'onglet Inspecteur, ajouter un nouveau script qui va provoquer un crash - test quelques secondes après avoir exécuté votre application:

    1. Cliquez sur Ajouter des composants.

    2. Sélectionnez Nouveau script au bas de la liste des composants.

    3. Nommez le nouveau script CrashlyticsTester ainsi, puis ajoutez le contenu suivant au script:

      using System;
      using UnityEngine;
      
      public class CrashlyticsTester : MonoBehaviour {
      
          int updatesBeforeException;
      
          // Use this for initialization
          void Start () {
            updatesBeforeException = 0;
          }
      
          // Update is called once per frame
          void Update()
          {
              // Call the exception-throwing method here so that it's run
              // every frame update
              throwExceptionEvery60Updates();
          }
      
          // A method that tests your Crashlytics implementation by throwing an
          // exception every 60 frame updates. You should see non-fatal errors in the
          // Firebase console a few minutes after running your app with this method.
          void throwExceptionEvery60Updates()
          {
              if (updatesBeforeException > 0)
              {
                  updatesBeforeException--;
              }
              else
              {
                  // Set the counter to 60 updates
                  updatesBeforeException = 60;
      
                  // Throw an exception to test your Crashlytics implementation
                  throw new System.Exception("test exception please ignore");
              }
          }
      }
      
  3. Créez et exécutez votre application :

    1. Allez à Fichier> Générer Paramètres, puis choisissez Android ou iOS dans la liste des plates - formes.

    2. Cliquez sur Générer et exécuter votre application pour iOS ou Android.

  4. Une fois que votre application est en cours d' exécution, regarder le journal de l' appareil et attendez que l'exception à la gâchette du CrashlyticsTester .

    • iOS: Afficher les journaux dans le volet inférieur de Xcode.

    • Android: Afficher les journaux en exécutant la commande suivante dans le terminal: adb logcat .

  5. Lorsque vous voyez l'exception dans le journal de votre appareil, redémarrez votre application afin qu'elle puisse envoyer le rapport de plantage à Firebase.

  6. Accédez au tableau de bord Crashlytics de la console Firebase pour voir votre crash test.

    Si vous avez rafraîchi la console et vous n'êtes toujours pas vu le crash test au bout de cinq minutes, activer la journalisation de débogage pour voir si votre application envoie des rapports d'erreur.


Et c'est tout! Crashlytics surveille désormais les plantages de votre application, et vous pouvez afficher et examiner les rapports de plantage et les statistiques dans le tableau de bord Crashlytics.

Prochaines étapes