Messwerte sind die wichtigsten Informationen, die aus Ihren Benchmarks extrahiert werden. Sie werden als List
an die Funktion measureRepeated
übergeben, sodass Sie mehrere Messwerte gleichzeitig angeben können. Zum Ausführen der Benchmark ist mindestens ein Messwerttyp erforderlich.
Das folgende Code-Snippet erfasst Frame-Timings und benutzerdefinierte Messwerte für Trace-Abschnitte:
Kotlin
benchmarkRule.measureRepeated( packageName = TARGET_PACKAGE, metrics = listOf( FrameTimingMetric(), TraceSectionMetric("RV CreateView"), TraceSectionMetric("RV OnBindView"), ), iterations = 5, // ... )
Java
benchmarkRule.measureRepeated( TARGET_PACKAGE, // packageName Arrays.asList( // metrics new StartupTimingMetric(), new TraceSectionMetric("RV CreateView"), new TraceSectionMetric("RV OnBindView"), ), 5, // Iterations // ... );
In diesem Beispiel sind RV CreateView
und RV OnBindView
die IDs von nachverfolgbaren Blöcken, die in RecyclerView
definiert sind. Der Quellcode für die Methode createViewHolder()
ist ein Beispiel dafür, wie Sie nachverfolgbare Blöcke in Ihrem eigenen Code definieren können.
StartupTimingMetric
, TraceSectionMetric
, FrameTimingMetric
und PowerMetric
werden weiter unten in diesem Dokument ausführlich behandelt.
Benchmarkergebnisse werden an Android Studio ausgegeben, wie in Abbildung 1 dargestellt. Wenn mehrere Messwerte definiert sind, werden alle in der Ausgabe kombiniert.
StartupTimingMetric
StartupTimingMetric
erfasst Messwerte zum Zeitpunkt des App-Starts mit den folgenden Werten:
timeToInitialDisplayMs
: Die Zeitspanne zwischen dem Empfang eines Start-Intents im System und dem Rendern des ersten Frames des ZielsActivity
.timeToFullDisplayMs
: Die Zeitspanne zwischen dem Empfang eines Start-Intents im System und der vollständigen Erstellung der App mit der MethodereportFullyDrawn()
. Die Messung endet, wenn das Rendern des ersten Frames nach demreportFullyDrawn()
-Aufruf abgeschlossen ist oder diesen enthält. Diese Messung ist unter Android 10 (API-Level 29) und niedriger möglicherweise nicht verfügbar.
StartupTimingMetric
gibt die Minimal-, Median- und Maximalwerte aus den Startiterationen aus. Um die Startup-Verbesserung zu beurteilen, sollten Sie sich auf Medianwerte konzentrieren, da diese die beste Schätzung der typischen Startzeit liefern. Weitere Informationen dazu, was sich auf die Startzeit der Anwendung auswirkt, finden Sie unter App-Startzeit.
FrameTiming-Messwert
FrameTimingMetric
erfasst Zeitinformationen aus Frames, die von einer Benchmark erzeugt wurden, z. B. Scrollen oder Animationen, und gibt die folgenden Werte aus:
frameOverrunMs
: die Zeitspanne, um die ein bestimmter Frame seine Frist verpasst. Positive Zahlen kennzeichnen ein abgebrochenes Frame und eine sichtbare Verzögerung oder Ruckeln. Negative Zahlen geben an, wie viel schneller ein Frame das Zeitlimit überschreitet. Hinweis: Diese Funktion ist nur unter Android 12 (API-Level 31) und höher verfügbar.frameDurationCpuMs
: Die Zeit, die der Frame benötigt, um auf der CPU sowohl im UI-Thread als auch imRenderThread
zu erzeugen.
Diese Messungen werden in einer Verteilung des 50., 90., 95. und 99. Perzentils erfasst.
Weitere Informationen zum Erkennen und Verbessern langsamer Frames findest du unter Langsames Rendering.
TracesectionMesswert
TraceSectionMetric
erfasst, wie oft ein Trace-Abschnitt, der mit dem bereitgestellten sectionName
übereinstimmt, und die erforderliche Zeit auftreten. Für die Zeit werden die Mindest-, Median- und Höchstzeiten in Millisekunden ausgegeben. Der Trace-Abschnitt wird entweder durch den Funktionsaufruf trace(sectionName)
, den Code zwischen Trace.beginSection(sectionName)
und Trace.endSection()
oder deren asynchrone Varianten definiert. Es wird immer die erste Instanz eines Trace-Abschnitts ausgewählt, der während einer Messung erfasst wurde. Standardmäßig werden nur Trace-Abschnitte aus Ihrem Paket ausgegeben. Wenn Sie Prozesse außerhalb des Pakets einschließen möchten, legen Sie targetPackageOnly = false
fest.
Weitere Informationen zum Tracing finden Sie unter Übersicht über System-Tracing und Benutzerdefinierte Ereignisse definieren.
PowerMetric
PowerMetric
erfasst die Änderung der Energie oder Energie während des Tests für die angegebenen Leistungskategorien.
Jede ausgewählte Kategorie wird in ihre messbaren Unterkomponenten unterteilt und nicht ausgewählte Kategorien werden dem nicht ausgewählten Messwert hinzugefügt.
Mit diesen Messwerten wird der systemweite Verbrauch gemessen, nicht der pro App. Sie sind auf Pixel 6, Pixel 6 Pro und neuere Geräte beschränkt:
power<category>Uw
: die verbrauchte Energie während der Dauer des Tests in dieser Kategorie.energy<category>Uws
: die pro Zeiteinheit übertragene Energie für die Dauer Ihres Tests in dieser Kategorie.
Zu den Kategorien gehören:
CPU
DISPLAY
GPU
GPS
MEMORY
MACHINE_LEARNING
NETWORK
UNCATEGORIZED
Bei einigen Kategorien, z. B. CPU
, kann es schwierig sein, die Arbeit anderer Prozesse von der Arbeit Ihrer eigenen Anwendung zu trennen. Entfernen oder beschränken Sie unnötige Anwendungen und Konten, um die Störungen zu minimieren.
Empfehlungen für dich
- Hinweis: Der Linktext wird angezeigt, wenn JavaScript deaktiviert ist.
- Baseline-Profile erstellen {:#create-profile-rules}
- Makro-Benchmark schreiben
- Analyse und Optimierung des App-Starts {:#app-startup-analysis-Optimization}