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 uses AI technology to translate content into your preferred language. AI translations can contain errors.

BaseDeviceMetricCollector

public class BaseDeviceMetricCollector
extends Object implements IDeviceActionReceiver, IMetricCollector

java.lang.Object
↳	com.android.tradefed.device.metric.BaseDeviceMetricCollector

Znane bezpośrednie podklasy

AtraceCollector	`IMetricCollector`, który uruchamia atrace podczas testu, zbiera wynik i loguje go w wywołaniu.
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.
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.
ModulePerfettoCollector	Kolektor, który rozpoczyna śledzenie Perfetto, gdy moduł testowy się uruchamia i kończy działanie oraz gdy urządzenie jest ponownie uruchamiane.
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.

Znane podklasy pośrednie

AtraceRunMetricCollector, BluetoothConnectionLatencyCollector, BluetoothConnectionStateCollector, BluetoothHciSnoopLogCollector, FilePullerLogCollector, ModuleLogcatCollector, PerfettoFilePullerCollector, PerfettoPullerMetricCollector, ShowmapPullerMetricCollector, TraceCmdCollector

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.
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.
FilePullerLogCollector	Rejestrator pliku zgłaszanego przez urządzenie.
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)`.
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.

Podstawowa implementacja IMetricCollector, która umożliwia rozpoczęcie i zatrzymanie zbierania danych na platformach onTestRunStart(DeviceMetricData) i onTestRunEnd(DeviceMetricData,Map).

Podsumowanie

Stałe
`String`	`TEST_CASE_EXCLUDE_GROUP_OPTION`
`String`	`TEST_CASE_INCLUDE_GROUP_OPTION`

Konstruktory publiczne
`BaseDeviceMetricCollector()`

Metody publiczne
`boolean`	`doesModuleContainFailure()` Zwraca wartość „true”, jeśli w bieżącym module wystąpiły błędy w przypadkach testowych lub przebiegach testów.
`void`	`enableDefaultMetricCollection()` Umożliwia podmiotom zbierającym włączenie domyślnego zbierania danych.
`void`	`extraInit(IInvocationContext context, ITestInvocationListener listener)`
`IMetricCollector.MetricCollectionLevel`	`getAlwaysOnCollectionLevel()`
`final List<IBuildInfo>`	`getBuildInfos()` Zwraca listę informacji o kompilacji dostępnych w wywołaniu.
`final List<ITestDevice>`	`getDevices()` Zwraca listę urządzeń dostępnych w wywołaniu.
`File`	`getFileFromTestArtifacts(String fileName)` Pobierz plik z artefaktów testowych lub artefaktów modułu i zapisz go w pamięci podręcznej w mapie na potrzeby kolejnych wywołań.
`final ITestInvocationListener`	`getInvocationListener()` Zwraca oryginalny adres `ITestInvocationListener`, na który przekazujemy wyniki.
`String`	`getModuleName()`
`IMetricCollector.MetricCollectionLevel`	`getOnFailureCollectionLevel()`
`final List<ITestDevice>`	`getRealDevices()` Zwraca wszystkie urządzenia inne niż urządzenia zastępcze z listy `getDevices()`.
`String`	`getRunName()` Zwraca nazwę przebiegu testu `mRunName`, który uruchamia kolektor.
`String`	`getTestName()` Zwraca nazwę testu `mTestName`, który uruchamia kolektor.
`final ITestInvocationListener`	`init(IInvocationContext context, ITestInvocationListener listener)` Inicjowanie sieci zbierającej z bieżącym kontekstem i miejscem przekazywania wyników.
`final void`	`invocationEnded(long elapsedTime)` Informuje, że wywołanie zostało zakończone, niezależnie od tego, czy zakończyło się ono pomyślnie, czy z powodu błędu.
`final void`	`invocationFailed(FailureDescription failure)` Zgłasza niekompletne wywołanie z powodu błędu.
`final void`	`invocationFailed(Throwable cause)` Zgłasza niekompletne wywołanie z powodu błędu.
`void`	`invocationSkipped(SkipReason reason)` Zgłasza wywołanie jako pominięte
`final void`	`invocationStarted(IInvocationContext context)` Odbiorniki wywołań do przekazywania
`boolean`	`isDefaultMetricCollectionEnabled()` Informacja o tym, czy kolektor zbiera wskaźniki w ramach domyślnego zbierania danych.
`final boolean`	`isDisabled()` Zwraca wartość True, jeśli cały obiekt jest wyłączony (pomija zarówno konfigurację, jak i zamykanie).
`boolean`	`isDisabledReceiver()` Czy `IDeviceActionReceiver` jest wyłączony.
`final void`	`logAssociation(String dataName, LogFile logFile)` Nie używaj w implementacji modułu zbierającego dane.
`void`	`onTestAssumptionFailure(DeviceMetricData testData, TestDescription test)` Wywołanie zwrotne, gdy element testowania zakończy się niepowodzeniem z powodu nieprawidłowego założenia.
`void`	`onTestEnd(DeviceMetricData testData, Map<String, MetricMeasurement.Metric> currentTestCaseMetrics)` Wywołanie zwrotne po zakończeniu elementu testowania.
`void`	`onTestEnd(DeviceMetricData testData, Map<String, MetricMeasurement.Metric> currentTestCaseMetrics, TestDescription test)` Wywołanie zwrotne po zakończeniu elementu testowania.
`void`	`onTestFail(DeviceMetricData testData, TestDescription test)` Wywołanie zwrotne, gdy test się nie powiedzie.
`void`	`onTestModuleEnded()` Umożliwia rejestrowanie zdarzenia zakończenia modułu.
`void`	`onTestModuleStarted()` Umożliwia rejestrowanie zdarzenia rozpoczęcia modułu.
`void`	`onTestRunEnd(DeviceMetricData runData, Map<String, MetricMeasurement.Metric> currentRunMetrics)` Wywołanie zwrotne po zakończeniu sesji testowej.
`void`	`onTestRunFailed(DeviceMetricData testData, FailureDescription failure)` Wywołanie zwrotne w przypadku zdarzeń testRunFailed
`void`	`onTestRunStart(DeviceMetricData runData)` Wywołanie zwrotne po rozpoczęciu sesji testowej.
`void`	`onTestStart(DeviceMetricData testData)` Wywołanie zwrotne po rozpoczęciu elementu testowania.
`void`	`rebootEnded(ITestDevice device)` Otrzymuje powiadomienie o zakończeniu ponownego uruchamiania urządzenia.
`void`	`rebootStarted(ITestDevice device)` Otrzymuje powiadomienie o rozpoczęciu ponownego uruchamiania urządzenia.
`void`	`setAlwaysOnCollectionLevel(IMetricCollector.MetricCollectionLevel level)` Ustawia poziom, na którym kolektor ma zbierać logi niezależnie od błędów.
`final void`	`setDisable(boolean isDisabled)` Określa, czy obiekt ma być wyłączony.
`void`	`setDisableReceiver(boolean isDisabled)` Określa, czy `IDeviceActionReceiver` ma być wyłączony.
`final void`	`setLogSaver(ILogSaver logSaver)` Nie używaj w implementacji modułu zbierającego dane.
`void`	`setModuleContainsFailure()` Określa, czy w module wystąpiły jakieś błędy (przypadek testowy, test).
`void`	`setOnFailureCollectionLevel(IMetricCollector.MetricCollectionLevel level)` Określa poziom, na którym kolektor ma zbierać logi w przypadku awarii.
`final void`	`testAssumptionFailure(TestDescription test, String trace)` Wywoływana, gdy test atomowy zgłasza, że zakłada warunek, który jest fałszywy
`final void`	`testAssumptionFailure(TestDescription test, FailureDescription failure)` Wywoływana, gdy test atomowy zgłasza, że zakłada warunek, który jest fałszywy
`final void`	`testEnded(TestDescription test, long endTime, HashMap<String, MetricMeasurement.Metric> testMetrics)` Alternatywa dla `testEnded(TestDescription,Map)`, w której możemy bezpośrednio określić czas zakończenia.
`final void`	`testEnded(TestDescription test, HashMap<String, MetricMeasurement.Metric> testMetrics)` Zgłasza zakończenie wykonania pojedynczego elementu testowania.
`final void`	`testFailed(TestDescription test, FailureDescription failure)` Zgłasza niepowodzenie pojedynczego elementu testowania.
`final void`	`testFailed(TestDescription test, String trace)` Zgłasza niepowodzenie pojedynczego elementu testowania.
`final void`	`testIgnored(TestDescription test)` Wywoływana, gdy test nie zostanie uruchomiony, zwykle dlatego, że metoda testowa jest oznaczona adnotacją org.junit.Ignore.
`final void`	`testLog(String dataName, LogDataType dataType, InputStreamSource dataStream)` Zawiera powiązane dane dziennika lub dane debugowania z wywołania testu.
`final void`	`testLogSaved(String dataName, LogDataType dataType, InputStreamSource dataStream, LogFile logFile)` Nie używaj w implementacji modułu zbierającego dane.
`final void`	`testModuleEnded()` Zgłasza zakończenie działania modułu.
`final void`	`testModuleStarted(IInvocationContext moduleContext)` Zgłasza rozpoczęcie działania modułu.
`final void`	`testRunEnded(long elapsedTime, HashMap<String, MetricMeasurement.Metric> runMetrics)` Zgłasza zakończenie sesji testowej.
`final void`	`testRunFailed(FailureDescription failure)` Zgłasza, że nie udało się ukończyć sesji testowej z powodu błędu opisanego przez `FailureDescription`.
`final void`	`testRunFailed(String errorMessage)` Zgłasza, że nie udało się ukończyć sesji testowej z powodu błędu krytycznego.
`final void`	`testRunStarted(String runName, int testCount, int attemptNumber)` Zgłasza rozpoczęcie sesji testowej.
`final void`	`testRunStarted(String runName, int testCount)` Wywołania zwrotne testu
`final void`	`testRunStarted(String runName, int testCount, int attemptNumber, long startTime)` Zgłasza rozpoczęcie sesji testowej.
`final void`	`testRunStopped(long elapsedTime)` Zgłasza zatrzymanie sesji testowej przed zakończeniem na prośbę użytkownika.
`final void`	`testSkipped(TestDescription test, SkipReason reason)` Wywoływana, gdy test jest pomijany i nie jest wykonywany z przyczyny, która zwykle nie jest oczekiwana.
`final void`	`testStarted(TestDescription test, long startTime)` Alternatywa dla `testStarted(TestDescription)`, w której podajemy też datę rozpoczęcia testu, w połączeniu z `testEnded(TestDescription,long,Map)`, aby uzyskać dokładny pomiar.
`final void`	`testStarted(TestDescription test)` Wywołania zwrotne przypadków testowych

Stałe

TEST_CASE_EXCLUDE_GROUP_OPTION

public static final String TEST_CASE_EXCLUDE_GROUP_OPTION

Wartość stała: "test-case-exclude-group"

TEST_CASE_INCLUDE_GROUP_OPTION

public static final String TEST_CASE_INCLUDE_GROUP_OPTION

Wartość stała: "test-case-include-group"

Konstruktory publiczne

BaseDeviceMetricCollector

public BaseDeviceMetricCollector ()

Metody publiczne

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.

extraInit

public void extraInit (IInvocationContext context, 
                ITestInvocationListener listener)

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

getAlwaysOnCollectionLevel

public IMetricCollector.MetricCollectionLevel getAlwaysOnCollectionLevel ()

Zwraca
`IMetricCollector.MetricCollectionLevel`

getBuildInfos

public final List<IBuildInfo> getBuildInfos ()

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

Zwraca
`List<IBuildInfo>`

getDevices

public final List<ITestDevice> getDevices ()

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

Zwraca
`List<ITestDevice>`

getFileFromTestArtifacts

public File getFileFromTestArtifacts (String fileName)

Pobierz plik z artefaktów testowych lub artefaktów modułu i zapisz go w pamięci podręcznej w mapie na potrzeby kolejnych wywołań.

Parametry
`fileName`	`String`: nazwa pliku do wyszukania w artefaktach.

Zwraca
`File`	Plik z artefaktu testowego lub artefaktu modułu. Zwraca wartość null, jeśli nie znaleziono pliku.

getInvocationListener

public final ITestInvocationListener getInvocationListener ()

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

Zwraca
`ITestInvocationListener`

getModuleName

public String getModuleName ()

Zwraca
`String`

getOnFailureCollectionLevel

public IMetricCollector.MetricCollectionLevel getOnFailureCollectionLevel ()

Zwraca
`IMetricCollector.MetricCollectionLevel`

getRealDevices

public final List<ITestDevice> getRealDevices ()

Zwraca wszystkie urządzenia inne niż urządzenia zastępcze z listy getDevices().

Zwraca
`List<ITestDevice>`

getRunName

public String getRunName ()

Zwraca nazwę przebiegu testu mRunName, który uruchamia kolektor.

Zwraca
`String`	mRunName, nazwa bieżącego przebiegu testu.

getTestName

public String getTestName ()

Zwraca nazwę testu mTestName, który uruchamia kolektor.

Zwraca
`String`	mTestName, nazwa bieżącego testu.

init

public final 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`

invocationEnded

public final void invocationEnded (long elapsedTime)

Informuje, że wywołanie zostało zakończone, niezależnie od tego, czy zakończyło się ono pomyślnie, czy z powodu błędu.

Zostanie automatycznie wywołana przez platformę TradeFederation.

Parametry
`elapsedTime`	`long`: czas trwania wywołania w milisekundach.

invocationFailed

public final void invocationFailed (FailureDescription failure)

Zgłasza niekompletne wywołanie z powodu błędu.

Zostanie automatycznie wywołana przez platformę TradeFederation.

Parametry
`failure`	`FailureDescription`: `FailureDescription` opisująca przyczynę niepowodzenia.

invocationFailed

public final void invocationFailed (Throwable cause)

Zgłasza niekompletne wywołanie z powodu błędu.

Zostanie automatycznie wywołana przez platformę TradeFederation.

Parametry
`cause`	`Throwable`: `Throwable` przyczyna niepowodzenia

invocationSkipped

public void invocationSkipped (SkipReason reason)

Zgłasza wywołanie jako pominięte

Parametry
`reason`	`SkipReason`

invocationStarted

public final void invocationStarted (IInvocationContext context)

Odbiorniki wywołań do przekazywania

Parametry
`context`	`IInvocationContext`: informacje o wywołaniu,

isDefaultMetricCollectionEnabled

public boolean isDefaultMetricCollectionEnabled ()

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

Zwraca
`boolean`

isDisabled

public final boolean isDisabled ()

Zwraca wartość True, jeśli cały obiekt jest wyłączony (pomija zarówno konfigurację, jak i zamykanie). W przeciwnym razie ma wartość Fałsz.

Zwraca
`boolean`

isDisabledReceiver

public boolean isDisabledReceiver ()

Czy IDeviceActionReceiver jest wyłączony.

Zwraca
`boolean`	Zwraca wartość true, jeśli jest wyłączona, w przeciwnym razie zwraca wartość false.

logAssociation

public final void logAssociation (String dataName, 
                LogFile logFile)

Nie używaj w implementacji modułu zbierającego dane. Jest to czyste przekazywanie.

Parametry
`dataName`	`String`: nazwa danych
`logFile`	`LogFile`: `LogFile`, który został zarejestrowany wcześniej i powinien być powiązany z elementem testowania.

onTestAssumptionFailure

public 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 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`

onTestEnd

public 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`

onTestFail

public 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
`DeviceNotAvailableException`

onTestModuleStarted

public void onTestModuleStarted ()

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

Zgłasza
`DeviceNotAvailableException`

onTestRunEnd

public 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`

onTestRunFailed

public void onTestRunFailed (DeviceMetricData testData, 
                FailureDescription failure)

Wywołanie zwrotne w przypadku zdarzeń testRunFailed

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

onTestRunStart

public 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`

onTestStart

public void onTestStart (DeviceMetricData testData)

Wywołanie zwrotne po rozpoczęciu elementu testowania.

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

Zgłasza
`DeviceNotAvailableException`

rebootEnded

public void rebootEnded (ITestDevice device)

Otrzymuje powiadomienie o zakończeniu ponownego uruchamiania urządzenia.

UWAGA: podczas tego oddzwaniania odbiorcy nie powinni ponownie uruchamiać urządzenia. Wszelkie próby ponownego uruchomienia zostaną zignorowane.

Parametry
`device`	`ITestDevice`: `ITestDevice`, gdzie zakończył się restart.

Zgłasza
`DeviceNotAvailableException`

rebootStarted

public void rebootStarted (ITestDevice device)

Otrzymuje powiadomienie o rozpoczęciu ponownego uruchamiania urządzenia.

UWAGA: podczas tego oddzwaniania odbiorcy nie powinni ponownie uruchamiać urządzenia. Wszelkie próby ponownego uruchomienia zostaną zignorowane.

Parametry
`device`	`ITestDevice`: `ITestDevice` miejsce, w którym rozpoczęło się ponowne uruchamianie.

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.

setDisable

public final void setDisable (boolean isDisabled)

Określa, czy obiekt ma być wyłączony. Wyłączone oznacza, że należy pominąć zarówno kroki konfiguracji, jak i kroki zamykania. Można go użyć, aby domyślnie wyłączyć obiekt w konstruktorze domyślnym.

Parametry
`isDisabled`	`boolean`: stan, w jakim powinien znajdować się obiekt.

setDisableReceiver

public void setDisableReceiver (boolean isDisabled)

Określa, czy IDeviceActionReceiver ma być wyłączony. Wyłączenie oznacza, że nie będzie on zarejestrowany na urządzeniu do odbierania zdarzeń związanych z działaniami na urządzeniu.

Parametry
`isDisabled`	`boolean`

setLogSaver

public final void setLogSaver (ILogSaver logSaver)

Nie używaj w implementacji modułu zbierającego dane. Jest to czyste przekazywanie.

Parametry
`logSaver`	`ILogSaver`: `ILogSaver`

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.

testAssumptionFailure

public final void testAssumptionFailure (TestDescription test, 
                String trace)

Wywoływana, gdy test atomowy zgłasza, że zakłada warunek, który jest fałszywy

Parametry
`test`	`TestDescription`: identyfikuje test
`trace`	`String`: zrzut stosu błędu

testAssumptionFailure

public final void testAssumptionFailure (TestDescription test, 
                FailureDescription failure)

Wywoływana, gdy test atomowy zgłasza, że zakłada warunek, który jest fałszywy

Parametry
`test`	`TestDescription`: identyfikuje test
`failure`	`FailureDescription`: `FailureDescription` opisuje błąd i jego kontekst.

testEnded

public final void testEnded (TestDescription test, 
                long endTime, 
                HashMap<String, MetricMeasurement.Metric> testMetrics)

Alternatywa dla testEnded(TestDescription,Map), w której możemy bezpośrednio określić czas zakończenia. Łącz z testStarted(TestDescription,long), aby uzyskać dokładne pomiary.

Parametry
`test`	`TestDescription`: identyfikuje test
`endTime`	`long`: czas zakończenia testu mierzony za pomocą `System.currentTimeMillis()`
`testMetrics`	`HashMap`: `Map` danych wygenerowanych

testEnded

public final void testEnded (TestDescription test, 
                HashMap<String, MetricMeasurement.Metric> testMetrics)

Zgłasza zakończenie wykonania pojedynczego elementu testowania.

Jeśli funkcja testFailed(TestDescription, FailureDescription) nie została wywołana, test uznaje się za zaliczony. Zwraca też wszystkie dane klucz/wartość, które mogły zostać wyemitowane podczas wykonywania elementu testowania.

Parametry
`test`	`TestDescription`: identyfikuje test
`testMetrics`	`HashMap`: `Map` danych wygenerowanych

testFailed

public final void testFailed (TestDescription test, 
                FailureDescription failure)

Zgłasza niepowodzenie pojedynczego elementu testowania.

Wywoływana między testStarted a testEnded.

Parametry
`test`	`TestDescription`: identyfikuje test
`failure`	`FailureDescription`: `FailureDescription` opisuje błąd i jego kontekst.

testFailed

public final void testFailed (TestDescription test, 
                String trace)

Zgłasza niepowodzenie pojedynczego elementu testowania.

Wywoływana między testStarted a testEnded.

Parametry
`test`	`TestDescription`: identyfikuje test
`trace`	`String`: zrzut stosu błędu

testIgnored

public final void testIgnored (TestDescription test)

Wywoływana, gdy test nie zostanie uruchomiony, zwykle dlatego, że metoda testowa jest oznaczona adnotacją org.junit.Ignore.

Parametry
`test`	`TestDescription`: identyfikuje test

testLog

public final void testLog (String dataName, 
                LogDataType dataType, 
                InputStreamSource dataStream)

Zawiera powiązane dane dziennika lub dane debugowania z wywołania testu.

Musi być wywołana przed ERROR(ITestInvocationListener.invocationFailed(Throwable)/ITestInvocationListener#invocationFailed(java.lang.Throwable) ITestInvocationListener.invocationFailed(Throwable)) lub ERROR(/ITestInvocationListener#invocationEnded(long))

Platforma TradeFederation automatycznie wywoła tę metodę, podając dziennik hosta i w razie potrzeby dziennik logcat urządzenia.

Parametry
`dataName`	`String`: opisowa nazwa danych, np. „device_logcat”.`String` Uwaga: parametr dataName może nie być unikalny w przypadku każdego wywołania. Oznacza to, że osoby wdrażające muszą być w stanie obsłużyć wiele wywołań z tą samą nazwą dataName.
`dataType`	`LogDataType`: `LogDataType` danych
`dataStream`	`InputStreamSource`: `InputStreamSource` danych. Osoby wdrażające powinny wywołać funkcję createInputStream, aby rozpocząć odczytywanie danych, i po zakończeniu zamknąć wynikowy strumień InputStream. Wywołujący powinni zadbać o to, aby źródło danych było dostępne do momentu zakończenia działania metody testLog.

testLogSaved

public final void testLogSaved (String dataName, 
                LogDataType dataType, 
                InputStreamSource dataStream, 
                LogFile logFile)

Nie używaj w implementacji modułu zbierającego dane. Jest to czyste przekazywanie.

Parametry
`dataName`	`String`: opisowa nazwa danych, np. „device_logcat”.`String` Uwaga: dataName może nie być unikalne w przypadku każdego wywołania. Oznacza to, że osoby wdrażające muszą być w stanie obsłużyć wiele wywołań z tą samą wartością dataName.
`dataType`	`LogDataType`: `LogDataType` danych
`dataStream`	`InputStreamSource`: `InputStreamSource` danych. Wdrażający powinni wywołać funkcję createInputStream, aby rozpocząć odczytywanie danych, i po zakończeniu zamknąć wynikowy InputStream.
`logFile`	`LogFile`: `LogFile` zawierający metadane zapisanego pliku.

testModuleEnded

public final void testModuleEnded ()

Zgłasza zakończenie działania modułu.

testModuleStarted

public final void testModuleStarted (IInvocationContext moduleContext)

Zgłasza rozpoczęcie działania modułu. Ten wywołanie zwrotne jest powiązane z elementem testModuleEnded() i jest opcjonalne w sekwencji. Jest używany tylko podczas uruchamiania modułów: narzędzi uruchamiających opartych na pakietach.

Parametry
`moduleContext`	`IInvocationContext`: `IInvocationContext` modułu.

testRunEnded

public final void testRunEnded (long elapsedTime, 
                HashMap<String, MetricMeasurement.Metric> runMetrics)

Zgłasza zakończenie sesji testowej. FIXME: Nie możemy mieć dwóch interfejsów Map<> z różnymi typami, więc musimy tutaj użyć HashMap.

Parametry
`elapsedTime`	`long`: czas, który upłynął od ostatniego zgłoszenia przez urządzenie (w milisekundach)
`runMetrics`	`HashMap`: pary klucz/wartość zgłaszane na zakończenie sesji testowej z parametrem `Metric`.

testRunFailed

public final void testRunFailed (FailureDescription failure)

Zgłasza, że nie udało się ukończyć sesji testowej z powodu błędu opisanego przez FailureDescription.

Parametry
`failure`	`FailureDescription`: `FailureDescription` opisuje błąd i jego kontekst.

testRunFailed

public final void testRunFailed (String errorMessage)

Zgłasza, że nie udało się ukończyć sesji testowej z powodu błędu krytycznego.

Parametry
`errorMessage`	`String`: `String` opisuje przyczynę niepowodzenia uruchomienia.

testRunStarted

public final void testRunStarted (String runName, 
                int testCount, 
                int attemptNumber)

Zgłasza rozpoczęcie sesji testowej.

Parametry
`runName`	`String`: nazwa sesji testowej
`testCount`	`int`: łączna liczba testów podczas sesji testowej
`attemptNumber`	`int`: numer zamówienia, który identyfikuje różne próby tego samego uruchomienia runName wykonywanego wielokrotnie. Numer próby jest indeksowany od 0 i powinien zwiększać się za każdym razem, gdy następuje nowe uruchomienie. Przykład: test jest ponownie uruchamiany 3 razy, więc powinien mieć łącznie 4 uruchomienia pod tą samą nazwą uruchomienia, a numer próby powinien wynosić od 0 do 3.

testRunStarted

public final void testRunStarted (String runName, 
                int testCount)

Wywołania zwrotne testu

Parametry
`runName`	`String`: nazwa sesji testowej
`testCount`	`int`: łączna liczba testów podczas sesji testowej

testRunStarted

public final void testRunStarted (String runName, 
                int testCount, 
                int attemptNumber, 
                long startTime)

Zgłasza rozpoczęcie sesji testowej.

Parametry
`runName`	`String`: nazwa sesji testowej
`testCount`	`int`: łączna liczba testów podczas sesji testowej
`attemptNumber`	`int`: numer zamówienia, który identyfikuje różne próby tego samego uruchomienia runName wykonywanego wielokrotnie. Wartość attemptNumber jest indeksowana od zera i powinna zwiększać się za każdym razem, gdy następuje nowe uruchomienie. Na przykład jeśli test jest ponownie uruchamiany 3 razy, powinien mieć łącznie 4 uruchomienia pod tą samą nazwą runName, a wartość attemptNumber powinna wynosić od 0 do 3.
`startTime`	`long`: czas rozpoczęcia uruchomienia mierzony za pomocą `System.currentTimeMillis()`

testRunStopped

public final void testRunStopped (long elapsedTime)

Zgłasza zatrzymanie sesji testowej przed zakończeniem na prośbę użytkownika.

TODO: obecnie nieużywane, rozważ usunięcie

Parametry
`elapsedTime`	`long`: czas, który upłynął od ostatniego zgłoszenia przez urządzenie (w milisekundach)

testSkipped

public final void testSkipped (TestDescription test, 
                SkipReason reason)

Wywoływana, gdy test jest pomijany i nie jest wykonywany z przyczyny, która zwykle nie jest oczekiwana. Te testy będą ponawiane, aby uzyskać prawidłowe wykonanie.

Parametry
`test`	`TestDescription`: identyfikuje test
`reason`	`SkipReason`: `SkipReason`

testStarted

public final void testStarted (TestDescription test, 
                long startTime)

Alternatywa dla testStarted(TestDescription), w której podajemy też datę rozpoczęcia testu, w połączeniu z testEnded(TestDescription,long,Map), aby uzyskać dokładny pomiar.

Parametry
`test`	`TestDescription`: identyfikuje test
`startTime`	`long`: czas rozpoczęcia testu mierzony za pomocą `System.currentTimeMillis()`

testStarted

public final void testStarted (TestDescription test)

Wywołania zwrotne przypadków testowych

Parametry
`test`	`TestDescription`: identyfikuje test