Iniziare a utilizzare Performance Monitoring per Android

Prima di iniziare

Se non l'hai già fatto, aggiungi Firebase al tuo progetto Android.

Passaggio 1: aggiungi l'SDK Performance Monitoring alla tua app

Dopo aver aggiunto l'SDK Performance Monitoring, Firebase inizia automaticamente a raccogliere i dati relativi al rendering dello schermo e i dati dell'app legati al ciclo di vita della tua app (ad es. ora di inizio dell'app). A abilitare Firebase per monitorare le richieste di rete, devi anche aggiungere Performance Monitoring Plug-in Gradle (passaggio successivo).

  1. Nel file Gradle del modulo (a livello di app) (di solito <project>/<app-module>/build.gradle.kts o <project>/<app-module>/build.gradle), aggiungi la dipendenza per la libreria Performance Monitoring per Android. Ti consigliamo di utilizzare Firebase Android BoM per controllare il controllo delle versioni delle librerie. 

    dependencies {
    // Import the BoM for the Firebase platform
    implementation(platform("com.google.firebase:firebase-bom:33.2.0"))

    // Add the dependency for the Performance Monitoring library
    // When using the BoM, you don't specify versions in Firebase library dependencies
    implementation("com.google.firebase:firebase-perf")
}

    Se utilizzi Firebase Android BoM, la tua app utilizzerà sempre versioni compatibili delle librerie Firebase Android.

    (Alternativa)  Aggiungi le dipendenze della libreria Firebase senza utilizzare il file BoM

    Se scegli di non utilizzare Firebase BoM, devi specificare ogni versione della libreria Firebase nella sua linea di dipendenza.

    Tieni presente che se nella tua app utilizzi più librerie Firebase, ti consigliamo vivamente di utilizzare BoM per gestire le versioni delle librerie, in modo da garantire la compatibilità di tutte le versioni. 

    dependencies {
    // Add the dependency for the Performance Monitoring library
    // When NOT using the BoM, you must specify versions in Firebase library dependencies
    implementation("com.google.firebase:firebase-perf:21.0.1")
}
         Cerchi un modulo della libreria specifico per Kotlin? A partire da ottobre 2023 (Firebase BoM 32.5.0), sia gli sviluppatori Kotlin che Java possono fare affidamento sul modulo della libreria principale (per maggiori dettagli, consulta le domande frequenti su questa iniziativa).

  2. Ricompila la tua app.

di Gemini Advanced.

Passaggio 2: aggiungi il plug-in Performance Monitoring Gradle alla tua app

Dopo aver aggiunto il plug-in Gradle Performance Monitoring, Firebase avvia automaticamente raccogliendo dati per Richieste di rete HTTP/S. Il plug-in consente inoltre di eseguire l'instrumentazione delle tracce di codice personalizzato utilizzando l'annotazione @AddTrace.

  1. Nel file Gradle a livello principale (a livello di progetto) (<project>/build.gradle.kts o <project>/build.gradle), aggiungi il Plug-in Performance Monitoring Gradle:

    Kotlin 

    plugins {
    // To benefit from the latest Performance Monitoring plugin features,
    // update your Android Gradle plugin dependency to at least v3.4.0
    id("com.android.application") version "7.3.0" apply false

    // Make sure that you have the Google services Gradle plugin dependency
    id("com.google.gms.google-services") version "4.4.2" apply false

    // Add the dependency for the Performance Monitoring Gradle plugin
    id("com.google.firebase.firebase-perf") version "1.4.2" apply false
}

    Groovy 

    plugins {
    // To benefit from the latest Performance Monitoring plugin features,
    // update your Android Gradle plugin dependency to at least v3.4.0
    id 'com.android.application' version '7.3.0' apply false

    // Make sure that you have the Google services Gradle plugin dependency
    id 'com.google.gms.google-services' version '4.4.2' apply false

    // Add the dependency for the Performance Monitoring Gradle plugin
    id 'com.google.firebase.firebase-perf' version '1.4.2' apply false
}

  2. Nel file Gradle del modulo (a livello di app) (di solito <project>/<app-module>/build.gradle.kts o <project>/<app-module>/build.gradle), aggiungi Performance Monitoring Plug-in Gradle:

    Kotlin 

    plugins {
    id("com.android.application")

    // Make sure that you have the Google services Gradle plugin
    id("com.google.gms.google-services")

    // Add the Performance Monitoring Gradle plugin
    id("com.google.firebase.firebase-perf")
    ...
}

    Groovy 

    plugins {
    id 'com.android.application'

    // Make sure that you have the Google services Gradle plugin
    id 'com.google.gms.google-services'

    // Add the Performance Monitoring Gradle plugin
    id 'com.google.firebase.firebase-perf'
    ...
}

  3. Ricompila l'app.

Passaggio 3. Genera eventi relativi al rendimento per la visualizzazione iniziale dei dati

Firebase avvia l'elaborazione degli eventi quando aggiungi correttamente l'SDK al tuo dell'app. Se stai ancora sviluppando localmente, interagisci con la tua app per generare per la raccolta e l'elaborazione iniziali dei dati.

  1. Genera eventi spostando la tua app dalla modalità in background a quella in primo piano e viceversa diverse volte, interagendo con l'app navigando su più schermate, e/o l'attivazione di richieste di rete.

  2. Vai alla dashboard Rendimento. della console Firebase. I dati iniziali vengono visualizzati entro alcuni minuti.

    Se i dati iniziali non vengono visualizzati, consulta la Risoluzione dei problemi suggerimenti.

Passaggio 4: (facoltativo) visualizza i messaggi di log per gli eventi di prestazioni

  1. Attiva il logging di debug per Performance Monitoring in fase di creazione aggiungendo un <meta-data> al file AndroidManifest.xml dell'app, in questo modo:

    <application>
    <meta-data
      android:name="firebase_performance_logcat_enabled"
      android:value="true" />
</application>

  2. Controlla se nei messaggi di log sono presenti messaggi di errore.

  3. Performance Monitoring contrassegna i propri messaggi di log con FirebasePerformance. Utilizzo di Logcat puoi visualizzare in modo specifico la traccia della durata e la rete HTTP/S esegui il logging delle richieste di log:

    adb logcat -s FirebasePerformance

  4. Controlla i seguenti tipi di log, che indicano che Performance Monitoring è nel logging degli eventi relativi alle prestazioni:

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

  5. Fai clic sull'URL per visualizzare i dati nella Console Firebase. L'operazione potrebbe richiedere alcuni i momenti necessari per aggiornare i dati nella dashboard.

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

Passaggio 5: (facoltativo) Aggiungi un monitoraggio personalizzato per un codice specifico

Per monitorare i dati sul rendimento associati a un codice specifico nella tua app, puoi: tracce di codice personalizzate dello strumento.

Con una traccia di codice personalizzata, puoi misurare il tempo necessario alla 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 tuo database. La metrica predefinita per una traccia di codice personalizzata è la sua durata, ma puoi anche aggiungere metriche personalizzate, come hit della cache e avvisi sulla memoria.

Nel codice, definisci l'inizio e la fine di una traccia di codice personalizzata (e aggiungi le metriche personalizzate che preferisci) utilizzando l'API fornita dall'SDK Performance Monitoring. Per le app per Android, puoi anche monitorare la durata metodi specifici utilizzando Annotazione@AddTrace.

Consulta Aggiungere il monitoraggio per un codice specifico per scoprire di più su queste funzionalità e su come aggiungerle alla tua app.

Passaggio 6: esegui il deployment dell'app ed esamina i risultati

Dopo aver convalidato Performance Monitoring utilizzando uno o più dispositivi di test, puoi: di eseguire il deployment della versione aggiornata dell'app per gli utenti.

Puoi monitorare i dati sul rendimento nella Dashboard Rendimento della console Firebase.

Problemi noti

  • Il plug-in Gradle Performance Monitoring versione 1.1.0 può causare una mancata corrispondenza nelle dipendenze di Guava, con il seguente errore:

    Error:Execution failed for task ':app:packageInstantRunResourcesDebug'.
> com.google.common.util.concurrent.MoreExecutors.directExecutor()Ljava/util/concurrent/Executor;

    Se viene visualizzato questo errore, puoi:

    • Esegui l'upgrade del plug-in Performance Monitoring alla versione 1.1.1 o successiva (il più recente è v1.4.2).

    • Sostituisci la riga delle dipendenze del plug-in Performance Monitoring nel tuo File Gradle a livello principale (a livello di progetto) (<project>/build.gradle.kts o <project>/build.gradle), come segue:

      Kotlin 

      buildscript {
  // ...

  dependencies {
    // ...

    // Replace the standard Performance Monitoring plugin dependency line, as follows:
    classpath("com.google.firebase:perf-plugin:1.1.0") {
        exclude(group = "com.google.guava", module = "guava-jdk5")
    }
  }
}

      Groovy 

      buildscript {
  // ...

  dependencies {
    // ...

    // Replace the standard Performance Monitoring plugin dependency line, as follows:
    classpath('com.google.firebase:perf-plugin:1.1.0') {
        exclude group: 'com.google.guava', module: 'guava-jdk5'
    }
  }
}

  • Performance Monitoring indica la dimensione totale del payload per le richieste di rete HTTP in base in base al valore impostato nell'intestazione HTTP content-length. Questo valore potrebbe non essere sempre precisi.

  • Performance Monitoring supporta solo il processo principale nelle app Android multi-processo.

Passaggi successivi