W 2026 r., aby dostosować się do naszego modelu stabilnego rozwoju trunk i zapewnić stabilność platformy w ekosystemie, będziemy publikować kod źródłowy w AOSP w drugim i czwartym kwartale. Do tworzenia i współtworzenia AOSP używaj gałęzi android-latest-release. Gałąź manifestu android-latest-release będzie zawsze odwoływać się do najnowszej wersji przesłanej do AOSP. Więcej informacji znajdziesz w artykule Zmiany w AOSP.

Google używa technologii AI do tłumaczenia treści na Twój preferowany język. Tłumaczenia wygenerowane przez AI mogą zawierać błędy.

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 16 innych.

AtraceCollector	`IMetricCollector`, który uruchamia atrace podczas testu, zbiera wynik i loguje go 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 platformach `onTestRunStart(DeviceMetricData)` i `onTestRunEnd(DeviceMetricData,Map)`.
BluetoothConnectionLatencyCollector	Kolektor przesyła na urządzenia wstępnie zdefiniowaną konfigurację wskaźnika czasu trwania statsd i zbiera czas trwania połączenia Bluetooth dla każdego profilu.
BluetoothConnectionStateCollector	Ten kolektor będzie zbierać dane o zmianach stanu połączenia Bluetooth 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 pobiera z urządzenia pomiary pokrycia Clang i zapisuje je jako artefakty testowe.
CodeCoverageCollector	`BaseDeviceMetricCollector`, który pobierze z urządzenia pomiary pokrycia kodu Java i kodu natywnego i zapisze je jako artefakty testowe.
CountTestCasesCollector	Zliczanie i zgłaszanie liczby elementów testowania 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łaszanego 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 lub przebieg testu zakończy się niepowodzeniem.
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.
ModulePerfettoCollector	Kolektor, który rozpoczyna śledzenie Perfetto, gdy moduł testowy się uruchamia i kończy działanie oraz gdy urządzenie jest ponownie uruchamiane.
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 zgłasza 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ą.
ScreenRecordOnFailureCollector	Kolektor, który rejestruje i zapisuje nagranie ekranu, gdy przypadek testowy się nie powiedzie.
ScreenshotOnFailureCollector	Kolektor, który będzie robić zrzut ekranu i zapisywać go w logu, gdy przypadek testowy 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(IInvocationContext,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ć.
`default boolean`	`doesModuleContainFailure()` Zwraca wartość „true”, jeśli w bieżącym module wystąpiły błędy w przypadkach testowych lub przebiegach testów.
`default void`	`enableDefaultMetricCollection()` Umożliwia kolektorom włączenie domyślnego zbierania danych.
`default IMetricCollector.MetricCollectionLevel`	`getAlwaysOnCollectionLevel()`
`abstract List<IBuildInfo>`	`getBuildInfos()` Zwraca listę informacji o kompilacji dostępnych w wywołaniu.
`abstract List<ITestDevice>`	`getDevices()` Zwraca listę urządzeń dostępnych w wywołaniu.
`abstract ITestInvocationListener`	`getInvocationListener()` Zwraca oryginalny adres `ITestInvocationListener`, na który przekazujemy wyniki.
`default IMetricCollector.MetricCollectionLevel`	`getOnFailureCollectionLevel()`
`abstract ITestInvocationListener`	`init(IInvocationContext context, ITestInvocationListener listener)` Inicjowanie sieci zbierającej z bieżącym kontekstem i miejscem przekazywania wyników.
`default boolean`	`isDefaultMetricCollectionEnabled()` Informacja o tym, czy kolektor zbiera wskaźniki w ramach domyślnego zbierania danych.
`abstract void`	`onTestAssumptionFailure(DeviceMetricData testData, TestDescription test)` Wywołanie zwrotne, gdy element testowania zakończy się niepowodzeniem z powodu nieprawidłowego założenia.
`abstract void`	`onTestEnd(DeviceMetricData testData, Map<String, MetricMeasurement.Metric> currentTestCaseMetrics, TestDescription test)` Wywołanie zwrotne po zakończeniu elementu testowania.
`abstract void`	`onTestEnd(DeviceMetricData testData, Map<String, MetricMeasurement.Metric> currentTestCaseMetrics)` Wywołanie zwrotne po zakończeniu elementu testowania.
`abstract void`	`onTestFail(DeviceMetricData testData, TestDescription test)` Wywołanie zwrotne, gdy test się nie powiedzie.
`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, Map<String, MetricMeasurement.Metric> currentRunMetrics)` Wywołanie zwrotne po zakończeniu sesji testowej.
`abstract void`	`onTestRunStart(DeviceMetricData runData)` Wywołanie zwrotne po rozpoczęciu sesji testowej.
`default void`	`onTestRunStart(DeviceMetricData runData, int testCount)` Wywołanie zwrotne po rozpoczęciu sesji testowej.
`default void`	`onTestRunStartBlocking()` Jawne wywołanie zwrotne, aby ręcznie uruchomić moduł zbierający, jeśli jest to obsługiwane.
`abstract void`	`onTestStart(DeviceMetricData testData)` Wywołanie zwrotne po rozpoczęciu elementu testowania.
`default void`	`setAlwaysOnCollectionLevel(IMetricCollector.MetricCollectionLevel level)` Ustawia poziom, na którym kolektor ma zbierać logi niezależnie od błędów.
`default void`	`setModuleContainsFailure()` Określa, czy w module wystąpiły jakieś błędy (przypadek testowy, test).
`default void`	`setOnFailureCollectionLevel(IMetricCollector.MetricCollectionLevel level)` Określa poziom, na którym kolektor ma zbierać logi w przypadku awarii.

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ć.

Zwraca
`boolean`

doesModuleContainFailure

public boolean doesModuleContainFailure ()

Zwraca wartość „true”, jeśli w bieżącym module wystąpiły błędy w przypadkach testowych lub przebiegach testów.

Zwraca
`boolean`

enableDefaultMetricCollection

public void enableDefaultMetricCollection ()

Umożliwia kolektorom włączenie domyślnego zbierania danych. Gdy domyślne zbieranie danych jest włączone, kolektor powinien zbierać dane tylko na określonym poziomie zbierania.

getAlwaysOnCollectionLevel

public IMetricCollector.MetricCollectionLevel getAlwaysOnCollectionLevel ()

Zwraca
`IMetricCollector.MetricCollectionLevel`

getBuildInfos

public abstract List<IBuildInfo> getBuildInfos ()

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

Zwraca
`List<IBuildInfo>`

getDevices

public abstract List<ITestDevice> getDevices ()

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

Zwraca
`List<ITestDevice>`

getInvocationListener

public abstract ITestInvocationListener getInvocationListener ()

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

Zwraca
`ITestInvocationListener`

getOnFailureCollectionLevel

public IMetricCollector.MetricCollectionLevel getOnFailureCollectionLevel ()

Zwraca
`IMetricCollector.MetricCollectionLevel`

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 wywołania w toku.
`listener`	`ITestInvocationListener`: `ITestInvocationListener`, w którym mają się pojawić wyniki.

Zwraca
`ITestInvocationListener`	nowy odbiorca otacza pierwotnego odbiorcę.

Zgłasza
`DeviceNotAvailableException`

isDefaultMetricCollectionEnabled

public boolean isDefaultMetricCollectionEnabled ()

Informacja o tym, czy kolektor zbiera wskaźniki w ramach domyślnego zbierania danych.

Zwraca
`boolean`

onTestAssumptionFailure

public abstract void onTestAssumptionFailure (DeviceMetricData testData, 
                TestDescription test)

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

Parametry
`testData`	`DeviceMetricData`: `DeviceMetricData` zawierający dane elementu testowania.
`test`	`TestDescription`: `TestDescription` elementu testowania w trakcie wykonywania.

Zgłasza
`DeviceNotAvailableException`

onTestEnd

public abstract void onTestEnd (DeviceMetricData testData, 
                Map<String, MetricMeasurement.Metric> currentTestCaseMetrics, 
                TestDescription test)

Wywołanie zwrotne po zakończeniu elementu testowania. To powinien być czas na zwalnianie miejsca.

Parametry
`testData`	`DeviceMetricData`: `DeviceMetricData` zawierający dane elementu testowania. Będzie to ten sam obiekt co podczas `onTestStart(DeviceMetricData)`.
`currentTestCaseMetrics`	`Map`: bieżąca mapa danych przekazywanych do `testEnded(TestDescription,Map)`.
`test`	`TestDescription`: `TestDescription` elementu testowania w trakcie wykonywania.

Zgłasza
`DeviceNotAvailableException`

onTestEnd

public abstract void onTestEnd (DeviceMetricData testData, 
                Map<String, MetricMeasurement.Metric> currentTestCaseMetrics)

Wywołanie zwrotne po zakończeniu elementu testowania. To powinien być czas na zwalnianie miejsca.

Parametry
`testData`	`DeviceMetricData`: `DeviceMetricData` zawierający dane elementu testowania. Będzie to ten sam obiekt co podczas `onTestStart(DeviceMetricData)`.
`currentTestCaseMetrics`	`Map`: bieżąca mapa danych przekazywanych do `testEnded(TestDescription,Map)`.

Zgłasza
`DeviceNotAvailableException`

onTestFail

public abstract void onTestFail (DeviceMetricData testData, 
                TestDescription test)

Wywołanie zwrotne, gdy test się nie powiedzie.

Parametry
`testData`	`DeviceMetricData`: `DeviceMetricData` zawierający dane elementu testowania.
`test`	`TestDescription`: `TestDescription` elementu testowania w trakcie wykonywania.

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, 
                Map<String, MetricMeasurement.Metric> currentRunMetrics)

Wywołanie zwrotne po zakończeniu sesji testowej. To powinien być czas na zwalnianie miejsca.

Parametry
`runData`	`DeviceMetricData`: `DeviceMetricData` zawierający dane dotyczące uruchomienia. Będzie to ten sam obiekt co podczas `onTestRunStart(DeviceMetricData)`.
`currentRunMetrics`	`Map`: bieżąca mapa danych przekazywanych do `testRunEnded(long,Map)`.

Zgłasza
`DeviceNotAvailableException`

onTestRunStart

public abstract void onTestRunStart (DeviceMetricData runData)

Wywołanie zwrotne po rozpoczęciu sesji testowej.

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 sesji testowej.

Parametry
`runData`	`DeviceMetricData`: `DeviceMetricData` zawierający dane dotyczące uruchomienia.
`testCount`	`int`: liczba elementów testowania w tej sesji testowej.

Zgłasza
`DeviceNotAvailableException`

onTestRunStartBlocking

public void onTestRunStartBlocking ()

Jawne wywołanie zwrotne, aby ręcznie uruchomić moduł zbierający, jeśli jest to obsługiwane. Dzięki temu mamy pewność, że nie jesteśmy w trakcie asynchronicznego cyklu życia testu.

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

onTestStart

public abstract void onTestStart (DeviceMetricData testData)

Wywołanie zwrotne po rozpoczęciu elementu testowania.

Parametry
`testData`	`DeviceMetricData`: `DeviceMetricData` zawierający dane elementu testowania.

Zgłasza
`DeviceNotAvailableException`

setAlwaysOnCollectionLevel

public void setAlwaysOnCollectionLevel (IMetricCollector.MetricCollectionLevel level)

Ustawia poziom, na którym kolektor ma zbierać logi niezależnie od błędów.

Poziom NULL spowoduje brak zbierania danych.

Parametry
`level`	`IMetricCollector.MetricCollectionLevel`: `MetricCollectionLevel`, w którym będą zbierane logi.

setModuleContainsFailure

public void setModuleContainsFailure ()

Określa, czy w module wystąpiły jakieś błędy (przypadek testowy, test).

setOnFailureCollectionLevel

public void setOnFailureCollectionLevel (IMetricCollector.MetricCollectionLevel level)

Określa poziom, na którym kolektor ma zbierać logi w przypadku awarii.

Poziom NULL spowoduje brak zbierania danych.

Parametry
`level`	`IMetricCollector.MetricCollectionLevel`: `MetricCollectionLevel`, w którym będą zbierane logi.