Odbiornik ITest cyklu życia

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 , CollectingTestListener , and 75 others. AggregatePostProcessor Agregator metryk, który podaje minimalną, maksymalną, średnią, wariancję, odchylenie standardowe, sumę, liczbę i opcjonalnie percentyle dla metryk numerycznych zebranych podczas testów wielokrotnych iteracji, traktując je jako podwójne. AtraceCollector IMetricCollector , który uruchamia atrace podczas testu i zbiera wynik i rejestruje je w wywołaniu. AtraceRunMetricCollector Zbiera ślady z całego katalogu testowego w danym katalogu z urządzenia testowego, rejestruje katalog testowy i przetwarza pliki śledzenia w katalogu testowym i agreguje metryki. Średni procesor postów Implementacja postprocesora obliczającego średnią z listy metryk. BaseDeviceMetricCollector Podstawowa implementacja IMetricCollector , która pozwala na uruchamianie i zatrzymywanie zbierania na onTestRunStart(com.android.tradefed.device.metric.DeviceMetricData) i ERROR(/#onTestRunEnd(com.android.tradefed.device.metric.DeviceMetricData,Map)) . Procesor BasePost Podstawowy IPostProcessor , który powinna rozszerzać każda implementacja. BluetoothConnectionLatencyCollector Moduł zbierający wypchnie do urządzeń wstępnie zdefiniowaną konfigurację metryki czasu trwania statsd i zbierze czas trwania połączenia Bluetooth dla każdego profilu. BluetoothConnectionStateCollector Ten kolektor będzie zbierał metryki BluetoothConnectionStateChanged i rejestrował numer stanu połączenia dla każdego profilu. BluetoothConnectionSuccessRatePostProcessor Implementacja postprocesora obliczającego wskaźnik sukcesu dla profilu bluetooth Użyj „metric-key-match”, aby określić metryki, które zawierają stany połączenia Bluetooth w tablicy numerycznej Przykład [0, 1, 2, 3, 0, 1, 2, 3]. BluetoothHciSnoopLogCollector Collector, aby włączyć rejestrowanie funkcji Bluetooth HCI snoop na badanym urządzeniu i zbierać dzienniki dla każdego testu. BugreportCollector Przekazujący obiekt ITestInvocationListener , który zbiera raporty o błędach, gdy wystąpią konfigurowalne zdarzenia, a następnie wywołuje ITestInvocationListener#testLog na swoich elementach podrzędnych po zebraniu każdego raportu o błędzie. BugreportzOnFailureCollector Zbierz raport o błędzie, gdy przypadek testowy zakończy się niepowodzeniem. BugreportzOnTestCaseFailureCollector Zbierz raport o błędzie, gdy przypadek testowy w przebiegu zakończy się niepowodzeniem. ClangCodeCoverageCollector BaseDeviceMetricCollector , który pobiera pomiary pokrycia Clang z urządzenia i rejestruje je jako artefakty testowe. ZbieranieTestListener ITestInvocationListener , który zbierze wszystkie wyniki testów. CommandStatusHandler Program obsługi pomagający monitorować i aktualizować stan wywołania. Stan awariiMonitor Monitoruj wszelkie błędy wywołania. Reporter wyników konsoli Reporter wyników do drukowania wyników testu na konsoli. CountTestCasesCollector Policz i zgłoś liczbę przypadków testowych dla danego IRemoteTest . Odbiornik wyników testu zliczania TestResultListener , który śledzi całkowitą liczbę testów według TestStatus DebugHostLogOnFailureCollector Kolektor, który będzie gromadzić i rejestrować dzienniki po stronie hosta, gdy wystąpi awaria przypadku testowego. DeviceReleaseReporter Reporter wydania urządzenia, który obsługuje komunikację z procesem nadrzędnym urządzenia, które ma zostać zwolnione. DeviceTraceCollector Kolektor, który rozpocznie śledzenie perfetto po uruchomieniu testu i zapisze plik śledzenia na końcu. Device UnavailableMonitor Ten odbiornik próbuje przechwycić tylko DNAE na poziomie przypadku testowego. EventsLoggerListener Odbiornik, który rejestruje wszystkie otrzymane zdarzenia w pliku FileProtoResultReporter Proto reporter, który zrzuca TestRecord do pliku. FilePullerDeviceMetricCollector BaseDeviceMetricCollector , który nasłuchuje klucza metryk pochodzącego z urządzenia i pobiera je jako plik z urządzenia. FilePullerLogCollector Logger pliku zgłoszonego po stronie urządzenia. FilteredResultForwarder Wariant ResultForwarder , który umożliwia zgłaszanie tylko listy dozwolonych TestDescription . FormattedGeneratorReporter Reporter umożliwiający generowanie raportów w określonym formacie. GcovCodeCoverageCollector BaseDeviceMetricCollector , który pobiera pomiary pokrycia gcov z urządzenia i rejestruje je jako artefakty testowe. GcovKernelCodeCoverageCollector BaseDeviceMetricCollector , który wyciągnie pomiary pokrycia jądra gcov z debugfs i poza urządzenie, a następnie w końcu zarejestruje je jako artefakty testowe. GranularRetriableTestWrapper.StartEndCollector Pomocnik klasy, aby złapać brakujący początek i koniec biegu. HostStatsdMetricCollector IMetricCollector , który zbiera metryki statsd ze strony hosta za pomocą poleceń narzędzia statsd. ICommandScheduler.IScheduledInvocationListener Odbiornik zdarzeń wywołania po zakończeniu wywołania. ILogSaverListener Umożliwia ITestInvocationListener s nasłuchiwanie, kiedy pliki dziennika są zapisywane. IMetricCollector Ten interfejs zostanie dodany jako dekorator podczas raportowania wyników testów w celu zebrania pasujących metryk. IPostProcessor Postprocesory to obiekt Federacji Handlowej, który ma umożliwić przetwarzanie metryk i logów PO testach i PRZED raportowaniem wyników. IShardableListener ITestInvocationListener , który można podzielić na fragmenty. ISupportSzczegółowe wyniki Interfejs określający, czy ITestInvocationListener obsługuje odbieranie szczegółowych wyników, czy nie. ITestInvocationListener Odbiornik wyników testu z wywołania testowego. ITestSummaryListener Interfejs, który umożliwia ITestInvocationListener wymianę pewnych ograniczonych informacji za pośrednictwem podsumowań. InvocationToJUnitResultForwarder Klasa, która nasłuchuje zdarzeń ITestInvocationListener i przekazuje je do TestListener . JarHostTest.HostTestListener Odbiornik opakowujący, który przekazuje wszystkie zdarzenia poza testRunStarted() i testRunEnded() do wbudowanego odbiornika. JavaCodeCoverageCollector BaseDeviceMetricCollector , który pobiera pomiary pokrycia Java z urządzenia i rejestruje je jako artefakty testowe. JsonHttpTestResultReporter Reporter wyników, który koduje wyniki i rozgałęzienia metryk testowych, informacje o urządzeniu w formacie JSON i POST w punkcie końcowym usługi HTTP LastShardDetector Podczas uruchamiania lokalnego shardingu czasami chcemy wykonać niektóre akcje tylko wtedy, gdy ostatni shard osiągnie invocationEnded(long) . LegacySubprocessResultsReporter Zamrożona implementacja raportującego wyniki podprocesu, która powinna pozostać kompatybilna z wcześniejszymi wersjami TF/CTS (np. 8+), pomimo zmian w swojej nadklasie. LogSaverResultForwarder ResultForwarder do zapisywania dzienników z globalnym oszczędzaniem plików. LogcatCrashResultForwarder Specjalny detektor: w przypadku awarii (awaria procesu oprzyrządowania) spróbuje wyodrębnić z logcata awarię i doda ją do komunikatu o awarii związanego z testem. LogcatOnFailureCollector Kolektor, który przechwyci i zarejestruje logcat, gdy przypadek testowy zakończy się niepowodzeniem. LogcatTimingMetricCollector Zbieracz metryk, który zbiera informacje o czasie (np. czas przełączenia użytkownika) z logcat podczas jednego lub wielu powtarzanych testów, używając podanych wzorców wyrażeń regularnych do analizowania sygnałów początku i końca zdarzenia z linii logcat. MetricFilePostProcessor Służy do przesyłania pliku dziennika metryk zebranego podczas poziomu testu i uruchomienia. MetricsXMLResultReporter MetricsXMLResultReporter zapisuje metryki testowe i uruchamia metryki do pliku XML w folderze określonym przez parametr metrics-folder w fazie invocationEnded testu. Słuchacz modułu Listener dołączony do każdego IRemoteTest każdego modułu w celu zebrania listy wyników. ModułLogcatCollector Wersja kolektora logcat, ale dla modułu. NazwaMangleListener Odbiornik proxy do tłumaczenia metod testowych, klas i nazw pakietów w miarę raportowania wyników. PassingTestFileReporter ITestInvocationListener , który zapisuje listę pomyślnych przypadków testowych w pliku testowym PerfettoGenericPostProcessor Postprocesor, który przetwarza tekstowy/binarny metryczny perfetto plik proto na pary klucz-wartość poprzez rekurencyjne rozszerzanie proto komunikatów i pól o wartości łańcuchowe, aż do napotkania pola z wartością liczbową. PerfettoPullerMetricCollector Podstawowa implementacja FilePullerDeviceMetricCollector , która umożliwia ściąganie plików perfetto z urządzenia i zbieranie z niego metryk. PrettyTestEventLogger Logger dopasowujący zdarzenia i rejestrujący je w celu ułatwienia debugowania. ProtoResultReporter Reporter wyników tworzy protobuf TestRecord ze wszystkimi wynikami w środku. PythonBinaryHostTest.PythonForwarder Przekazywanie wyników w celu zastąpienia nazwy przebiegu nazwą binarną. RebootReasonCollector Kolektor, który zbiera informacje o ponownym uruchomieniu urządzenia podczas testu i zgłasza je według przyczyny i liczby. RemoteTestTimeOutEnforcer Odbiorniki, które pozwalają sprawdzić czas wykonania danej konfiguracji testowej i zakończyć ją niepowodzeniem, jeśli przekroczy określony limit czasu. RaportZdane testy Zgłoś w pliku możliwe filtry wykluczające zdany test. Agregator wyników Specjalny forwarder, który agreguje wyniki w razie potrzeby, w oparciu o przyjętą strategię ponawiania prób. ResultAndLogForwarder Forwarder wyników i dzienników zdarzeń. ResultForwarder ITestInvocationListener , który przekazuje wyniki wywołania do listy innych odbiorników. RetryLogSaverResultForwarder Forwarder, który obsługuje również przekazanie bieżącej próby, w której się znajdujemy. RetryResultForwarder Rozszerzenie ResultForwarder , które zawsze naciska na podany numer próby. RuntimeRestartCollector Kolektor, który zbiera sygnatury czasowe ponownych uruchomień środowiska uruchomieniowego (awarie serwera systemowego) podczas testu, jeśli takie istnieją. Zrzut ekranu OnFailureCollector Kolektor, który przechwyci i zarejestruje zrzut ekranu, gdy przypadek testowy zakończy się niepowodzeniem. ShardListener ITestInvocationListener , który zbiera wyniki z fragmentu wywołania (znanego również jako podział wywołania do uruchamiania na wielu zasobach równolegle) i przekazuje je do innego odbiornika. ShardMainResultForwarder ResultForwarder , który łączy wyniki wywołań testowych podzielonych na fragmenty. ShowmapPullerMetricCollector Podstawowa implementacja FilePullerDeviceMetricCollector , która umożliwia ściąganie plików showmap z urządzenia i zbieranie z niego metryk. StatsdBeforeAfterGaugeMetricPostProcessor Postprocesor, który przetwarza metryki mierników zebrane w podejściu „przed/po”, tj StatsdEventMetricPostProcessor Postprocesor, który przetwarza metryki zdarzeń w raportach statsd na pary klucz-wartość, używając elementów formatujących określonych w procesorze. StatsdGenericPostProcessor Postprocesor, który przetwarza binarne raporty proto statsd na pary klucz-wartość, rozwijając raport jako strukturę drzewa. StreamProtoResultReporter Implementacja ProtoResultReporter SubprocessResultsReporter Implementuje ITestInvocationListener do określenia jako result_reporter i przekazuje z podprocesu wyniki testów, przebiegów testowych, wywołań testowych. SuiteResultReporter Zbierz wyniki testów dla całego wywołania zestawu i wyślij wyniki końcowe. Odbiornik testu niepowodzenia Odbiornik wykonywał na żądanie działania, takie jak zrzut ekranu, raport o błędzie, zbieranie logcatów po niepowodzeniu testu. Odbiornik wyników testu Uproszczenie ITestLifecycleListener dla wdrożeniowców, którym zależy tylko na indywidualnych wynikach testów. TestTimeoutEnforcer Listenery, które pozwalają sprawdzić czas wykonania danego przypadku testowego i zakończyć go niepowodzeniem, jeśli przekroczy określony limit czasu. TextResultReporter Reporter wyników testów, który przekazuje wyniki do drukarki wyników tekstowych JUnit. TraceCmdCollector IMetricCollector , który zbiera ślady podczas testu przy użyciu trace-cmd i rejestruje je w wywołaniu. TradefedSandboxRunner.StubScheduledInvocationListener Stub IScheduledInvocationListener , który nic nie robi. XmlFormattedGeneratorReporter Implementacja FormattedGeneratorReporter , która formatuje pakiet, daje w wyniku format xml. XmlResultReporter Zapisuje wyniki JUnit do plików XML w formacie zgodnym z XMLJUnitResultFormatter Anta.

---

Odbiera powiadomienia o zdarzeniach podczas testów oprzyrządowania.

Wzorowany na org.junit.runner.notification.RunListener

Sekwencja połączeń będzie następująca:

• testRunStarted
• testRozpoczęty
• [Test nieudany]
• [założenie testu nie powiodło się]
• [test zignorowany]
• test zakończony
• ....
• [uruchomienie testu nie powiodło się]
• testRunEnded

Streszczenie

Metody publiczne
default void	testAssumptionFailure ( TestDescription test, String trace) Wywoływana, gdy test atomowy oznacza, że ​​zakłada warunek, który jest fałszywy
default void	testAssumptionFailure ( TestDescription test, FailureDescription failure) Wywoływana, gdy test atomowy oznacza, że ​​zakłada warunek, który jest fałszywy
default void	testEnded ( TestDescription test, long endTime, testMetrics) 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) testEnded ( TestDescription test, testMetrics) Zgłasza koniec wykonania pojedynczego przypadku testowego.
default void	testFailed ( TestDescription test, FailureDescription failure) Zgłasza awarię pojedynczego przypadku testowego.
default void	testFailed ( TestDescription test, String trace) Zgłasza awarię pojedynczego przypadku testowego.
default void	testIgnored ( TestDescription test) Wywoływana, gdy test nie zostanie uruchomiony, zwykle dlatego, że metoda testowa ma adnotację org.junit.Ignore.
default void	testRunEnded (long elapsedTimeMillis, runMetrics) testRunEnded (long elapsedTimeMillis, runMetrics) Zgłasza koniec przebiegu testowego.
default void	testRunFailed ( FailureDescription failure) Przebieg testu raportów nie został ukończony z powodu błędu opisanego przez FailureDescription .
default void	testRunFailed (String errorMessage) Testowanie raportów nie zostało ukończone z powodu błędu krytycznego.
default void	testRunStarted (String runName, int testCount, int attemptNumber) Zgłasza początek przebiegu testowego.
default void	testRunStarted (String runName, int testCount) Zgłasza początek przebiegu testowego.
default void	testRunStarted (String runName, int testCount, int attemptNumber, long startTime) Zgłasza początek przebiegu testowego.
default void	testRunStopped (long elapsedTime) Przebieg testu raportów został zatrzymany przed zakończeniem z powodu żądania użytkownika.
default void	testStarted ( TestDescription test, long startTime) Alternatywa dla testStarted(com.android.tradefed.result.TestDescription) , gdzie również określamy kiedy test został uruchomiony, w połączeniu z ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,Map)) dla dokładnego pomiaru .
default void	testStarted ( TestDescription test) Raportuje początek pojedynczego przypadku testowego.

Metody publiczne

testZałożenieNiepowodzenie

public void testAssumptionFailure (TestDescription test, 
                String trace)

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

Parametry
test	TestDescription : identyfikuje test
trace	String : ślad stosu awarii

testZałożenieNiepowodzenie

public void testAssumptionFailure (TestDescription test, 
                FailureDescription failure)

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

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

test zakończony

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. Połącz z testStarted(com.android.tradefed.result.TestDescription, long) , aby uzyskać dokładny pomiar.

Parametry
test	TestDescription : identyfikuje test
endTime	long : czas zakończenia testu, mierzony za pomocą ERROR(/System#currentTimeMillis())
testMetrics	: ERROR(/Map) emitowanych metryk

test zakończony

public void testEnded (TestDescription test, 
                 testMetrics)

Zgłasza koniec wykonania pojedynczego przypadku testowego.

Jeśli testFailed(TestDescription, FailureDescription) nie został wywołany, ten test zakończył się pomyślnie. Zwraca również wszelkie metryki klucza/wartości, które mogły zostać wyemitowane podczas wykonywania przypadku testowego.

Parametry
test	TestDescription : identyfikuje test
testMetrics	: ERROR(/Map) emitowanych metryk

Test nieudany

public void testFailed (TestDescription test, 
                FailureDescription failure)

Zgłasza awarię pojedynczego przypadku testowego.

Zostanie wywołany między testStarted a testEnded.

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

Test nieudany

public void testFailed (TestDescription test, 
                String trace)

Zgłasza awarię pojedynczego przypadku testowego.

Zostanie wywołany między testStarted a testEnded.

Parametry
test	TestDescription : identyfikuje test
trace	String : ślad stosu awarii

zignorowano test

public void testIgnored (TestDescription test)

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

Parametry
test	TestDescription : identyfikuje test

testRunEnded

public void testRunEnded (long elapsedTimeMillis, 
                 runMetrics)

Zgłasza koniec przebiegu testowego. FIXME: Nie możemy mieć dwóch różnych interfejsów Map<>, więc musimy tutaj użyć HashMap.

Parametry
elapsedTimeMillis	long : czas, który upłynął od urządzenia, w milisekundach
runMetrics	: pary klucz-wartość zgłaszane na koniec przebiegu testu z Metric .

testRunNie powiodło się

public void testRunFailed (FailureDescription failure)

Przebieg testu raportów nie został ukończony z powodu błędu opisanego przez FailureDescription .

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

testRunNie powiodło się

public void testRunFailed (String errorMessage)

Testowanie raportów nie zostało ukończone z powodu błędu krytycznego.

Parametry
errorMessage	String : ERROR(/String) opisujący przyczynę niepowodzenia uruchomienia.

testRunStarted

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

Zgłasza początek przebiegu testowego.

Parametry
runName	String : nazwa uruchomienia testu
testCount	int : całkowita liczba testów w przebiegu testu
attemptNumber	int : numer zamówienia, identyfikujący różne próby tej samej nazwy runName, które są uruchamiane wiele razy. PróbaNumber jest indeksowana 0 i powinna zwiększać się za każdym razem, gdy nastąpi nowe uruchomienie. np. test jest ponawiany 3 razy w trybie granularnym, powinien mieć łącznie 4 przebiegi pod tą samą nazwą uruchomienia, a numer próby wynosi od 0 do 3.

testRunStarted

public void testRunStarted (String runName, 
                int testCount)

Zgłasza początek przebiegu testowego.

Parametry
runName	String : nazwa uruchomienia testu
testCount	int : całkowita liczba testów w przebiegu testu

testRunStarted

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

Zgłasza początek przebiegu testowego.

Parametry
runName	String : nazwa uruchomienia testu
testCount	int : całkowita liczba testów w przebiegu testu
attemptNumber	int : numer zamówienia, identyfikujący różne próby tej samej nazwy runName, które są uruchamiane wiele razy. PróbaNumber jest indeksowana 0 i powinna zwiększać się za każdym razem, gdy nastąpi nowe uruchomienie. np. test jest ponawiany 3 razy w trybie granularnym, powinien mieć łącznie 4 przebiegi pod tą samą nazwą uruchomienia, a numer próby wynosi od 0 do 3.
startTime	long : czas rozpoczęcia przebiegu, mierzony za pomocą ERROR(/System#currentTimeMillis())

testRunZatrzymany

public void testRunStopped (long elapsedTime)

Przebieg testu raportów został zatrzymany przed zakończeniem z powodu żądania użytkownika.

DO ZROBIENIA: obecnie nieużywane, rozważ usunięcie

Parametry
elapsedTime	long : czas, który upłynął od urządzenia, w milisekundach

testRozpoczęty

public void testStarted (TestDescription test, 
                long startTime)

Alternatywa dla testStarted(com.android.tradefed.result.TestDescription) , gdzie również określamy kiedy test został uruchomiony, w połączeniu z ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,Map)) dla dokładnego pomiaru .

Parametry
test	TestDescription : identyfikuje test
startTime	long : czas rozpoczęcia testu, mierzony za pomocą ERROR(/System#currentTimeMillis())

testRozpoczęty

public void testStarted (TestDescription test)

Raportuje początek pojedynczego przypadku testowego. Starszy interfejs powinien używać testStarted(com.android.tradefed.result.TestDescription) gdy tylko jest to możliwe.

Parametry
test	TestDescription : identyfikuje test