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.

ITestInvocationListener

public interface ITestInvocationListener
implements ITestLifeCycleReceiver, ITestLogger

com.android.tradefed.result.ITestInvocationListener

Znane podklasy pośrednie

AggregatePostProcessor, AtraceCollector, AtraceRunMetricCollector, AveragePostProcessor, BaseDeviceMetricCollector, BasePostProcessor, BluetoothConnectionLatencyCollector, BluetoothConnectionStateCollector, BluetoothConnectionSuccessRatePostProcessor, BluetoothHciSnoopLogCollector, BugreportCollector, BugreportzOnFailureCollector, BugreportzOnTestCaseFailureCollector, ClangCodeCoverageCollector, CodeCoverageCollector i 81 innych.

AggregatePostProcessor	Agregator danych, który podaje wartość minimalną, maksymalną, średnią, wariancję, odchylenie standardowe, sumę, liczbę i opcjonalnie percentyle dla danych liczbowych zebranych podczas wielokrotnych testów, traktując je jako liczby zmiennoprzecinkowe.
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.
AveragePostProcessor	Implementacja postprocesora, który oblicza średnią z listy danych.
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))`.
BasePostProcessor	Klasa bazowa `IPostProcessor`, którą powinna rozszerzać każda implementacja.
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.
BluetoothConnectionSuccessRatePostProcessor	Implementacja postprocesora, który oblicza wskaźnik sukcesu dla profilu Bluetooth Użyj „metric-key-match”, aby określić dane, które zawierają stany połączenia Bluetooth w postaci tablicy numerycznej, np. [0, 1, 2, 3, 0, 1, 2, 3].
BluetoothHciSnoopLogCollector	Kolektor, który włącza zapisywanie w dzienniku snoopingu interfejsu HCI Bluetooth na testowanym urządzeniu i zbiera dziennik dla każdego testu.
BugreportCollector	Komponent przekazujący `ITestInvocationListener`, który zbiera raporty o błędach, gdy wystąpią konfigurowalne zdarzenia, a następnie wywołuje funkcję `ITestInvocationListener.testLog` na swoich elementach podrzędnych po zebraniu każdego raportu o błędach.
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.
CollectingTestListener	`ITestInvocationListener`, który będzie zbierać wszystkie wyniki testów.
CommandStatusHandler	Procedura obsługi, która pomaga monitorować i aktualizować stan wywołania.
ConditionFailureMonitor	Sprawdzaj, czy wywołanie nie spowodowało błędów.
ConsoleResultReporter	reporter wyników, który zapisuje wyniki testu w konsoli;
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.
DeviceReleaseReporter	Moduł zgłaszania zwolnienia urządzenia, który obsługuje komunikację z procesem nadrzędnym w celu zwolnienia urządzeń.
DeviceTraceCollector	Kolektor, który rozpoczyna śledzenie Perfetto po rozpoczęciu testu i rejestruje plik śladu na końcu.
DeviceUnavailableMonitor	Ten odbiornik próbuje przechwycić tylko DNAE na poziomie przypadku testowego.
EventsLoggerListener	Odbiornik, który rejestruje wszystkie otrzymane zdarzenia w pliku.
FileProtoResultReporter	Reporter protokołu, który zapisuje `TestRecord` w pliku.
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.
FilteredResultForwarder	Wariant `ResultForwarder`, który umożliwia zgłaszanie tylko `TestDescription` z listy dozwolonych.
FormattedGeneratorReporter	Reporter, który umożliwia generowanie raportów w określonym formacie.
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.
GranularRetriableTestWrapper.StartEndCollector	Asystent zajęć, który wykrywa brakujące rozpoczęcie i zakończenie uruchomienia.
HostStatsdMetricCollector	`IMetricCollector`, który zbiera dane statsd po stronie hosta za pomocą poleceń narzędzia statsd.
ICommandScheduler.IScheduledInvocationListener	Detektor zdarzeń wywołania, gdy wywołanie zostanie zakończone.
ILogSaverListener	Umożliwia `ITestInvocationListener`s nasłuchiwanie momentu zapisania plików dziennika.
IMetricCollector	Ten interfejs zostanie dodany jako dekorator podczas raportowania wyników testów w celu zbierania pasujących danych.
IPostProcessor	Post-processors to obiekt Trade Federation, który umożliwia przetwarzanie danych i logów PO zakończeniu testów i PRZED wygenerowaniem raportu z wynikami.
IShardableListener	`ITestInvocationListener`, który można podzielić na fragmenty.
ISupportGranularResults	Interfejs określający, czy `ITestInvocationListener` obsługuje otrzymywanie szczegółowych wyników.
ITestSummaryListener	Interfejs, który umożliwia `ITestInvocationListener` wymianę niektórych ograniczonych informacji za pomocą podsumowań.
InvocationProtoResultReporter	Moduły raportujące do przechowywania informacji o pamięci podręcznej na poziomie wywołania i listy modułów.
InvocationToJUnitResultForwarder	Klasa, która nasłuchuje zdarzeń `ITestInvocationListener` i przekazuje je do `TestListener`.
JarHostTest.HostTestListener	Detektor opakowujący, który przekazuje wszystkie zdarzenia z wyjątkiem testRunStarted() i testRunEnded() do detektora osadzonego.
JavaCodeCoverageCollector	`BaseDeviceMetricCollector`, który pobiera pomiary pokrycia kodu Java z urządzenia i zapisuje je jako artefakty testowe.
JsonHttpTestResultReporter	reporter wyników, który koduje wyniki pomiarów testowych oraz informacje o gałęzi i urządzeniu w formacie JSON i wysyła je za pomocą żądania POST do punktu końcowego usługi HTTP;
LUCIResultReporter	Reporter wyników, który zapisuje wyniki testów potrzebne ResultDB i LUCI w formacie JSON (go/result-sink) i rejestruje lokalizację pliku w konsoli.
LastShardDetector	Podczas uruchamiania lokalnego dzielenia na partycje czasami chcemy wykonywać niektóre działania tylko wtedy, gdy ostatnia partycja osiągnie wartość `invocationEnded(long)`.
LegacySubprocessResultsReporter	Zamrożona implementacja narzędzia do raportowania wyników podprocesu, która powinna zachować zgodność z wcześniejszymi wersjami TF/CTS (np. 8+), pomimo zmian w klasie nadrzędnej.
LogSaverResultForwarder	`ResultForwarder` do zapisywania logów za pomocą globalnego narzędzia do zapisywania plików.
LogcatCrashResultForwarder	Specjalny odbiornik: w przypadku awarii (proces instrumentacji ulega awarii) próbuje wyodrębnić z logcatu informacje o awarii i dodać je do komunikatu o błędzie związanego z testem.
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.
MetricFilePostProcessor	Służy do przesyłania pliku dziennika danych zebranych podczas testu i na poziomie uruchomienia.
MetricsXMLResultReporter	MetricsXMLResultReporter zapisuje dane testowe i dane wykonania do pliku XML w folderze określonym przez parametr metrics-folder w fazie invocationEnded testu.
ModuleListener	Detektor dołączony do każdego `IRemoteTest` w każdym module w celu zebrania listy wyników.
ModuleLogcatCollector	Wersja narzędzia do zbierania logcat, ale dla modułu.
ModuleProtoResultReporter	Reporter wyników przeznaczony do raportowania tylko wyników na poziomie modułu.
ModuleResultsAndMetricsForwarder	Rozszerzenie `ResultAndLogForwarder`, które dodaje do wyników testu dodatkowe dane związane z modułem.
NameMangleListener	Słuchacz proxy do tłumaczenia nazw metod testowych, klas i pakietów w miarę raportowania wyników.
PassingTestFileReporter	`ITestInvocationListener`, który zapisuje listę zdanych przypadków testowych w pliku testowym;
PerfettoFilePullerCollector	Kolektor, który pobiera pliki śledzenia Perfetto z urządzenia, opcjonalnie je kompresuje i dodaje do logów testowych.
PerfettoGenericPostProcessor	Procesor końcowy, który przetwarza tekstowy/binarny plik proto z danych Perfetto w pary klucz-wartość, rekursywnie rozwijając wiadomości i pola proto z wartościami tekstowymi, aż do napotkania pola z wartością liczbową.
PerfettoPullerMetricCollector	Ta klasa została wycofana. Zamiast niej używaj zasad `PerfettoFilePullerCollector` i `ERROR(/PerfettoTracePostProcessor)`.
PerfettoTracePostProcessor	Procesor końcowy, który pobiera pliki śledzenia Perfetto z dzienników testów i uruchamia na nich procesor śledzenia, aby wygenerować protokół metryki Perfetto.
PrettyTestEventLogger	Moduł zbierający logi dopasowuje zdarzenia i rejestruje je w odpowiedniej kolejności, aby ułatwić debugowanie.
ProtoResultReporter	Moduł raportowania wyników tworzy `TestRecord` protobuf zawierający wszystkie wyniki.
PythonBinaryHostTest.PythonForwarder	Przekazywanie wyników, które zastępuje nazwę uruchomienia nazwą pliku binarnego.
RebootReasonCollector	Kolektor, który zbiera informacje o ponownym uruchomieniu urządzenia podczas testu i raportuje je według przyczyny i liczby.
RemoteTestTimeOutEnforcer	Słuchacze, którzy umożliwiają sprawdzenie czasu wykonania danej konfiguracji testu i przerwanie go, jeśli przekroczy on określony limit czasu.
ReportPassedTests	Raport w pliku z możliwymi filtrami wykluczającymi zaliczone testy.
ResultAggregator	Specjalny moduł przekazujący, który w razie potrzeby agreguje wyniki na podstawie zastosowanej strategii ponawiania.
ResultAndLogForwarder	Przekazywanie wyników i zdarzeń z dziennika.
ResultDBReporter	Reporter wyników, który przesyła wyniki testów do ResultDB.
ResultForwarder	`ITestInvocationListener`, który przekazuje wyniki wywołania na listę innych odbiorców.
ResultReporter
RetryLogSaverResultForwarder	Przekazuje też bieżącą próbę.
RetryResultForwarder	Rozszerzenie `ResultForwarder`, które zawsze przekazuje numer próby.
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.
ShardListener	`ITestInvocationListener`, który zbiera wyniki z fragmentu wywołania (czyli wywołania podzielonego na części, które są uruchamiane równolegle na wielu zasobach) i przekazuje je do innego odbiorcy.
ShardMainResultForwarder	`ResultForwarder`, która łączy wyniki wywołań testu podzielonego na fragmenty.
ShowmapPullerMetricCollector	Podstawowa implementacja `FilePullerDeviceMetricCollector`, która umożliwia pobieranie plików showmap z urządzenia i zbieranie z nich danych.
StatsdBeforeAfterGaugeMetricPostProcessor	Procesor końcowy, który przetwarza dane liczbowe zebrane w podejściu „przed/po”, tzn.
StatsdEventMetricPostProcessor	Procesor końcowy, który przetwarza wskaźniki zdarzeń w raportach statsd na pary klucz-wartość, używając formatów określonych w procesorze.
StatsdGenericPostProcessor	Procesor końcowy, który przetwarza raporty statsd w formacie binarnym proto na pary klucz-wartość, rozwijając raport jako strukturę drzewa.
StreamProtoResultReporter	Implementacja `ProtoResultReporter`
SubprocessResultsReporter	Implementuje `ITestInvocationListener`, aby określić go jako result_reporter i przekazywać z podprocesu wyniki testów, przebiegów testów i wywołań testów.
SuiteResultReporter	Zbieranie wyników testów dla całego wywołania pakietu i wyświetlanie wyników końcowych.
TestRunResultListener	Słuchacz, który umożliwia odczytywanie ostatecznego stanu uruchomienia testu.
TestTimeoutEnforcer	Słuchacze, którzy umożliwiają sprawdzenie czasu wykonania danego przypadku testowego i przerwanie go, jeśli przekroczy on określony czas oczekiwania.
TextResultReporter	Reporter wyników testu, który przekazuje wyniki do drukarki wyników tekstowych JUnit.
TraceCmdCollector	`IMetricCollector`, który zbiera ślady podczas testu za pomocą polecenia trace-cmd i zapisuje je w wywołaniu.
TradefedSandboxRunner.StubScheduledInvocationListener	Stubs `IScheduledInvocationListener` that does nothing.
XmlFormattedGeneratorReporter	Implementacja `FormattedGeneratorReporter`, która formatuje wyniki pakietu w formacie XML.
XmlResultReporter	Zapisuje wyniki JUnit w plikach XML w formacie zgodnym z formatem XMLJUnitResultFormatter narzędzia Ant.

Odbiornik wyników testu z wywołania testu.

Pojedyncze wywołanie testu może obejmować wiele przebiegów testu, więc sekwencja wywołań będzie wyglądać tak:

invocationStarted(BuildInfo)
testRunStarted
testStarted
[testFailed]
testEnded
…
testRunEnded
…
testRunStarted
…
testRunEnded
[invocationFailed]
[testLog+]
invocationEnded
getSummary

Podsumowanie

Metody publiczne
`default TestSummary`	`getSummary()` Umożliwia zwrócenie podsumowania przez InvocationListener.
`default 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.
`default void`	`invocationFailed(FailureDescription failure)` Zgłasza niekompletne wywołanie z powodu błędu.
`default void`	`invocationFailed(Throwable cause)` Zgłasza niekompletne wywołanie z powodu błędu.
`default void`	`invocationInterrupted()` Wywoływana podczas zamykania harmonogramu. Umożliwia wywołaniu wykonanie pewnych czynności przed zakończeniem działania.
`default void`	`invocationSkipped(SkipReason reason)` Zgłasza wywołanie jako pominięte
`default void`	`invocationStarted(IInvocationContext context)` Zgłasza rozpoczęcie wywołania testu.
`default void`	`testModuleEnded()` Zgłasza zakończenie działania modułu.
`default void`	`testModuleStarted(IInvocationContext moduleContext)` Zgłasza rozpoczęcie działania modułu.

Metody publiczne

getSummary

public TestSummary getSummary ()

Umożliwia zwrócenie podsumowania przez InvocationListener.

Zwroty
`TestSummary`	`TestSummary` podsumowujące bieg lub wartość null.

invocationEnded

public 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 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ący przyczynę niepowodzenia

invocationFailed

public 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

invocationInterrupted

public void invocationInterrupted ()

Wywoływana podczas zamykania harmonogramu. Umożliwia wywołaniu wykonanie pewnych czynności przed zakończeniem działania.

invocationSkipped

public void invocationSkipped (SkipReason reason)

Zgłasza wywołanie jako pominięte

Parametry
`reason`	`SkipReason`

invocationStarted

public void invocationStarted (IInvocationContext context)

Zgłasza rozpoczęcie wywołania testu.

Zostanie automatycznie wywołana przez platformę TradeFederation. Aby obsługiwać raportowanie z wielu urządzeń, reporterzy muszą zastąpić tę metodę.

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

testModuleEnded

public void testModuleEnded ()

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

testModuleStarted

public void testModuleStarted (IInvocationContext moduleContext)

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

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