Questa guida rapida descrive come configurare Firebase Crashlytics nella tua app con il plug-in Crashlytics Flutter in modo da poter ottenere rapporti sugli arresti anomali completi nella console Firebase.
L'impostazione di Crashlytics comporta l'utilizzo sia di uno strumento da riga di comando che del tuo IDE. Per completare la configurazione, dovrai forzare la generazione di un'eccezione di test per inviare il tuo primo rapporto sull'arresto anomalo a Firebase.
Prima di iniziare
Se non lo hai già fatto, configura e inizializza Firebase nel tuo progetto Flutter.
Consigliato : per ottenere funzionalità come utenti senza arresti anomali, registri breadcrumb e avvisi sulla velocità, devi abilitare Google Analytics nel tuo progetto Firebase.
Tutte le piattaforme Android e Apple supportate da Crashlytics (tranne watchOS) possono sfruttare queste funzionalità di Google Analytics.
Assicurati che Google Analytics sia abilitato nel tuo progetto Firebase: vai su
> Impostazioni progetto > scheda Integrazioni , quindi segui le istruzioni sullo schermo per Google Analytics.
Passaggio 1 : aggiungi Crashlytics al tuo progetto Flutter
Dalla radice del tuo progetto Flutter, esegui il comando seguente per installare il plug-in Crashlytics Flutter:
flutter pub add firebase_crashlytics
Dalla directory principale del tuo progetto Flutter, esegui il seguente comando:
flutterfire configure
L'esecuzione di questo comando assicura che la configurazione Firebase dell'app Flutter sia aggiornata e, per Android, aggiunge il plug-in Crashlytics Gradle richiesto all'app.
Una volta completato, ricostruisci il tuo progetto Flutter:
flutter run
(Facoltativo) Se il tuo progetto Flutter utilizza il flag
--split-debug-info
(e, facoltativamente, il flag--obfuscate
), devi utilizzare l' interfaccia a riga di comando di Firebase (v.11.9.0+) per caricare i simboli Android.Dalla directory principale del tuo progetto Flutter, esegui il seguente comando:
firebase crashlytics:symbols:upload --app=APP_ID PATH/TO/symbols
La directory
PATH/TO /symbols
è la stessa directory che passi al flag--split-debug-info
durante la creazione dell'applicazione.
Passaggio 2 : configurare i gestori degli arresti anomali
Puoi rilevare automaticamente tutti gli errori generati all'interno del framework Flutter eseguendo l'override FlutterError.onError
con FirebaseCrashlytics.instance.recordFlutterFatalError
:
void main() async {
WidgetsFlutterBinding.ensureInitialized();
await Firebase.initializeApp();
// Pass all uncaught "fatal" errors from the framework to Crashlytics
FlutterError.onError = FirebaseCrashlytics.instance.recordFlutterFatalError;
runApp(MyApp());
}
Per rilevare errori asincroni che non sono gestiti dal framework Flutter, utilizza PlatformDispatcher.instance.onError
:
Future<void> main() async {
WidgetsFlutterBinding.ensureInitialized();
await Firebase.initializeApp();
FlutterError.onError = (errorDetails) {
FirebaseCrashlytics.instance.recordFlutterFatalError(errorDetails);
};
// Pass all uncaught asynchronous errors that aren't handled by the Flutter framework to Crashlytics
PlatformDispatcher.instance.onError = (error, stack) {
FirebaseCrashlytics.instance.recordError(error, stack, fatal: true);
return true;
};
runApp(MyApp());
}
Per esempi su come gestire altri tipi di errori, consulta Personalizzare i rapporti sugli arresti anomali .
Passaggio 3 : forza un arresto anomalo di prova per completare la configurazione
Per completare la configurazione di Crashlytics e visualizzare i dati iniziali nella dashboard di Crashlytics della console Firebase, devi forzare la generazione di un'eccezione di test.
Aggiungi codice alla tua app che puoi utilizzare per forzare la generazione di un'eccezione di test.
Se hai aggiunto un gestore di errori che chiama
FirebaseCrashlytics.instance.recordError(error, stack, fatal: true)
al livello superioreZone
, puoi utilizzare il codice seguente per aggiungere un pulsante alla tua app che, se premuto, genera un'eccezione di prova:TextButton( onPressed: () => throw Exception(), child: const Text("Throw Test Exception"), ),
Crea ed esegui la tua app.
Forza la generazione dell'eccezione di test per inviare il primo report della tua app:
Apri la tua app dal dispositivo o dall'emulatore di prova.
Nella tua app, premi il pulsante di eccezione del test che hai aggiunto utilizzando il codice sopra.
Vai alla dashboard di Crashlytics della console Firebase per vedere il crash di prova.
Se hai aggiornato la console e ancora non visualizzi l'arresto anomalo del test dopo cinque minuti, abilita la registrazione di debug per vedere se la tua app sta inviando rapporti sull'arresto anomalo.
E questo è tutto! Crashlytics sta ora monitorando la tua app per arresti anomali e, su Android, errori non irreversibili e ANR. Visita la dashboard di Crashlytics per visualizzare ed esaminare tutti i tuoi rapporti e le tue statistiche.
Prossimi passi
Personalizza la configurazione del rapporto sugli arresti anomali aggiungendo rapporti di attivazione, registri, chiavi e monitoraggio di ulteriori errori non irreversibili.
Integra con Google Play in modo da poter filtrare i rapporti sugli arresti anomali della tua app Android in base alla traccia di Google Play direttamente nella dashboard di Crashlytics. Ciò ti consente di focalizzare meglio la tua dashboard su build specifiche.
Visualizza le analisi dello stack e le statistiche sugli arresti anomali insieme al tuo codice con la finestra App Quality Insights in Android Studio (disponibile a partire da Electric Eel 2022.1.1).