Inizia a utilizzare Firebase Crashlytics

iOS+ Android Flutter Unity

Questa guida rapida descrive come configurare Firebase Crashlytics nella tua app con l'SDK Firebase Crashlytics in modo da poter ricevere report completi sugli arresti anomali nella console Firebase.

La configurazione di Crashlytics richiede attività sia nella console Firebase sia nel IDE (ad esempio l'aggiunta di un file di configurazione di Firebase e dell'SDK Crashlytics). Per completare la configurazione, devi forzare un arresto anomalo di prova per inviare il primo report sugli arresti anomali a Firebase.

Prima di iniziare

1. Se non lo hai già fatto, aggiungi Firebase al tuo progetto Apple. Se non hai un'app Apple, puoi scaricare un'app di esempio.

2. Consigliato: per ottenere automaticamente i log dei breadcrumb per comprendere le azioni dell'utente che hanno portato a un arresto anomalo, a un evento non irreversibile o ANR, devi attivare Google Analytics nel tuo progetto Firebase.

   • Se nel tuo progetto Firebase esistente Google Analytics non è attivato, puoi attivarlo dalla scheda Integrazioni del tuo > Impostazioni progetto nella console Firebase.Google Analytics

   • Se stai creando un nuovo progetto Firebase, abilita Google Analytics durante il flusso di lavoro di creazione del progetto.

Passaggio 1: aggiungi l'SDK Crashlytics alla tua app

Utilizza Swift Package Manager per installare e gestire le dipendenze di Firebase.

Consulta la nostra guida all'installazione per scoprire i diversi modi in cui puoi aggiungere gli SDK Firebase al tuo progetto Apple, tra cui l'importazione diretta dei framework e l'utilizzo di CocoaPods.

1. In Xcode, con il progetto dell'app aperto, vai a File > Aggiungi pacchetti.
2. Quando richiesto, aggiungi il repository dell'SDK delle piattaforme Apple di Firebase:

  https://github.com/firebase/firebase-ios-sdk.git

Nota: i nuovi progetti devono utilizzare la versione predefinita (più recente) dell'SDK, ma se necessario puoi scegliere una versione precedente.
3. Scegli la raccolta Crashlytics.
4. Per sfruttare i log dei breadcrumb, aggiungi all'app anche l'SDK Firebase per Google Analytics. Assicurati che Google Analytics sia attivato nel progetto Firebase.
5. Aggiungi il flag -ObjC alla sezione Altri flag del linker delle impostazioni di compilazione del target.
6. (solo macOS) In Info.plist, aggiungi la chiave NSApplicationCrashOnExceptions e impostala su YES.
7. Al termine, Xcode inizierà automaticamente a risolvere e a scaricare le tue dipendenze in background.

A questo punto, configura il modulo Firebase:

1. Importa il modulo Firebase nella struct App o in UIApplicationDelegate:

   Swift

   import Firebase

   Objective-C

   @import Firebase;

2. Configura un'istanza condivisa FirebaseApp, in genere nel metodo application(_:didFinishLaunchingWithOptions:) del tuo app delegate:

   Swift

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

   Objective-C

   // Use the Firebase library to configure APIs.
   [FIRApp configure];
   

Passaggio 3: forza un arresto anomalo del test per completare la configurazione

Per completare la configurazione di Crashlytics e visualizzare i dati iniziali nella dashboard di Crashlytics della console Firebase, devi forzare un arresto anomalo del test.

E questo è tutto. Crashlytics sta ora monitorando la tua app per rilevare arresti anomali. Visita la dashboard Crashlytics per visualizzare e analizzare tutti i report e le statistiche.

Passaggi successivi

• Personalizza la configurazione dei report sugli arresti anomali aggiungendo report, log, chiavi e monitoraggio degli errori non fatali che puoi attivare.

• Esegui l'integrazione con Google Play in modo da poter filtrare i report sugli arresti anomali della tua app per Android in base al canale Google Play direttamente nella dashboard di Crashlytics. In questo modo puoi concentrare meglio la dashboard su build specifiche.