ITestLifeCycleReceiver

public interface ITestLifeCycleReceiver

com.android.tradefed.result.ITestLifeCycleReceiver

Znane podklasy pośrednie AggregatePostProcessor, AtraceCollector, AtraceRunMetricCollector, AveragePostProcessor, BaseDeviceMetricCollector, BasePostProcessor, BluetoothConnectionLatencyCollector, BluetoothConnectionStateCollector, BluetoothConnectionSuccessRatePostProcessor, BluetoothHciSnoopLogCollector, BugreportCollector, BugreportzOnFailureCollector, BugreportzOnTestCaseFailureCollector, ClangCodeCoverageCollector, CodeCoverageCollector i 81 inne. AggregatePostProcessor Zbiór danych, który zwraca minimalną, maksymalną, średnią, wariancję, odchylenie standardowe, łączną, liczbę i opcjonalnie wartości procentylowe danych numerycznych zebranych podczas testów z wielokrotnymi 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 do urządzeń wstępnie zdefiniowaną konfigurację danych o czasie trwania funkcji statsd 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 w przypadku każdego 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łączenia 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 podrzędnych regułach po zebraniu każdego raportu o błędzie.  BugreportzOnFailureCollector Tworzenie raportu o błędach po niepowodzeniu przypadku testowego.  BugreportzOnTestCaseFailureCollector Tworzenie raportu o błędach, gdy test się nie powiedzie.  ClangCodeCoverageCollector BaseDeviceMetricCollector, który pobiera z urządzenia pomiary pokrycia Clanga 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.  CountingTestResultListener TestResultListener, który śledzi łączną liczbę testów według TestStatus DebugHostLogOnFailureCollector Kolekcjoner, który gromadzi i rejestruje logi po stronie hosta, gdy wystąpi błąd przypadku testowego.  DeviceReleaseReporter Raportujący o wypuszczeniu urządzenia, który obsługuje komunikację z procesem nadrzędnym urządzenia(urządzeń) do zwolnienia.  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 je 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ń biegu.  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 słuchanie, kiedy są zapisywane pliki dziennika.  IMetricCollector Ten interfejs zostanie dodany jako dekorator podczas raportowania wyników testów w celu zbierania danych pasujących do wyników.  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.  ITestInvocationListener Listener dla wyników testu z wywołania testu.  ITestSummaryListener Interfejs umożliwiający ITestInvocationListener wymianę ograniczonych 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 klasy 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 zasięgu 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 Raportujący wyniki, który zapisuje wyniki testów potrzebne do korzystania z 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 Listener specjalny: w przypadku błędów (awarii procesu pomiarowego) próbuje wyodrębnić z logcatu informacje o awarii i dodaje je do komunikatu o błędzie powiązanego z testem.  LogcatOnFailureCollector Kolekcjoner, 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 na poziomie testu i 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 dołączony 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.  ModuleResultsAndMetricsForwarder Rozszerzenie ResultAndLogForwarder, które dodaje do wyników testu dodatkowe dane dotyczące 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ę przejść testów w pliku testowym. PerfettoGenericPostProcessor Przetwarzacz końcowy, który przetwarza plik proto perfetto z danymi tekstowymi lub binarnymi na pary klucz-wartość, rekurencyjnie rozszerzając komunikaty proto i pola o wartościach ciągu znaków, dopóki nie napotka 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 wynikami tworzy TestRecord protobuf ze wszystkimi wynikami.  PythonBinaryHostTest.PythonForwarder Przesyłanie wyników, aby zastąpić nazwę procesu nazwą binarną.  RebootReasonCollector Kolekcjoner, 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.  przesyłanie wyników i logów, Przesyłanie wyników i zdarzeń z dziennika.  ResultDBReporter   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 próby.  RuntimeRestartCollector Kolektor, który zbiera sygnatury czasowe ponownych uruchomień w czasie działania (awarii serwera systemu) podczas testu (jeśli wystąpiły).  ScreenshotOnFailureCollector Kolekcjoner, który przechwyci i zarejestruje zrzut ekranu, gdy przypadek testowy zakończy się niepowodzeniem.  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 Przetwarzacz 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 procesorze.  StatsdGenericPostProcessor Przetwarzacz, który przetwarza binarne raporty proto statsd w pary klucz-wartość, rozszerzając raport w strukturę drzewiastą.  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.  TestResultListener Uproszczone ITestLifecycleListener dla implementatorów, którym zależy tylko na wynikach poszczególnych testów.  TestRunResultListener Listener, który umożliwia odczytanie stanu końcowego uruchomienia 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.

---

Otrzymuje powiadomienia o wystąpieniu zdarzeń podczas wykonywania testów instrumentacji.

Wzorowany na org.junit.runner.notification.RunListener

Sekwencja wywołań:

• testRunStarted
• testStarted
• [testFailed]
• [testAssumptionFailure]
• [testIgnored]
• testEnded
• ....
• [testRunFailed]
• testRunEnded

Podsumowanie

Metody publiczne
default void	testAssumptionFailure(TestDescription test, String trace) Wywoływany, gdy test atomowy sygnalizuje, że przyjmuje założenie, że warunek jest fałszywy.
default void	testAssumptionFailure(TestDescription test, FailureDescription failure) Wywoływany, gdy test atomowy sygnalizuje, że przyjmuje założenie, że warunek jest fałszywy.
default void	testEnded(TestDescription test, long endTime, testMetrics) Alternatywa dla ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map)), gdzie możemy bezpośrednio określić czas zakończenia.
default void	testEnded(TestDescription test, testMetrics) Raportuje zakończenie wykonywania pojedynczego przypadku testu.
default void	testFailed(TestDescription test, FailureDescription failure) Raportuje niepowodzenie pojedynczego przypadku testowego.
default void	testFailed(TestDescription test, String trace) Raportuje niepowodzenie pojedynczego przypadku testowego.
default void	testIgnored(TestDescription test) Wywoływany, gdy test nie zostanie uruchomiony, zwykle dlatego, że metoda testu jest oznaczona adnotacją org.junit.Ignore.
default void	testRunEnded(long elapsedTimeMillis, runMetrics) Raport o zakończeniu testu.
default void	testRunFailed(FailureDescription failure) Nie udało się przeprowadzić testu raportów z powodu błędu opisanego w FailureDescription.
default void	testRunFailed(String errorMessage) Nie udało się przeprowadzić testu raportów z powodu krytycznego błędu.
default void	testRunStarted(String runName, int testCount, int attemptNumber) Raport o rozpoczęciu testu.
default void	testRunStarted(String runName, int testCount) Raport o rozpoczęciu testu.
default void	testRunStarted(String runName, int testCount, int attemptNumber, long startTime) Raport o rozpoczęciu testu.
default void	testRunStopped(long elapsedTime) Raporty o testach, które zostały przerwane przed zakończeniem na prośbę użytkownika.
default void	testSkipped(TestDescription test, SkipReason reason) Wywoływany, gdy test jest pomijany i nie jest wykonywany z nieoczekiwanego powodu.
default void	testStarted(TestDescription test, long startTime) Alternatywa dla testStarted(com.android.tradefed.result.TestDescription), w której określamy też, kiedy test się rozpoczął, w połączeniu z ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,Map)), aby uzyskać dokładne wyniki.
default void	testStarted(TestDescription test) Raportuje rozpoczęcie pojedynczego testu.

Metody publiczne

testAssumptionFailure

public void testAssumptionFailure (TestDescription test, 
                String trace)

Wywoływany, gdy test atomowy sygnalizuje, że przyjmuje założenie, że warunek jest fałszywy.

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

testAssumptionFailure

public void testAssumptionFailure (TestDescription test, 
                FailureDescription failure)

Wywoływany, gdy test atomowy sygnalizuje, że przyjmuje założenie, że warunek jest fałszywy.

Parametry
test	TestDescription: identyfikuje test
failure	FailureDescription: FailureDescription opisujący błąd i jego kontekst.

testEnded

public void testEnded (TestDescription test, 
                long endTime, 
                 testMetrics)

Alternatywa dla ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map)), gdzie możemy bezpośrednio określić czas zakończenia. Aby uzyskać dokładne pomiary, połącz je z elementem testStarted(com.android.tradefed.result.TestDescription, long).

Parametry
test	TestDescription: identyfikuje test
endTime	long: czas zakończenia testu mierzony za pomocą funkcji System.currentTimeMillis()
testMetrics	: ERROR(/Map) danych wyemitowanych

testEnded

public void testEnded (TestDescription test, 
                 testMetrics)

Raportuje zakończenie wykonywania pojedynczego przypadku testu.

Jeśli funkcja testFailed(TestDescription, FailureDescription) nie została wywołana, test się powiódł. Zwraca też wszystkie dane klucz-wartość, które mogły zostać wyemitowane podczas wykonywania testu.

Parametry
test	TestDescription: identyfikuje test
testMetrics	: ERROR(/Map) danych wyemitowanych

testFailed

public void testFailed (TestDescription test, 
                FailureDescription failure)

Raportuje niepowodzenie pojedynczego przypadku testowego.

Jest wywoływany między testStarted i testEnded.

Parametry
test	TestDescription: identyfikuje test
failure	FailureDescription: FailureDescription opisujący błąd i jego kontekst.

testFailed

public void testFailed (TestDescription test, 
                String trace)

Raportuje niepowodzenie pojedynczego przypadku testowego.

Jest wywoływany między testStarted i testEnded.

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

testIgnored

public void testIgnored (TestDescription test)

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

Parametry
test	TestDescription: identyfikuje test

testRunEnded

public void testRunEnded (long elapsedTimeMillis, 
                 runMetrics)

Raport o zakończeniu testu.

Parametry
elapsedTimeMillis	long: czas upłynął, w milisekundach
runMetrics	: pary klucz-wartość zgłoszone na końcu wykonania testu

testRunFailed

public void testRunFailed (FailureDescription failure)

Nie udało się przeprowadzić testu raportów z powodu błędu opisanego w FailureDescription.

Parametry
failure	FailureDescription: FailureDescription opisujący błąd i jego kontekst.

testRunFailed

public void testRunFailed (String errorMessage)

Nie udało się przeprowadzić testu raportów z powodu krytycznego błędu.

Parametry
errorMessage	String: String opisujący przyczynę niepowodzenia wykonania.

testRunStarted

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

Raport o rozpoczęciu testu.

Parametry
runName	String: nazwa testu
testCount	int: łączna liczba testów w sesji testowej
attemptNumber	int: numer zamówienia, który identyfikuje różne próby tego samego runName, które są wykonywane wielokrotnie. attemptNumber jest indeksowany od 0 i powinien zwiększać się za każdym razem, gdy następuje nowe wykonanie. Przykład: test jest szczegółowo powtarzany 3 razy, więc powinien mieć łącznie 4 wykonania pod tym samym runName, a attemptNumber powinien przyjmować wartości od 0 do 3.

testRunStarted

public void testRunStarted (String runName, 
                int testCount)

Raport o rozpoczęciu testu.

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

testRunStarted

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

Raport o rozpoczęciu testu.

Parametry
runName	String: nazwa testu
testCount	int: łączna liczba testów w sesji testowej
attemptNumber	int: numer zamówienia, który identyfikuje różne próby tego samego runName, które są wykonywane wielokrotnie. attemptNumber ma indeks 0 i powinien zwiększać się za każdym razem, gdy następuje nowe uruchomienie. Przykład: test jest szczegółowo powtarzany 3 razy, więc powinien mieć łącznie 4 uruchomienia pod tym samym runName, a attemptNumber powinien mieć wartość od 0 do 3.
startTime	long: czas rozpoczęcia wykonywania zadania, mierzony za pomocą System.currentTimeMillis()

testRunStopped

public void testRunStopped (long elapsedTime)

Raporty o testach, które zostały przerwane przed zakończeniem na prośbę użytkownika.

TODO: currently unused, consider removing

Parametry
elapsedTime	long: czas upłynął, w milisekundach

testSkipped

public void testSkipped (TestDescription test, 
                SkipReason reason)

Wywoływany, gdy test jest pomijany i nie jest wykonywany z nieoczekiwanego powodu. Te testy zostaną powtórzone, aby sprawdzić, czy tym razem wszystko się uda.

Parametry
test	TestDescription: identyfikuje test
reason	SkipReason: SkipReason

testStarted

public void testStarted (TestDescription test, 
                long startTime)

Alternatywa dla testStarted(com.android.tradefed.result.TestDescription), w której określamy też, kiedy test się rozpoczął, w połączeniu z ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,Map)), aby uzyskać dokładne wyniki.

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

testStarted

public void testStarted (TestDescription test)

Raportuje rozpoczęcie pojedynczego testu. Starszy interfejs, którego należy używać w miarę możliwości w przypadku testStarted(com.android.tradefed.result.TestDescription).

Parametry
test	TestDescription: identyfikuje test