Questa guida rapida descrive come configurare Firebase Performance Monitoring per aiutarti a ottenere insight sulle caratteristiche di rendimento delle tue app Flutter.
Prima di iniziare
Se non l'hai ancora fatto, configura e inizializza Firebase nel tuo progetto Flutter.
Passaggio 1: aggiungi Performance Monitoring alla tua app
Dalla directory principale del progetto Flutter, esegui questo comando per installare il plug-in Flutter di Performance Monitoring:
flutter pub add firebase_performanceDalla directory principale del progetto Flutter, esegui questo comando:
flutterfire configureL'esecuzione di questo comando garantisce che la configurazione Firebase della tua app Flutter sia aggiornata e, per Android, aggiunge alla tua app il plug-in Gradle di Performance Monitoring richiesto.
Al termine, ricrea il progetto Flutter:
flutter run
Dopo aver aggiunto l'SDK Performance Monitoring, Firebase inizia automaticamente a raccogliere dati relativi al ciclo di vita della tua app (come l'ora di inizio dell'app) e dati per le richieste di rete HTTP/S.
In Flutter, il monitoraggio automatico delle prestazioni di rendering dello schermo non è possibile per le singole schermate di Flutter. Un singolo view controller incapsula l'intera applicazione Flutter in modo nativo, pertanto l'SDK Firebase nativo sottostante non è a conoscenza delle transizioni tra schermate.
Passaggio 2: genera eventi relativi alle prestazioni per la visualizzazione iniziale dei dati
Firebase inizia a elaborare gli eventi quando aggiungi correttamente l'SDK alla tua app. Se stai ancora sviluppando localmente, interagisci con la tua app per generare eventi per la raccolta dei dati iniziale e l'elaborazione.
Continua a sviluppare la tua app utilizzando un simulatore o un dispositivo di test.
Genera eventi passando più volte l'app da background a primo piano, interagendo con l'app navigando tra le schermate e/o attivando richieste di rete.
Vai alla dashboard Prestazioni della console Firebase. Dovresti visualizzare i dati iniziali entro pochi minuti.
Se non vedi una visualizzazione dei dati iniziali, consulta i suggerimenti per la risoluzione dei problemi.
Passaggio 3: (facoltativo) visualizza i messaggi di log per gli eventi relativi alle prestazioni
Controlla i messaggi di log per verificare la presenza di eventuali messaggi di errore.
Performance Monitoring contrassegna i messaggi di log con i seguenti tag in modo che tu possa filtrarli:
- iOS+:
Firebase/Performance - Android:
FirebasePerformance
- iOS+:
Cerca i seguenti tipi di log che indicano che Performance Monitoring sta registrando eventi relativi alle prestazioni:
Logging trace metric: TRACE_NAME, FIREBASE_PERFORMANCE_CONSOLE_URLLogging network request trace: URL
Fai clic sull'URL per visualizzare i dati nella console Firebase. L'aggiornamento dei dati nella dashboard potrebbe richiedere alcuni istanti.
Passaggio 4: (facoltativo) aggiungi il monitoraggio personalizzato per un codice specifico
Per monitorare i dati sul rendimento associati a un codice specifico nella tua app, puoi strumentare le tracce del codice personalizzato.
Con una traccia del codice personalizzato, puoi misurare il tempo impiegato dalla tua app per completare un'attività o un insieme di attività specifiche, ad esempio il caricamento di un insieme di immagini o l'esecuzione di query sul database. La metrica predefinita per una traccia del codice personalizzato è la sua durata, ma puoi anche aggiungere metriche personalizzate, come successi della cache e avvisi di memoria.
Nel codice, definisci l'inizio e la fine di una traccia di codice personalizzato (e aggiungi le metriche personalizzate che preferisci) utilizzando l'API fornita dall'SDK Performance Monitoring.
Consulta Aggiungi il monitoraggio per un codice specifico per scoprire di più su queste funzionalità e su come aggiungerle alla tua app.
Passaggio 5: esegui il deployment dell'app, quindi esamina i risultati
Dopo aver convalidato Performance Monitoring utilizzando un emulatore e uno o più dispositivi di test, puoi eseguire il deployment della versione aggiornata della tua app per gli utenti.
Puoi monitorare i dati sul rendimento nella dashboard Prestazioni della console Firebase.
Passaggi successivi
Scopri di più sui dati raccolti automaticamente da Performance Monitoring:
- Dati relativi al ciclo di vita dell'app, ad esempio il tempo di avvio dell'app
- Dati relativi alle richieste di rete HTTP/S inviate dalla tua app
Visualizza, monitora e filtra i dati sul rendimento nella console Firebase.
Aggiungi il monitoraggio per attività o workflow specifici nella tua app strumentando le tracce di codice personalizzate.