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

AggregatePostProcessor	Zbiór danych, który zwraca minimalną, maksymalną, średnią, wariancję, odchylenie standardowe, sumę, liczbę i opcjonalnie wartości procentylowe danych numerycznych zebranych podczas testów z wieloma iteracjami, traktując je jako podwójne liczby zmiennoprzecinkowe.
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.
AveragePostProcessor	Implementacja post-processora, który oblicza średnią z listy danych.
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))`.
BasePostProcessor	Podstawowa implementacja `IPostProcessor`, którą powinna rozszerzać każda implementacja.
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.
BluetoothConnectionSuccessRatePostProcessor	Implementacja postprocesora, który oblicza wskaźnik sukcesu dla profilu Bluetooth Użyj parametru „metric-key-match”, aby określić dane, które zawierają stany połączeń Bluetooth w tablicy liczbowej. Przykład: [0, 1, 2, 3, 0, 1, 2, 3].
BluetoothHciSnoopLogCollector	Collector do włączania zapisywania w dzienniku snoopingu interfejsu HCI Bluetooth na urządzeniu testowym i zbierania dziennika dla każdego testu.
BugreportCollector	Przepuszczająca reguła `ITestInvocationListener`, która zbiera raporty o błędach po wystąpieniu zdarzeń konfigurowalnych, a potem wywołuje regułę `ITestInvocationListener.testLog` w swoich elementach podrzędnych po zebraniu każdego raportu o błędzie.
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.
CollectingTestListener	`ITestInvocationListener`, który będzie zawierać wszystkie wyniki testów.
CommandStatusHandler	Handler pomagający w monitorowaniu i aktualizowaniu stanu wywołania.
ConditionFailureMonitor	Sprawdzanie, czy wywołanie nie zakończyło się błędem.
ConsoleResultReporter	Wyświetlanie wyników w konsoli.
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.
DeviceReleaseReporter	Zgłaszanie wersji urządzenia, które obsługuje komunikację z procesem nadrzędnym urządzeń, których wersje mają zostać opublikowane.
DeviceTraceCollector	Kolekcjoner, który rozpocznie śledzenie perfetto po rozpoczęciu testu i na końcu wygeneruje plik z śladem.
DeviceUnavailableMonitor	Ten listener próbuje przechwycić tylko DNAE na poziomie przypadku testowego.
EventsLoggerListener	Listener, który rejestruje wszystkie zdarzenia w pliku.
FileProtoResultReporter	Proto reporter, który zapisuje `TestRecord` do pliku.
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.
FilteredResultForwarder	Wariant `ResultForwarder`, który umożliwia raportowanie tylko listy dozwolonych `TestDescription`.
FormattedGeneratorReporter	Raportowanie umożliwiające generowanie raportów w określonym formacie.
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.
GranularRetriableTestWrapper.StartEndCollector	Pomocnik klasy do wychwytywania brakujących początków i zakończeń przebiegu.
HostStatsdMetricCollector	`IMetricCollector`, który zbiera dane statsd po stronie hosta za pomocą poleceń narzędzia statsd.
ICommandScheduler.IScheduledInvocationListener	Listener dla zdarzeń wywołania po zakończeniu wywołania.
ILogSaverListener	Umożliwia `ITestInvocationListener` nasłuchiwanie zapisywania plików dziennika.
IMetricCollector	Ten interfejs zostanie dodany jako dekorator podczas raportowania wyników testów w celu zbierania danych pasujących do nich.
IPostProcessor	Post Processors to obiekt Trade Federation, który umożliwia przetwarzanie danych i dzienników PO przeprowadzeniu testów i PRZED raportowaniem wyników.
IShardableListener	`ITestInvocationListener`, które można podzielić na fragmenty.
ISupportGranularResults	Interfejs określający, czy `ITestInvocationListener` obsługuje otrzymywanie szczegółowych wyników.
ITestSummaryListener	Interfejs umożliwiający `ITestInvocationListener` wymianę ograniczonej ilości informacji za pomocą podsumowań.
InvocationProtoResultReporter	Reporters to store invocation level caching information and its list of modules
InvocationToJUnitResultForwarder	Klasa, która nasłuchuje zdarzeń `ITestInvocationListener` i przesyła je do `TestListener`.
JarHostTest.HostTestListener	Detektor opakowania, który przekazuje wszystkie zdarzenia oprócz testRunStarted() i testRunEnded() do wbudowanego detektora.
JavaCodeCoverageCollector	`BaseDeviceMetricCollector`, który pobiera z urządzenia pomiary pokrycia w języku Java i rejestruje je jako artefakty testowe.
JsonHttpTestResultReporter	Raport z wynikami, który koduje wyniki testów i informacje o gałęzi i urządzeniu w formacie JSON, a następnie przesyła je do punktu końcowego usługi HTTP.
LUCIResultReporter	Raport z wynikami, który zapisuje wyniki testów potrzebne do działania bazy danych ResultDB i LUCI w formacie JSON (go/result-sink) oraz rejestruje lokalizację pliku w konsoli.
LastShardDetector	Podczas korzystania z poddzielenia lokalnego czasami chcemy wykonać pewne działania dopiero wtedy, gdy ostatni fragment osiągnie wartość `invocationEnded(long)`.
LegacySubprocessResultsReporter	zamrożoną implementację raportera wyników podprocesu, która powinna być zgodna z wcześniejszymi wersjami TF/CTS (np. 8 i nowszymi), pomimo zmian w superklasie.
LogSaverResultForwarder	`ResultForwarder` do zapisywania dzienników za pomocą globalnego narzędzia do zapisywania plików.
LogcatCrashResultForwarder	Specjalny listener: w przypadku błędów (awarii procesu instrumentacji) próbuje wyodrębnić z logcatu informacje o awarii i dodaje je do komunikatu o błędzie powiązanego z testem.
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.
MetricFilePostProcessor	Służy do przesyłania pliku dziennika danych zebranych podczas testu i na poziomie uruchomienia.
MetricsXMLResultReporter	MetricsXMLResultReporter zapisuje dane testu i dane dotyczące wykonania w pliku XML w folderze określonym przez parametr metrics-folder na etapie invocationEnded testu.
ModuleListener	Detektor przypisany do każdego `IRemoteTest` każdego modułu w celu zebrania listy wyników.
ModuleLogcatCollector	Wersja logcat collector, ale dla modułu.
ModuleProtoResultReporter	Raport wyników miał zawierać tylko wyniki na poziomie modułu.
NameMangleListener	Słuchający pośrednik służący do tłumaczenia nazw metody testu, klasy i pakietu podczas raportowania wyników.
PassingTestFileReporter	`ITestInvocationListener`, który zapisuje listę przetestowanych przypadków testowych w pliku testowym.
PerfettoGenericPostProcessor	Przetwarzacz końcowy, który przetwarza tekstowy lub binarny plik proto perfetto z danymi pomiarowymi na pary klucz-wartość, rekurencyjnie rozszerzając wiadomości proto i pola o wartościach ciągu znaków, aż do znalezienia pola z wartością liczbową.
PerfettoPullerMetricCollector	Podstawowa implementacja `FilePullerDeviceMetricCollector`, która umożliwia pobieranie plików perfetto z urządzenia i zbieranie z nich danych.
PrettyTestEventLogger	Rejestrator dopasowuje zdarzenia i rejestruje je, aby ułatwić debugowanie.
ProtoResultReporter	Raport z wyników tworzy plik `TestRecord` protobuf ze wszystkimi wynikami.
PythonBinaryHostTest.PythonForwarder	Przesyłanie wyników, aby zastąpić nazwę procesu nazwą binarną.
RebootReasonCollector	Zbieracz, który zbiera informacje o ponownym uruchomieniu urządzenia podczas testu i zgłasza je według przyczyny i liczby.
RemoteTestTimeOutEnforcer	Odbiorniki, które umożliwiają sprawdzenie czasu wykonania danej konfiguracji testu i odrzucenie jej, jeśli przekroczy on określony limit czasu.
ReportPassedTests	Raport w pliku z możliwymi filtrami do wykluczenia zaliczonego testu.
ResultAggregator	Specjalny przekierowujący, który w razie potrzeby agreguje wyniki na podstawie przyjętej strategii ponownego próby.
przekazywanie wyników i logów,	Przesyłanie wyników i zdarzeń z dziennika.
ResultDBReporter	Raport z wyników, który przesyła wyniki testów do bazy danych o wynikach.
Przesyłanie wyników	`ITestInvocationListener`, który przekazuje wyniki wywołania do listy innych odbiorców.
RetryLogSaverResultForwarder	Przesyłacz, który przekazuje również bieżącą próbę.
RetryResultForwarder	Rozszerzenie `ResultForwarder`, które zawsze przesyła dane do określonej liczby prób.
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.
ShardListener	`ITestInvocationListener`, który zbiera wyniki z fragmentu wywołania (czyli wywołania podzielonego na kilka zasobów do działania równoległego) i przekazuje je innemu odbiorcy.
ShardMainResultForwarder	`ResultForwarder`, który łą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 pomiarowe zebrane w ramach podejścia „przed/po”, czyli
StatsdEventMetricPostProcessor	Przetwarzacz, który przetwarza dane zdarzeń w raportach statsd w pary klucz-wartość, korzystając z formaterów określonych w przetwarzaczu.
StatsdGenericPostProcessor	Przetwarzacz, który przetwarza binarne protokoły statsd na pary klucz-wartość, rozszerzając raport w postaci struktury drzewa.
StreamProtoResultReporter	Implementacja `ProtoResultReporter`
SubprocessResultsReporter	Implementuje `ITestInvocationListener`, który ma być określony jako result_reporter, i przekazuje z podprocesu wyniki testów, testów i wywołań testów.
SuiteResultReporter	Zbierać wyniki testów dla całego wywołania zestawu i wyprowadzać wyniki końcowe.
TestRunResultListener	Listener, który umożliwia odczytanie ostatniego stanu testu.
TestTimeoutEnforcer	Odbiorniki, które umożliwiają sprawdzenie czasu wykonania danego przypadku testowego i jego przerwanie, jeśli przekroczy on określony limit czasu.
TextResultReporter	Raport 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 zapisują je w wywołaniu.
TradefedSandboxRunner.StubScheduledInvocationListener	Szkielet `IScheduledInvocationListener`, który nic nie robi.
XmlFormattedGeneratorReporter	Implementacja `FormattedGeneratorReporter`, która formatuje wyniki zestawu w formacie XML.
XmlResultReporter	Zapisywanie wyników JUnit do plików XML w formacie zgodnym z elementem XMLJUnitResultFormatter w Ant.

Listener dla wyników testu z wywołania testu.

Wywołanie testu może zawierać wiele testów, 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 wywołaniu InvocationListener zwrócenie podsumowania.
`default void`	`invocationEnded(long elapsedTime)` Informuje, że wywołanie zostało zakończone (z powodu błędu lub prawidłowo).
`default void`	`invocationFailed(FailureDescription failure)` zgłasza niepełne wywołanie z powodu błędu.
`default void`	`invocationFailed(Throwable cause)` zgłasza niepełne wywołanie z powodu błędu.
`default void`	`invocationInterrupted()` Wywoływany podczas zamykania harmonogramu, daje wywołaniu możliwość wykonania jakiejś czynności przed zakończeniem.
`default void`	`invocationSkipped(SkipReason reason)` zgłasza wywołanie jako pominięte;
`default void`	`invocationStarted(IInvocationContext context)` Raportuje rozpoczęcie wywołania testu.
`default void`	`testModuleEnded()` Raportuje koniec wykonania modułu.
`default void`	`testModuleStarted(IInvocationContext moduleContext)` zgłasza rozpoczęcie działania modułu.

Metody publiczne

getSummary

public TestSummary getSummary ()

Umożliwia wywołaniu InvocationListener zwrócenie podsumowania.

Zwroty
`TestSummary`	`TestSummary` podsumowujący wykonanie, lub wartość null.

invocationEnded

public void invocationEnded (long elapsedTime)

Informuje, że wywołanie zostało zakończone (z powodu błędu lub prawidłowo).

Będzie wywoływany automatycznie przez platformę TradeFederation.

Parametry
`elapsedTime`	`long`: upłynął czas wywołania w ms

invocationFailed

public void invocationFailed (FailureDescription failure)

zgłasza niepełne wywołanie z powodu błędu.

Będzie wywoływany automatycznie przez platformę TradeFederation.

Parametry
`failure`	`FailureDescription`: `FailureDescription` opisujący przyczynę niepowodzenia

invocationFailed

public void invocationFailed (Throwable cause)

zgłasza niepełne wywołanie z powodu błędu.

Będzie wywoływany automatycznie przez platformę TradeFederation.

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

invocationInterrupted

public void invocationInterrupted ()

Wywoływany podczas zamykania harmonogramu, daje wywołaniu możliwość wykonania jakiejś czynności przed zakończeniem.

invocationSkipped

public void invocationSkipped (SkipReason reason)

zgłasza wywołanie jako pominięte;

Parametry
`reason`	`SkipReason`

invocationStarted

public void invocationStarted (IInvocationContext context)

Raportuje rozpoczęcie wywołania testu.

Będzie wywoływany automatycznie przez platformę TradeFederation. Aby umożliwić raportowanie z kilku urządzeń, autorzy raportów muszą zastąpić tę metodę.

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

testModuleEnded

public void testModuleEnded ()

Raportuje koniec wykonania 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 wykonywania testu, który korzysta z modułów: modułów opartych na zestawach.

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