Check out what’s new from Firebase@ Google I/O 2021, and join our alpha program for early access to the new Remote Config personalization feature. Learn more

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 .

Avant que tu commences

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

  2. Recommandé : pour obtenir des fonctionnalités telles que les utilisateurs sans plantage, les journaux de fil d'Ariane et les alertes de vitesse, vous devez activer Google Analytics dans votre projet Firebase.

    • Si Google Analytics n'est pas activé dans votre projet Firebase existant, 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 : 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 le SDK Firebase Crashlytics à votre application

  1. Ouvrez le podfile que vous avez créé pour votre projet Firebase et ajoutez le pod FirebaseCrashlytics .

    Pour une expérience optimale avec Crashlytics, nous vous recommandons d' activer Google Analytics dans votre projet Firebase et d'ajouter le pod Firebase pour Google Analytics à votre application.

    pod 'Firebase/Crashlytics'
    
    # Recommended: Add the Firebase pod for Google Analytics
    pod 'Firebase/Analytics'
    
  2. Installez les pods, puis .xcworkspace votre fichier .xcworkspace pour voir le projet dans Xcode :

    pod install
    open your-project.xcworkspace
    
  3. Importez le module Firebase dans votre UIApplicationDelegate :

    Rapide

    import Firebase

    Objectif c

    @import Firebase;
  4. Configurez une instance partagée FirebaseApp , généralement dans l'application de votre application:didFinishLaunchingWithOptions: méthode :

    Rapide

      // Use the Firebase library to configure APIs.
      FirebaseApp.configure()
      

    Objectif c

      // Use the Firebase library to configure APIs.
      [FIRApp configure];
      
  5. Recompilez votre application.

Étape 3 : Initialiser Crashlytics

Vous pouvez initialiser Crashlytics en ajoutant un script d'exécution à la phase de génération de votre projet. Le script d'exécution permet à Xcode de télécharger automatiquement le fichier dSYM de votre projet chaque fois que votre application se bloque afin que Crashlytics puisse générer automatiquement des rapports de plantage.

  1. Ouvrez votre projet dans Xcode, puis sélectionnez son fichier projet dans le navigateur de gauche.

  2. Dans la liste déroulante Sélectionner un projet ou une cible , sélectionnez votre cible de build principale.

  3. Sélectionnez l'onglet Phases de génération, puis cliquez sur > Nouvelle phase de script d'exécution .

  4. Développez la nouvelle section Exécuter le script qui apparaît. Dans le champ de script (situé sous le champ Shell ), ajoutez un nouveau script d'exécution :

    "${PODS_ROOT}/FirebaseCrashlytics/run"
  5. Ajoutez l'emplacement dSYM de votre application en tant que fichier d'entrée qui permet à Crashlytics de générer automatiquement plus rapidement des dSYM pour les applications volumineuses. Par example:

    ${DWARF_DSYM_FOLDER_PATH}/${DWARF_DSYM_FILE_NAME}/Contents/Resources/DWARF/${TARGET_NAME}
    

    Vous pouvez également fournir l'emplacement Info.plist intégré de votre application au champ Fichiers d'entrée de la phase de génération :

    $(SRCROOT)/$(BUILT_PRODUCTS_DIR)/$(INFOPLIST_PATH)

Après avoir ajouté le SDK à votre application, Crashlytics se met automatiquement au travail en écoutant et en collectant les rapports de plantage.

Étape 4 : Exécutez votre projet

Enfin, lancez votre application. Les journaux de votre appareil affichent la vérification Firebase que l'initialisation est terminée.

Étape 5 : Forcer un crash test pour terminer la configuration

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.

Pour plus d'informations sur la procédure à suivre, consultez Tester votre implémentation .

Prochaines étapes