Ce guide de démarrage rapide explique comment configurer Firebase Crashlytics dans votre application avec le SDK Firebase Crashlytics afin de pouvoir obtenir des rapports d'erreur 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 ajouter un fichier de configuration Firebase et le SDK Crashlytics). Pour terminer la configuration, vous devez forcer un plantage de test afin d'envoyer votre premier rapport de plantage à Firebase.
Avant de commencer
Si vous ne l'avez pas déjà fait, ajoutez Firebase à votre projet Apple. Si vous ne disposez d'aucune application Apple, vous pouvez télécharger une application exemple.
Recommandé : Pour obtenir automatiquement des journaux de repères afin de comprendre les actions des utilisateurs ayant conduit à un plantage, un problème non fatal ou un événement ANR, vous devez activer Google Analytics dans votre projet Firebase.
Si Google Analytics n'est pas activé dans votre projet Firebase existant, vous pouvez l'activer dans l'onglet Integrations (Intégrations) de
(Paramètres du projet) dans la console > Project settingsFirebase. Si vous créez un projet Firebase, activez Google Analytics pendant le workflow de création de projet.
Étape 1: Ajoutez le SDK Crashlytics à votre application
Utilisez Swift Package Manager pour installer et gérer les dépendances Firebase.
- Dans Xcode, à partir de votre projet d'application ouvert, accédez à File > Add Packages (Fichier > Ajouter des packages).
- Lorsque vous y êtes invité, ajoutez le dépôt du SDK des plates-formes Firebase pour Apple :
- Sélectionnez la bibliothèque Crashlytics.
- Pour profiter des journaux de fil d'Ariane, ajoutez également le SDK Firebase pour Google Analytics à votre application. Assurez-vous que Google Analytics est activé dans votre projet Firebase.
- Ajoutez l'indicateur
-ObjC
à la section Other Linker Flags (Autres indicateurs Linker) des paramètres de compilation de votre cible. - (macOS uniquement) Dans votre
Info.plist
, ajoutez la cléNSApplicationCrashOnExceptions
et définissez-la surYES
. - Lorsque vous avez terminé, Xcode commence à résoudre et à télécharger automatiquement vos dépendances en arrière-plan.
https://github.com/firebase/firebase-ios-sdk.git
Configurez ensuite le module Firebase :
Importez le module Firebase dans votre struct
App
ouUIApplicationDelegate
:Swift
import Firebase
Objective-C
@import Firebase;
Configurez une instance partagée
FirebaseApp
, généralement dans la méthodeapplication(_:didFinishLaunchingWithOptions:)
de votre délégué d'application:Swift
// Use the Firebase library to configure APIs. FirebaseApp.configure()
Objective-C
// Use the Firebase library to configure APIs. [FIRApp configure];
Étape 3: Forcez un test de plantage pour terminer la configuration
Pour terminer la configuration de Crashlytics et afficher les données initiales dans le tableau de bord Crashlytics de la console Firebase, vous devez forcer un plantage de test.
C'est tout ! Crashlytics surveille désormais les plantages de votre application. Accédez au tableau de bord Crashlytics pour afficher et examiner tous vos rapports et statistiques.
Étapes suivantes
- Personnalisez la configuration de vos rapports de plantage en ajoutant des rapports, des journaux, des clés et le suivi des erreurs non fatales.
- Intégrez Google Play pour filtrer les rapports d'erreur de votre application Android par canal Google Play directement dans le tableau de bord Crashlytics. Vous pouvez ainsi mieux cibler votre tableau de bord sur des builds spécifiques.