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 iOS. Si vous ne disposez pas d' une application iOS, 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. Ouvrez le PODFILE vous avez créé pour votre projet Firebase et ajoutez le FirebaseCrashlytics pod.

    Pour une expérience optimale avec Crashlytics, nous vous recommandons de permettre à Google Analytics dans votre projet Firebase et en ajoutant 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 gousses, puis re-ouvrir votre .xcworkspace fichier pour voir le projet dans Xcode:

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

    Rapide

    import Firebase

    Objectif c

    @import Firebase;
  4. Configurer une FirebaseApp instance partagée, généralement dans votre application 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];
    

Etape 3: Mettre en place Xcode pour télécharger automatiquement des fichiers dSYM

Pour générer des rapports d'incident lisibles par l'homme, Crashlytics a besoin des fichiers de symboles de débogage (dSYM) de votre projet. Les étapes suivantes décrivent comment configurer Xcode pour produire automatiquement vos dSYM, les traiter et télécharger les fichiers chaque fois que vous créez votre application.

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

  2. Dans la liste Targets, sélectionnez votre cible principale de construction.

  3. Cliquez sur l'onglet Paramètres de compilation, puis suivez les étapes suivantes pour que Xcode produit dSYMs pour votre builds.

    1. Cliquez sur Tous, puis recherchez le debug information format .

    2. Définir le format d' informations de débogage à NAIN avec dSYM fichier pour tous vos types de construction.

  4. Cliquez sur l'onglet Construire des phases, puis suivez les étapes suivantes afin que Xcode peut traiter vos dSYMs et télécharger les fichiers.

    1. Cliquez sur > Nouvelle phase d' exécution de script.

      Assurez - vous que cette nouvelle phase Exécuter le script est la dernière phase de construction de votre projet; sinon, Crashlytics ne peut pas traiter correctement les dSYM.

    2. Développez la nouvelle section Exécuter le script.

    3. Dans le champ de script (situé sous le label Shell), ajoutez le script d'exécution ci - dessous.

      Ce script traite les fichiers dSYM de votre projet et télécharge les fichiers vers Crashlytics.

      "${PODS_ROOT}/FirebaseCrashlytics/run"
    4. Dans la section Fichiers d'entrée, ajoutez les chemins pour les fichiers suivants.

      • Ajoutez le chemin d'accès aux fichiers dSYM de votre projet

        Cela permet à Crashlytics de traiter plus rapidement les dSYM pour les applications volumineuses.

        ${DWARF_DSYM_FOLDER_PATH}/${DWARF_DSYM_FILE_NAME}/Contents/Resources/DWARF/${TARGET_NAME}
      • Ajouter le chemin à construire votre projet Info.plist fichier

        Cela permet à Crashlytics d'associer une version d'application aux dSYM.

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

Pour plus d' informations sur les fichiers dSYM et Crashlytics (y compris comment télécharger manuellement les fichiers dSYM), visitez Obtenir deobfuscated rapports d' erreur .

Étape 4: 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.


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