Dane to główny typ informacji wyodrębnianych z testów porównawczych. Są one przekazywane do funkcji measureRepeated
jako List
, co umożliwia określenie wielu mierzonych danych jednocześnie. Do uruchomienia testu porównawczego wymagany jest co najmniej 1 rodzaj danych.
Ten fragment kodu rejestruje pomiary sekcji śledzenia niestandardowego dotyczącej czasu trwania ramki i metryk:
benchmarkRule.measureRepeated( packageName = TARGET_PACKAGE, metrics = listOf( FrameTimingMetric(), TraceSectionMetric("RV CreateView"), TraceSectionMetric("RV OnBindView"), ), iterations = 5, // ... )
benchmarkRule.measureRepeated( TARGET_PACKAGE, // packageName Arrays.asList( // metrics new StartupTimingMetric(), new TraceSectionMetric("RV CreateView"), new TraceSectionMetric("RV OnBindView"), ), 5, // Iterations // ... );
W tym przykładzie RV CreateView
i RV OnBindView
to identyfikatory bloków z możliwością śledzenia zdefiniowanych w RecyclerView
. Kod źródłowy metody createViewHolder()
jest przykładem definiowania bloków umożliwiających śledzenie w Twoim kodzie.
StartupTimingMetric
,
TraceSectionMetric
,
FrameTimingMetric
i
PowerMetric
są omawiane szczegółowo w dalszej części tego dokumentu.
Wyniki testów porównawczych są wyświetlane w Android Studio, jak pokazano na rysunku 1. Jeśli zdefiniujesz kilka rodzajów danych, wszystkie zostaną połączone w wyniku.

TraceSectionMetric
i FrameTimingMetric
.StartupTimingMetric
StartupTimingMetric
przechwytuje dane o czasie uruchamiania aplikacji z tymi wartościami:
timeToInitialDisplayMs
: czas od momentu, gdy system otrzyma zamiar uruchomienia, do momentu renderowania pierwszego obrazu docelowegoActivity
.timeToFullDisplayMs
: Czas od momentu, gdy system otrzyma intencję uruchomienia, do momentu, gdy aplikacja zgłosi, że jest w pełni narysowana, za pomocą metodyreportFullyDrawn()
. Pomiar kończy się po zakończeniu renderowania pierwszej klatki po wywołaniu funkcjireportFullyDrawn()
lub zawierającym to wywołanie. Ta funkcja może nie być dostępna w Androidzie 10 (poziom API 29) i starszych.
StartupTimingMetric
zwraca wartości minimalną, medianę i maksymalną z iteracji uruchamiania. Aby ocenić poprawę czasu uruchamiania, skup się na wartościach mediany, ponieważ zapewniają one najlepsze oszacowanie typowego czasu uruchamiania. Więcej informacji o tym, co wpływa na czas uruchamiania aplikacji, znajdziesz w artykule Czas uruchamiania aplikacji.

StartupTimingMetric
wyniku z grupy.FrameTimingMetric
FrameTimingMetric
przechwytuje informacje o czasie z ramek wygenerowanych przez benchmark, np. przewijania lub animacji, i wyprowadza te wartości:
frameOverrunMs
: czas, o który dana klatka przekroczyła swój termin. Wartości dodatnie wskazują utratę klatki i widoczne zakłócenia lub zacinanie. Wartości ujemne wskazują, o ile szybciej klatka została wyrenderowana niż termin. Uwaga: ta funkcja jest dostępna tylko w Androidzie 12 (poziom API 31) i nowszych.frameDurationCpuMs
: czas potrzebny procesorowi na wygenerowanie ramki zarówno w wątku interfejsu użytkownika, jak i w wątkuRenderThread
.
Te pomiary są zbierane w rozkładzie 50, 90, 95 i 99 centyla.
Więcej informacji o identyfikowaniu i poprawianiu spowolnionych klatek znajdziesz w artykule Wydajne renderowanie.

FrameTimingMetric
wyniku z grupy.TraceSectionMetric
TraceSectionMetric
zapisywanie liczby wystąpień sekcji śladu pasującej do podanego ciągu znaków sectionName
oraz czasu trwania tego wystąpienia. W przypadku czasu zwraca minimalny, średni i maksymalny czas w milisekundach. Sekcja śledzenia jest definiowana przez wywołanie funkcji trace(sectionName)
lub kod między Trace.beginSection(sectionName)
a Trace.endSection()
lub ich wersjami asynchronicznymi. Zawsze wybiera pierwszą instancję sekcji przechwycenia zarejestrowanej podczas pomiaru. Domyślnie generuje tylko sekcje śledzenia z Twojego pakietu. Aby uwzględnić procesy spoza pakietu, ustaw opcję targetPackageOnly = false
.
Więcej informacji o śledzeniu znajdziesz w artykułach Omówienie śledzenia systemu i Definiowanie zdarzeń niestandardowych.

TraceSectionMetric
wyniku z grupy.PowerMetric
PowerMetric
rejestruje zmianę mocy lub energii w trakcie testu w przypadku podanych kategorii mocy.
Każda wybrana kategoria jest dzielona na mierzalne podelementy, a niewybrane kategorie są dodawane do danych „Niewybrane”.
Te dane dotyczą zużycia w całym systemie, a nie zużycia w poszczególnych aplikacjach. Są one dostępne tylko na urządzeniach Pixel 6, Pixel 6 Pro i nowszych:
power<category>Uw
: ilość energii zużytej w czasie testu w danej kategorii.energy<category>Uws
: ilość energii przekształconej w jednostce czasu podczas trwania testu w danej kategorii.
Kategorie te to:
CPU
DISPLAY
GPU
GPS
MEMORY
MACHINE_LEARNING
NETWORK
UNCATEGORIZED
W przypadku niektórych kategorii, np. CPU
, trudno jest oddzielić działanie innych procesów od działania Twojej aplikacji. Aby zminimalizować zakłócenia, usuń niepotrzebne aplikacje i konta lub ogranicz im dostęp.

PowerMetric
wyniku z grupy.Obecnie nie ma rekomendacji.
Zaloguj się na swoje konto Google.