Save the date - Google I/O returns May 18-20. Register to get the most out of the digital experience: Build your schedule, reserve space, participate in Q&As, earn Google Developer profile badges, and more. Register now
Diese Seite wurde von der Cloud Translation API übersetzt.
Switch to English

Beginnen Sie mit der Leistungsüberwachung für Android

Bevor Sie beginnen

Wenn Sie dies noch nicht getan haben, fügen Sie Firebase zu Ihrem Android-Projekt hinzu .

Schritt 1 : Fügen Sie Ihrer App das Performance Monitoring SDK hinzu

Nachdem Sie das Performance Monitoring SDK hinzugefügt haben, beginnt Firebase automatisch mit der Erfassung von Daten für das Bildschirm-Rendering Ihrer App und Daten zum Lebenszyklus Ihrer App (z. B. Startzeit der App ). Damit Firebase Netzwerkanforderungen überwachen kann, müssen Sie auch das Gradle-Plugin für die Leistungsüberwachung hinzufügen (nächster Schritt).

  1. Deklarieren Sie mithilfe der Firebase Android BoM die Abhängigkeit für die Android-Bibliothek zur Leistungsüberwachung in der Gradle-Datei Ihres Moduls (App-Ebene) (normalerweise app/build.gradle ).

    Java

    dependencies {
        // Import the BoM for the Firebase platform
        implementation platform('com.google.firebase:firebase-bom:27.1.0')
    
        // Declare 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'
    }
    

    Bei Verwendung der Firebase Android BoM verwendet Ihre App immer kompatible Versionen der Firebase Android-Bibliotheken.

    (Alternative) Deklarieren Sie Firebase-Bibliotheksabhängigkeiten, ohne die Stückliste zu verwenden

    Wenn Sie die Firebase-Stückliste nicht verwenden möchten, müssen Sie jede Firebase-Bibliotheksversion in ihrer Abhängigkeitszeile angeben.

    Wenn Sie mehrere Firebase-Bibliotheken in Ihrer App verwenden, empfehlen wir dringend, die Stückliste zum Verwalten von Bibliotheksversionen zu verwenden, um sicherzustellen, dass alle Versionen kompatibel sind.

    dependencies {
        // Declare 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:19.1.1'
    }
    

    Kotlin + KTX

    dependencies {
        // Import the BoM for the Firebase platform
        implementation platform('com.google.firebase:firebase-bom:27.1.0')
    
        // Declare 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-ktx'
    }
    

    Bei Verwendung der Firebase Android BoM verwendet Ihre App immer kompatible Versionen der Firebase Android-Bibliotheken.

    (Alternative) Deklarieren Sie Firebase-Bibliotheksabhängigkeiten, ohne die Stückliste zu verwenden

    Wenn Sie die Firebase-Stückliste nicht verwenden möchten, müssen Sie jede Firebase-Bibliotheksversion in ihrer Abhängigkeitszeile angeben.

    Wenn Sie mehrere Firebase-Bibliotheken in Ihrer App verwenden, empfehlen wir dringend, die BoM zum Verwalten von Bibliotheksversionen zu verwenden, um sicherzustellen, dass alle Versionen kompatibel sind.

    dependencies {
        // Declare 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-ktx:19.1.1'
    }
    

  2. Kompilieren Sie Ihre App neu.

Schritt 2 : Fügen Sie Ihrer App das Plugin zur Leistungsüberwachung hinzu

Nachdem Sie das Gradle-Plugin für die Leistungsüberwachung hinzugefügt haben, beginnt Firebase automatisch mit der Datenerfassung für HTTP / S-Netzwerkanforderungen . Mit dem Plugin können Sie auch benutzerdefinierte Code-Traces mithilfe der @ AddTrace-Annotation instrumentieren .

  1. app/build.gradle Gradle-Datei Ihres Moduls (App-Ebene) (normalerweise app/build.gradle ) das Plugin zur Leistungsüberwachung an:

    apply plugin: 'com.android.application'
    apply plugin: 'com.google.gms.google-services'
    // Apply the Performance Monitoring plugin
    apply plugin: 'com.google.firebase.firebase-perf'
    
    android {
      // ...
    }
    
  2. build.gradle in Ihrer Gradle-Datei auf build.gradle (Projektebene) ( build.gradle ) die Regeln hinzu, um das Plugin für die Leistungsüberwachung build.gradle .

    buildscript {
    
        repositories {
          // Check that you have the following line (if not, add it):
          google()  // Google's Maven repository
          // Add the Bintray repository
          jcenter()
        }
    
        dependencies {
          // ...
    
          // To benefit from the latest Performance Monitoring plugin features,
          // update your Android Gradle Plugin dependency to at least v3.4.0
          classpath 'com.android.tools.build:gradle:3.4.0'
    
          classpath 'com.google.gms:google-services:4.3.5'  // Google Services plugin
    
          // Add the dependency for the Performance Monitoring plugin
          classpath 'com.google.firebase:perf-plugin:1.3.5'  // Performance Monitoring plugin
        }
    }
    
  3. Kompilieren Sie Ihre App neu.

Schritt 3 : Generieren Sie Leistungsereignisse für die anfängliche Datenanzeige

Firebase beginnt mit der Verarbeitung der Ereignisse, wenn Sie das SDK erfolgreich zu Ihrer App hinzugefügt haben. Wenn Sie noch lokal entwickeln, interagieren Sie mit Ihrer App, um Ereignisse für die erste Datenerfassung und -verarbeitung zu generieren.

  1. Generieren Sie Ereignisse, indem Sie Ihre App mehrmals zwischen Hintergrund und Vordergrund wechseln, mit Ihrer App interagieren, indem Sie über Bildschirme navigieren und / oder Netzwerkanforderungen auslösen.

  2. Wechseln Sie zum Leistungs- Dashboard der Firebase-Konsole. Sie sollten Ihre anfängliche Datenanzeige innerhalb weniger Minuten sehen.

    Wenn Ihre ursprünglichen Daten nicht angezeigt werden, lesen Sie die Tipps zur Fehlerbehebung .

Schritt 4 : (Optional) Zeigen Sie Protokollnachrichten für Leistungsereignisse an

  1. Aktivieren Sie die Debug-Protokollierung für die Leistungsüberwachung zur Erstellungszeit, indem Sie der AndroidManifest.xml Datei Ihrer App ein <meta-data> -Element AndroidManifest.xml

    <application>
        <meta-data
          android:name="firebase_performance_logcat_enabled"
          android:value="true" />
    </application>
    
  2. Überprüfen Sie Ihre Protokollnachrichten auf Fehlermeldungen.

  3. Die Leistungsüberwachung markiert ihre Protokollnachrichten mit FirebasePerformance . Mithilfe der Logcat-Filterung können Sie die Dauer-Ablaufverfolgung und die HTTP / S-Netzwerkanforderungsprotokollierung speziell anzeigen, indem Sie den folgenden Befehl ausführen:

    adb logcat -s FirebasePerformance
  4. Suchen Sie nach den folgenden Protokolltypen, die darauf hinweisen, dass die Leistungsüberwachung Leistungsereignisse protokolliert:

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

Wenn Ihre App keine Leistungsereignisse protokolliert, lesen Sie die Tipps zur Fehlerbehebung .

Schritt 5 : (Optional) Fügen Sie eine benutzerdefinierte Überwachung für bestimmten Code hinzu

Um die mit bestimmten Codes in Ihrer App verknüpften Leistungsdaten zu überwachen, können Sie benutzerdefinierte Codespuren instrumentieren.

Mit einem benutzerdefinierten Code-Trace können Sie messen, wie lange Ihre App benötigt, um eine bestimmte Aufgabe oder eine Reihe von Aufgaben zu erledigen, z. B. das Laden einer Reihe von Bildern oder das Abfragen Ihrer Datenbank. Die Standardmetrik für eine benutzerdefinierte Code-Ablaufverfolgung ist ihre Dauer. Sie können jedoch auch benutzerdefinierte Metriken hinzufügen, z. B. Cache-Treffer und Speicherwarnungen.

In Ihrem Code definieren Sie den Anfang und das Ende einer benutzerdefinierten Code-Ablaufverfolgung (und fügen alle gewünschten benutzerdefinierten Metriken hinzu) mithilfe der vom Performance Monitoring SDK bereitgestellten API. Bei Android-Apps können Sie die Dauer bestimmter Methoden auch mithilfe der Annotation @AddTrace überwachen.

Besuchen Sie Überwachung für bestimmten Code hinzufügen, um mehr über diese Funktionen und das Hinzufügen zu Ihrer App zu erfahren.

Schritt 6 : Stellen Sie Ihre App bereit und überprüfen Sie die Ergebnisse

Nachdem Sie die Leistungsüberwachung mit einem oder mehreren Testgeräten überprüft haben, können Sie die aktualisierte Version Ihrer App für Ihre Benutzer bereitstellen.

Sie können Leistungsdaten im Leistungs- Dashboard der Firebase-Konsole überwachen.

Bekannte Probleme

  • Das Gradle-Plugin für die Leistungsüberwachung v1.1.0 kann zu einer Nichtübereinstimmung der Guava-Abhängigkeiten führen, was zu folgendem Fehler führt:

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

    Wenn Sie diesen Fehler sehen, können Sie entweder:

    • Aktualisieren Sie das Plugin für die Leistungsüberwachung auf Version 1.1.1 oder höher (die neueste Version ist Version 1.3.5).

    • Ersetzen Sie die Abhängigkeitslinie des Plugins für die Leistungsüberwachung in Ihrer Gradle-Datei auf build.gradle (Projektebene) ( build.gradle ) wie folgt:

      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'
          }
        }
      }
      
  • Die Leistungsüberwachung gibt die Gesamtnutzlastgröße für HTTP-Netzwerkanforderungen basierend auf dem im Header für die Länge des HTTP-Inhalts festgelegten Wert an. Dieser Wert ist möglicherweise nicht immer genau.

  • Die Leistungsüberwachung unterstützt nur den Hauptprozess in Android-Apps mit mehreren Prozessen.

Nächste Schritte