Od 27 marca 2025 r. zalecamy używanie android-latest-release zamiast aosp-main do kompilowania i wspołtworzenia AOSP. Więcej informacji znajdziesz w artykule o zmianach w AOSP.

Ta strona została przetłumaczona przez Cloud Translation API.

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 oraz 13 innych.

AtraceCollector	`IMetricCollector`, który podczas testu uruchamia atrace, zbiera wyniki i zapisują je w wywołaniu.
AtraceRunMetricCollector	Zbiera ścieżki ze wszystkich katalogów testów w danym katalogu na urządzeniu testowym, rejestruje katalog testów i przetwarza pliki ścieżek w katalogu testów, a następnie agreguje dane.
BaseDeviceMetricCollector	Podstawowa implementacja `IMetricCollector`, która umożliwia uruchamianie i zatrzymywanie zbierania danych w przypadku `onTestRunStart(com.android.tradefed.device.metric.DeviceMetricData)` i `ERROR(/#onTestRunEnd(com.android.tradefed.device.metric.DeviceMetricData,Map))`.
BluetoothConnectionLatencyCollector	Zbieracz prześle zdefiniowaną wstępnie konfigurację danych o czasie trwania statystyk statsd na urządzenia i zbierać dane o czasie trwania połączenia Bluetooth dla każdego profilu.
BluetoothConnectionStateCollector	Ten kolektor będzie zbierać dane BluetoothConnectionStateChanged i rejestrować stan połączenia oraz numer profilu.
BluetoothHciSnoopLogCollector	Collector do włączania zapisywania w dzienniku snoopingu interfejsu HCI Bluetooth na urządzeniu testowym i zbierania dziennika dla każdego testu.
BugreportzOnFailureCollector	Tworzenie raportu o błędach po niepowodzeniu przypadku testowego.
BugreportzOnTestCaseFailureCollector	Tworzenie raportu o błędzie, gdy test się nie powiedzie.
ClangCodeCoverageCollector	`BaseDeviceMetricCollector`, który pobiera z urządzenia pomiary pokrycia Clang i rejestruje je jako artefakty testowe.
CodeCoverageCollector	`BaseDeviceMetricCollector`, który pobiera z urządzenia pomiary zasięgu natywnych i Java i rejestruje je jako artefakty testowe.
CountTestCasesCollector	Zliczanie i zgłaszanie liczby przypadków testowych dla danego `IRemoteTest`.
DebugHostLogOnFailureCollector	Kolekcjoner, który gromadzi i rejestruje logi po stronie hosta, gdy wystąpi błąd testu.
DeviceTraceCollector	Kolekcjoner, który rozpocznie śledzenie perfetto po rozpoczęciu testu i na końcu wygeneruje plik z śladem.
FilePullerDeviceMetricCollector	`BaseDeviceMetricCollector`, który nasłuchuje klucza danych pochodzącego z urządzenia i pobiera te dane jako plik z urządzenia.
FilePullerLogCollector	Rejestrator pliku zgłaszanego przez urządzenie.
GcovCodeCoverageCollector	`BaseDeviceMetricCollector`, który pobiera z urządzenia pomiary zasięgu z gcov i rejestruje je jako artefakty testowe.
GcovKernelCodeCoverageCollector	`BaseDeviceMetricCollector`, który pobiera z debugfs i z urządzenia pomiary pokrycia jądra gcov, a potem rejestruje je jako artefakty testu.
HostStatsdMetricCollector	`IMetricCollector`, który zbiera dane statsd po stronie hosta za pomocą poleceń narzędzia statsd.
JavaCodeCoverageCollector	`BaseDeviceMetricCollector`, który pobiera z urządzenia pomiary pokrycia w języku Java i rejestruje je jako artefakty testowe.
LogcatOnFailureCollector	Kolektor, który rejestruje logcat, gdy test się nie powiedzie.
LogcatTimingMetricCollector	Zbieracz danych, który zbiera informacje o czasie (np. czas przełączania użytkownika) z logcat podczas jednego lub wielu powtarzających się testów, używając określonych wzorów wyrażeń regularnych do analizowania sygnałów rozpoczęcia i zakończenia zdarzenia z linii logcat.
ModuleLogcatCollector	Wersja logcat collector, ale dla modułu.
PerfettoPullerMetricCollector	Podstawowa implementacja `FilePullerDeviceMetricCollector`, która umożliwia pobieranie plików perfetto z urządzenia i zbieranie z nich danych.
RebootReasonCollector	Zbieracz, 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ń w czasie działania (awarie serwera systemu) podczas testu (jeśli wystąpiły).
ScreenshotOnFailureCollector	Kolekcjoner, który rejestruje zrzuty ekranu i je przechowuje, gdy test się nie powiedzie.
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 zapisują je w wywołaniu.

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

Tego interfejsu nie można użyć jako , nawet jeśli rozszerza on ITestInvocationListener. Sprawdzanie konfiguracji spowoduje jej odrzucenie. Musi być używany jako „metrics_collector”.

Zbieracze nie muszą zachowywać stanu wewnętrznego, ponieważ mogą być używane w kilku miejscach. Jeśli naprawdę musisz użyć stanu wewnętrznego, powinieneś 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 kolekcjoner jest odpowiedni do przechwytywania na poziomie modułu i czy powinien być inicjowany.
`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 oryginalną wartość `ITestInvocationListener`, do której kierujemy wyniki.
`abstract ITestInvocationListener`	`init(IInvocationContext context, ITestInvocationListener listener)` Inicjowanie zbieracza z bieżącym kontekstem i miejscem docelowym wyników.
`abstract void`	`onTestAssumptionFailure(DeviceMetricData testData, TestDescription test)` wywołanie zwrotne, gdy przypadek testowy zakończy się niepowodzeniem z powodu niespełnienia 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 działania 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 testu.

Metody publiczne

captureModuleLevel

public boolean captureModuleLevel ()

Określa, czy kolekcjoner jest odpowiedni do przechwytywania na poziomie modułu i czy powinien być inicjowany.

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 oryginalną wartość ITestInvocationListener, do której kierujemy wyniki.

Zwroty
`ITestInvocationListener`

init

public abstract ITestInvocationListener init (IInvocationContext context, 
                ITestInvocationListener listener)

Inicjowanie zbieracza z bieżącym kontekstem i miejscem docelowym wyników. Będzie wywoływany tylko raz na instancję, a zbieracz powinien zaktualizować swój wewnętrzny kontekst i słuchacza. Funkcja init nigdy nie zostanie wywołana podczas testu.

Nie zastępuj, chyba że wiesz, co robisz.

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

Zwroty
`ITestInvocationListener`	nowy słuchacz zastępuje pierwotnego.

Rzuty
`DeviceNotAvailableException`

onTestAssumptionFailure

public abstract void onTestAssumptionFailure (DeviceMetricData testData, 
                TestDescription test)

wywołanie zwrotne, gdy przypadek testowy zakończy się niepowodzeniem z powodu niespełnienia założenia.

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

Rzuty
`DeviceNotAvailableException`

onTestEnd

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

wywołanie zwrotne po zakończeniu testu. Czas na porządki.

Parametry
`testData`	`DeviceMetricData`: `DeviceMetricData` zawierający dane testowe. Będzie to ten sam obiekt co podczas `onTestStart(com.android.tradefed.device.metric.DeviceMetricData)`.
`currentTestCaseMetrics`	: bieżąca mapa danych przekazanych do `ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map))`.
`test`	`TestDescription`: `TestDescription` elementu testowania w trakcie wykonywania.

Rzuty
`DeviceNotAvailableException`

onTestEnd

public abstract void onTestEnd (DeviceMetricData testData, 
                 currentTestCaseMetrics)

wywołanie zwrotne po zakończeniu testu. Czas na porządki.

Parametry
`testData`	`DeviceMetricData`: `DeviceMetricData` zawierający dane testowe. Będzie to ten sam obiekt co podczas `onTestStart(com.android.tradefed.device.metric.DeviceMetricData)`.
`currentTestCaseMetrics`	: bieżąca mapa danych przekazanych do `ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map))`.

Rzuty
`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 testowe.
`test`	`TestDescription`: `TestDescription` elementu testowania w trakcie wykonywania.

Rzuty
`DeviceNotAvailableException`

onTestModuleEnded

public void onTestModuleEnded ()

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

Rzuty
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

onTestModuleStarted

public void onTestModuleStarted ()

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

Rzuty
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

onTestRunEnd

public abstract void onTestRunEnd (DeviceMetricData runData, 
                 currentRunMetrics)

wywołanie zwrotne po zakończeniu testu. Czas na porządki.

Parametry
`runData`	`DeviceMetricData`: `DeviceMetricData` zawierający dane dotyczące wykonania. Będzie to ten sam obiekt co w `onTestRunStart(com.android.tradefed.device.metric.DeviceMetricData)`.
`currentRunMetrics`	: bieżąca mapa danych przekazanych do `ERROR(/#testRunEnded(long,Map))`.

Rzuty
`DeviceNotAvailableException`

onTestRunStart

public abstract void onTestRunStart (DeviceMetricData runData)

wywołanie zwrotne po rozpoczęciu testu.

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

Rzuty
`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 wykonania.
`testCount`	`int`: liczba przypadków testowych w tej sesji testowej.

Rzuty
`DeviceNotAvailableException`

onTestStart

public abstract void onTestStart (DeviceMetricData testData)

wywołanie zwrotne po rozpoczęciu testu.

Parametry
`testData`	`DeviceMetricData`: `DeviceMetricData` zawierający dane testowe.

Rzuty
`DeviceNotAvailableException`