Aby zachować zgodność z naszym modelem rozwoju gałęzi głównej i zapewnić stabilność platformy w ekosystemie, w II i IV kwartale 2026 r. opublikujemy kod źródłowy w AOSP. Do tworzenia i współtworzenia AOSP zalecamy używanie android-latest-release zamiast aosp-main. Gałąź android-latest-release manifestu zawsze będzie odnosić się do najnowszej wersji przesłanej do AOSP. Więcej informacji znajdziesz w sekcji Zmiany w AOSP.

IMetricCollector

public interface IMetricCollector
implements IDisableable, ILogSaverListener

com.android.tradefed.device.metric.IMetricCollector

Znane podklasy pośrednie

AtraceCollector, AtraceRunMetricCollector, BaseDeviceMetricCollector, BluetoothConnectionLatencyCollector, BluetoothConnectionStateCollector, BluetoothHciSnoopLogCollector, BugreportzOnFailureCollector, BugreportzOnTestCaseFailureCollector, ClangCodeCoverageCollector, CodeCoverageCollector, CountTestCasesCollector, DebugHostLogOnFailureCollector, DeviceTraceCollector, FilePullerDeviceMetricCollector, FilePullerLogCollector i 14 innych.

AtraceCollector	`IMetricCollector`, który uruchamia atrace podczas testu, zbiera wyniki i rejestruje je w wywołaniu.
AtraceRunMetricCollector	Zbiera ślady ze wszystkich katalogów testowych w danym katalogu na urządzeniu testowym, rejestruje katalog testowy i przetwarza pliki śledzenia w katalogu testowym oraz agreguje dane.
BaseDeviceMetricCollector	Podstawowa implementacja `IMetricCollector`, która umożliwia rozpoczęcie i zatrzymanie zbierania danych na stronach `onTestRunStart(com.android.tradefed.device.metric.DeviceMetricData)` i `ERROR(/#onTestRunEnd(com.android.tradefed.device.metric.DeviceMetricData,Map))`.
BluetoothConnectionLatencyCollector	Kolektor wyśle na urządzenia wstępnie zdefiniowaną konfigurację danych o czasie trwania w formacie statsd i będzie zbierać dane o czasie trwania połączenia Bluetooth dla każdego profilu.
BluetoothConnectionStateCollector	Ten moduł zbierający będzie zbierać dane BluetoothConnectionStateChanged i rejestrować stan połączenia dla każdego profilu.
BluetoothHciSnoopLogCollector	Kolektor, który włącza zapisywanie w dzienniku snoopingu interfejsu HCI Bluetooth na testowanym urządzeniu i zbiera dziennik dla każdego testu.
BugreportzOnFailureCollector	Gdy przypadek testowy się nie powiedzie, zbierz raport o błędach.
BugreportzOnTestCaseFailureCollector	Zbieranie raportu o błędach, gdy test w ramach uruchomienia zakończy się niepowodzeniem.
ClangCodeCoverageCollector	`BaseDeviceMetricCollector`, który pobierze z urządzenia pomiary pokrycia Clang i zapisze je jako artefakty testowe.
CodeCoverageCollector	`BaseDeviceMetricCollector`, który pobierze z urządzenia pomiary pokrycia kodu Java i kodu natywnego i zarejestruje je jako artefakty testowe.
CountTestCasesCollector	Zliczanie i raportowanie liczby przypadków testowych dla danego `IRemoteTest`.
DebugHostLogOnFailureCollector	Kolektor, który będzie zbierać i rejestrować logi po stronie hosta w przypadku niepowodzenia elementu testowania.
DeviceTraceCollector	Kolektor, który rozpoczyna śledzenie Perfetto po rozpoczęciu testu i rejestruje plik śladu na końcu.
FilePullerDeviceMetricCollector	`BaseDeviceMetricCollector`, które nasłuchują klucza danych o wartościach pochodzącego z urządzenia i pobierają je z urządzenia jako plik.
FilePullerLogCollector	Rejestrator pliku zgłoszonego przez urządzenie.
GcovCodeCoverageCollector	`BaseDeviceMetricCollector`, który pobiera pomiary pokrycia gcov z urządzenia i zapisuje je jako artefakty testowe.
GcovKernelCodeCoverageCollector	`BaseDeviceMetricCollector`, który pobiera pomiary pokrycia jądra gcov z debugfs i urządzenia, a następnie rejestruje je jako artefakty testowe.
HostStatsdMetricCollector	`IMetricCollector`, który zbiera dane statsd po stronie hosta za pomocą poleceń narzędzia statsd.
JavaCodeCoverageCollector	`BaseDeviceMetricCollector`, który pobiera pomiary pokrycia kodu Java z urządzenia i zapisuje je jako artefakty testowe.
LogcatOnFailureCollector	Kolektor, który rejestruje i zapisuje dziennik logcat, gdy przypadek testowy się nie powiedzie.
LogcatTimingMetricCollector	Moduł zbierający dane, który zbiera informacje o czasie (np. czas przełączania użytkownika) z logcat podczas jednego lub kilku powtarzanych testów, używając podanych wzorców wyrażeń regularnych do analizowania sygnałów rozpoczęcia i zakończenia zdarzenia z wierszy logcat.
ModuleLogcatCollector	Wersja narzędzia do zbierania logcat, ale dla modułu.
PerfettoFilePullerCollector	Kolektor, który pobiera pliki śledzenia Perfetto z urządzenia, opcjonalnie je kompresuje i dodaje do logów testowych.
PerfettoPullerMetricCollector	Ta klasa została wycofana. Zamiast niej używaj zasad `PerfettoFilePullerCollector` i `ERROR(/PerfettoTracePostProcessor)`.
RebootReasonCollector	Kolektor, który zbiera informacje o ponownym uruchomieniu urządzenia podczas testu i raportuje je według przyczyny i liczby.
RuntimeRestartCollector	Kolektor, który zbiera sygnatury czasowe ponownych uruchomień środowiska wykonawczego (awarii serwera systemowego) podczas testu, jeśli takie wystąpią.
ScreenshotOnFailureCollector	Kolektor, który będzie robić zrzut ekranu i rejestrować go w logu, gdy test zakończy się niepowodzeniem.
ShowmapPullerMetricCollector	Podstawowa implementacja `FilePullerDeviceMetricCollector`, która umożliwia pobieranie plików showmap z urządzenia i zbieranie z nich danych.
TraceCmdCollector	`IMetricCollector`, który zbiera ślady podczas testu za pomocą polecenia trace-cmd i zapisuje je w wywołaniu.

Ten interfejs zostanie dodany jako dekorator podczas raportowania wyników testów w celu zbierania pasujących danych.

Tego interfejsu nie można używać jako , nawet jeśli rozszerza ITestInvocationListener. Sprawdzanie konfiguracji odrzuci tę zmianę. Musi być używany jako „metrics_collector”.

Kolektory nie powinny przechowywać stanu wewnętrznego, ponieważ mogą być używane w kilku miejscach. Jeśli stan wewnętrzny musi być używany, należy go wyczyścić w funkcji init(com.android.tradefed.invoker.IInvocationContext, com.android.tradefed.result.ITestInvocationListener).

Podsumowanie

Metody publiczne
`default boolean`	`captureModuleLevel()` Określa, czy moduł zbierający ma zastosowanie do przechwytywania na poziomie modułu i czy należy go zainicjować.
`abstract`	`getBuildInfos()` Zwraca listę informacji o kompilacji dostępnych w wywołaniu.
`abstract`	`getDevices()` Zwraca listę urządzeń dostępnych w wywołaniu.
`abstract ITestInvocationListener`	`getInvocationListener()` Zwraca oryginalny adres `ITestInvocationListener`, na który przekazujemy wyniki.
`abstract ITestInvocationListener`	`init(IInvocationContext context, ITestInvocationListener listener)` Inicjowanie sieci zbierającej z bieżącym kontekstem i miejscem przekazywania wyników.
`abstract void`	`onTestAssumptionFailure(DeviceMetricData testData, TestDescription test)` Wywołanie zwrotne, gdy przypadek testowy zakończy się niepowodzeniem z powodu nieprawidłowego założenia.
`abstract void`	`onTestEnd(DeviceMetricData testData, currentTestCaseMetrics, TestDescription test)` Wywołanie zwrotne po zakończeniu testu.
`abstract void`	`onTestEnd(DeviceMetricData testData, currentTestCaseMetrics)` Wywołanie zwrotne po zakończeniu testu.
`abstract void`	`onTestFail(DeviceMetricData testData, TestDescription test)` Wywołanie zwrotne, gdy przypadek testowy zakończy się niepowodzeniem.
`default void`	`onTestModuleEnded()` Umożliwia rejestrowanie zdarzenia zakończenia modułu.
`default void`	`onTestModuleStarted()` Umożliwia rejestrowanie zdarzenia rozpoczęcia modułu.
`abstract void`	`onTestRunEnd(DeviceMetricData runData, currentRunMetrics)` Wywołanie zwrotne po zakończeniu testu.
`abstract void`	`onTestRunStart(DeviceMetricData runData)` Wywołanie zwrotne po rozpoczęciu testu.
`default void`	`onTestRunStart(DeviceMetricData runData, int testCount)` Wywołanie zwrotne po rozpoczęciu testu.
`abstract void`	`onTestStart(DeviceMetricData testData)` Wywołanie zwrotne po rozpoczęciu przypadku testowego.

Metody publiczne

captureModuleLevel

public boolean captureModuleLevel ()

Określa, czy moduł zbierający ma zastosowanie do przechwytywania na poziomie modułu i czy należy go zainicjować.

Zwroty
`boolean`

getBuildInfos

public abstract  getBuildInfos ()

Zwraca listę informacji o kompilacji dostępnych w wywołaniu.

Zwroty

getDevices

public abstract  getDevices ()

Zwraca listę urządzeń dostępnych w wywołaniu.

Zwroty

getInvocationListener

public abstract ITestInvocationListener getInvocationListener ()

Zwraca oryginalny adres ITestInvocationListener, na który przekazujemy wyniki.

Zwroty
`ITestInvocationListener`

init

public abstract ITestInvocationListener init (IInvocationContext context, 
                ITestInvocationListener listener)

Inicjowanie sieci zbierającej z bieżącym kontekstem i miejscem przekazywania wyników. Będzie wywoływana tylko raz na instancję, a kolektor ma zaktualizować swój wewnętrzny kontekst i odbiornik. Funkcja Init nigdy nie jest wywoływana podczas testu, zawsze przed nim.

Nie zastępuj, jeśli nie wiesz, co robisz.

Parametry
`context`	`IInvocationContext`: `IInvocationContext` dla trwającego wywołania.
`listener`	`ITestInvocationListener`: `ITestInvocationListener`, w którym mają się pojawić wyniki.

Zwroty
`ITestInvocationListener`	nowy odbiorca otaczający pierwotnego odbiorcę.

Zgłasza
`DeviceNotAvailableException`

onTestAssumptionFailure

public abstract void onTestAssumptionFailure (DeviceMetricData testData, 
                TestDescription test)

Wywołanie zwrotne, gdy przypadek testowy zakończy się niepowodzeniem z powodu nieprawidłowego założenia.

Parametry
`testData`	`DeviceMetricData`: `DeviceMetricData` zawierający dane dla przypadku testowego.
`test`	`TestDescription`: `TestDescription` elementu testowania w trakcie realizacji.

Zgłasza
`DeviceNotAvailableException`

onTestEnd

public abstract void onTestEnd (DeviceMetricData testData, 
                 currentTestCaseMetrics, 
                TestDescription test)

Wywołanie zwrotne po zakończeniu testu. To powinien być czas na posprzątanie.

Parametry
`testData`	`DeviceMetricData`: `DeviceMetricData` zawierający dane dla przypadku testowego. Będzie to ten sam obiekt co podczas `onTestStart(com.android.tradefed.device.metric.DeviceMetricData)`.
`currentTestCaseMetrics`	: aktualna mapa danych przekazywanych do `ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map))`.
`test`	`TestDescription`: `TestDescription` elementu testowania w trakcie realizacji.

Zgłasza
`DeviceNotAvailableException`

onTestEnd

public abstract void onTestEnd (DeviceMetricData testData, 
                 currentTestCaseMetrics)

Wywołanie zwrotne po zakończeniu testu. To powinien być czas na posprzątanie.

Parametry
`testData`	`DeviceMetricData`: `DeviceMetricData` zawierający dane dla przypadku testowego. Będzie to ten sam obiekt co podczas `onTestStart(com.android.tradefed.device.metric.DeviceMetricData)`.
`currentTestCaseMetrics`	: aktualna mapa danych przekazywanych do `ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map))`.

Zgłasza
`DeviceNotAvailableException`

onTestFail

public abstract void onTestFail (DeviceMetricData testData, 
                TestDescription test)

Wywołanie zwrotne, gdy przypadek testowy zakończy się niepowodzeniem.

Parametry
`testData`	`DeviceMetricData`: `DeviceMetricData` zawierający dane dla przypadku testowego.
`test`	`TestDescription`: `TestDescription` elementu testowania w trakcie realizacji.

Zgłasza
`DeviceNotAvailableException`

onTestModuleEnded

public void onTestModuleEnded ()

Umożliwia rejestrowanie zdarzenia zakończenia modułu.

Zgłasza
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

onTestModuleStarted

public void onTestModuleStarted ()

Umożliwia rejestrowanie zdarzenia rozpoczęcia modułu.

Zgłasza
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

onTestRunEnd

public abstract void onTestRunEnd (DeviceMetricData runData, 
                 currentRunMetrics)

Wywołanie zwrotne po zakończeniu testu. To powinien być czas na posprzątanie.

Parametry
`runData`	`DeviceMetricData`: `DeviceMetricData` zawierający dane dotyczące uruchomienia. Będzie to ten sam obiekt co podczas `onTestRunStart(com.android.tradefed.device.metric.DeviceMetricData)`.
`currentRunMetrics`	: aktualna mapa danych przekazywanych do `ERROR(/#testRunEnded(long,Map))`.

Zgłasza
`DeviceNotAvailableException`

onTestRunStart

public abstract void onTestRunStart (DeviceMetricData runData)

Wywołanie zwrotne po rozpoczęciu testu.

Parametry
`runData`	`DeviceMetricData`: `DeviceMetricData` zawierający dane dotyczące uruchomienia.

Zgłasza
`DeviceNotAvailableException`

onTestRunStart

public void onTestRunStart (DeviceMetricData runData, 
                int testCount)

Wywołanie zwrotne po rozpoczęciu testu.

Parametry
`runData`	`DeviceMetricData`: `DeviceMetricData` zawierający dane dotyczące uruchomienia.
`testCount`	`int`: liczba przypadków testowych w tym przebiegu testu.

Zgłasza
`DeviceNotAvailableException`

onTestStart

public abstract void onTestStart (DeviceMetricData testData)

Wywołanie zwrotne po rozpoczęciu przypadku testowego.

Parametry
`testData`	`DeviceMetricData`: `DeviceMetricData` zawierający dane dla przypadku testowego.

Zgłasza
`DeviceNotAvailableException`