Google 致力于为黑人社区推动种族平等。查看具体举措
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 iOS. Si vous ne disposez pas d'une application iOS, vous pouvez télécharger un exemple d'application .

  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. Ouvrez le podfile que vous avez créé pour votre projet Firebase et ajoutez le pod FirebaseCrashlytics . Pour une expérience optimale avec Firebase Crashlytics, nous vous recommandons d'activer Google Analytics dans votre projet en ajoutant également le pod Firebase pour Analytics à votre application. Assurez-vous d'ajouter Google Analytics version 6.3.1 ou ultérieure afin d'obtenir des utilisateurs et des fil d'Ariane en temps réel sans plantage.

    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: method:

    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 construction 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 d'erreur.

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

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

  3. Sélectionnez l'onglet Phases de construction , 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 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 grandes applications. Par exemple:

    ${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 dans le champ Fichiers d'entrée de la phase de construction:

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

Une fois que vous avez ajouté le SDK à votre application, Crashlytics se met automatiquement au travail en écoutant et en collectant les rapports d'erreur.

Étape 4 : Exécutez votre projet

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

Prochaines étapes