Inizia con il monitoraggio delle prestazioni per le piattaforme Apple

Prima di iniziare

Se non lo hai già fatto, aggiungi Firebase al tuo progetto Apple .

Passaggio 1 : aggiungi il monitoraggio delle prestazioni alla tua app

Dopo aver aggiunto l'SDK di monitoraggio delle prestazioni, Firebase inizia automaticamente a raccogliere i dati per il rendering dello schermo dell'app, i dati relativi al ciclo di vita dell'app (come l' ora di inizio dell'app ) e i dati per le richieste di rete HTTP/S .

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

  1. In Xcode, con il progetto dell'app aperto, vai su File > Aggiungi pacchetti .
  2. Quando richiesto, aggiungi il repository SDK delle piattaforme Apple Firebase:
    3.   https://github.com/firebase/firebase-ios-sdk
  3. Scegli la libreria Monitoraggio delle prestazioni.
  4. Al termine, Xcode inizierà automaticamente a risolvere e scaricare le tue dipendenze in background.

Quindi, configura il modulo Firebase:

  1. Importa il modulo FirebaseCore nel tuo UIApplicationDelegate , così come qualsiasi altro modulo Firebase utilizzato dal delegato dell'app. Ad esempio, per utilizzare Cloud Firestore e l'autenticazione:

    Veloce

    import FirebaseCore
import FirebaseFirestore
import FirebaseAuth
// ...

    Obiettivo-C

    @import FirebaseCore;
@import FirebaseFirestore;
@import FirebaseAuth;
// ...
  2. Configura un'istanza condivisa FirebaseApp , in genere nell'inizializzatore App o nel metodo dell'applicazione del delegato application(_:didFinishLaunchingWithOptions:) :

    Veloce

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

    Obiettivo-C

    // Use Firebase library to configure APIs
[FIRApp configure];
  1. Ricompila la tua app.

Passaggio 2 : generare eventi di 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 e l'elaborazione dei dati iniziali.

  1. Continua a sviluppare la tua app utilizzando un simulatore o un dispositivo di prova.

  2. Genera eventi spostando più volte la tua app tra lo sfondo e il primo piano, interagendo con la tua app navigando tra le schermate e/o attivando richieste di rete.

  3. Vai alla dashboard delle prestazioni della console Firebase. Dovresti vedere i tuoi dati iniziali visualizzati entro pochi minuti.

    Se non vedi una visualizzazione dei tuoi dati iniziali, consulta i suggerimenti per la risoluzione dei problemi .

Passaggio 3 : (facoltativo) visualizzare i messaggi di registro per gli eventi relativi alle prestazioni

  1. Abilita la registrazione del debug, come segue:

    1. In Xcode (minimo v13.3.1), seleziona Prodotto > Schema > Modifica schema .
    2. Seleziona Esegui dal menu a sinistra, quindi seleziona la scheda Argomenti .
    3. Nella sezione Argomenti passati all'avvio, aggiungi -FIRDebugEnabled .

  2. Controlla i messaggi di registro per eventuali messaggi di errore.

  3. Monitoraggio delle prestazioni contrassegna i suoi messaggi di registro con Firebase/Performance in modo da poter filtrare i messaggi di registro.

  4. Verificare la presenza dei seguenti tipi di log che indicano che il monitoraggio delle prestazioni sta registrando gli eventi delle prestazioni:

    • Logging trace metric: TRACE_NAME , FIREBASE_PERFORMANCE_CONSOLE_URL
    • Logging network request trace: URL

  5. Fai clic sull'URL per visualizzare i tuoi dati nella console Firebase. L'aggiornamento dei dati nella dashboard potrebbe richiedere alcuni istanti.

Se la tua app non registra gli eventi relativi alle prestazioni, consulta i suggerimenti per la risoluzione dei problemi .

Passaggio 4 : (facoltativo) aggiungi il monitoraggio personalizzato per codice specifico

Per monitorare i dati sulle prestazioni associati a codice specifico nella tua app, puoi strumentare tracce di codice personalizzate .

Con una traccia del codice personalizzata, puoi misurare quanto tempo impiega la tua app per completare un'attività specifica o una serie di attività, come il caricamento di una serie di immagini o l'esecuzione di query sul database. La metrica predefinita per una traccia di codice personalizzata è la sua durata, ma puoi anche aggiungere metriche personalizzate, come hit cache e avvisi di memoria.

Nel codice, definisci l'inizio e la fine di una traccia del codice personalizzato (e aggiungi le metriche personalizzate desiderate) utilizzando l'API fornita dall'SDK di monitoraggio delle prestazioni.

Visita Aggiungi monitoraggio per codice specifico per ulteriori informazioni su queste funzionalità e su come aggiungerle alla tua app.

Passaggio 5 : distribuisci la tua app, quindi rivedi i risultati

Dopo aver convalidato il monitoraggio delle prestazioni utilizzando il simulatore Xcode e uno o più dispositivi di test, puoi distribuire la versione aggiornata della tua app ai tuoi utenti.

Puoi monitorare i dati sulle prestazioni nella dashboard delle prestazioni della console Firebase.

Problemi noti

  • Il monitoraggio delle prestazioni ha problemi di compatibilità noti con GTMSQLite. Ti consigliamo di non utilizzare il monitoraggio delle prestazioni con app che utilizzano GTMSQLite.
  • Il swizzling del metodo dopo aver chiamato FirebaseApp.configure() potrebbe interferire con l'SDK di monitoraggio delle prestazioni.
  • Problemi noti con il simulatore iOS 8.0-8.2 impediscono al monitoraggio delle prestazioni di acquisire gli eventi relativi alle prestazioni. Questi problemi sono stati risolti in iOS 8.3 Simulator e versioni successive.
  • Le connessioni stabilite utilizzando backgroundSessionConfiguration di NSURLSession mostreranno tempi di connessione più lunghi del previsto. Queste connessioni vengono eseguite out-of-process e le temporizzazioni riflettono eventi di callback in-process.

Prossimi passi