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
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 .
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.
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.
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
Cliquez sur Crashlytics dans le panneau de navigation de gauche de la console Firebase .
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.
Cliquez sur Activer Crashlytics .
Étape 2 : ajoutez Firebase Crashlytics à votre application
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'
Installez les pods, puis
.xcworkspace
votre fichier.xcworkspace
pour voir le projet dans Xcode:pod install
open your-project.xcworkspace
Importez le module Firebase dans votre
UIApplicationDelegate
:Rapide
import Firebase
Objectif c
@import Firebase;
Configurez une instance partagée
FirebaseApp
, généralement dans l'application de votreapplication:didFinishLaunchingWithOptions:
method:Rapide
// Use the Firebase library to configure APIs. FirebaseApp.configure()
Objectif c
// Use the Firebase library to configure APIs. [FIRApp configure];
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.
Ouvrez votre projet dans Xcode, puis sélectionnez son fichier projet dans le navigateur de gauche.
Dans la liste déroulante Sélectionnez un projet ou une cible , sélectionnez votre cible de construction principale.
Sélectionnez l'onglet Phases de construction , puis cliquez sur
> Nouvelle phase de script d'exécution .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"
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
Testez votre configuration Crashlytics en forçant un crash dans la console Firebase.
Personnalisez la configuration de votre rapport d'erreur en ajoutant des rapports, des journaux, des clés et un suivi des erreurs non fatales.