ILogSaverListener

public interface ILogSaverListener
implements ITestInvocationListener

com.android.tradefed.result.ILogSaverListener

Znane podklasy pośrednie AggregatePostProcessor , AtraceCollector , AtraceRunMetricCollector , AveragePostProcessor , BaseDeviceMetricCollector , BasePostProcessor , BluetoothConnectionLatencyCollector , BluetoothConnectionStateCollector , BluetoothConnectionSuccessRatePostProcessor , BluetoothHciSnoopLogCollector , BugreportzOnFailureCollector , Bugre portzOnTestCaseFailureCollector , ClangCodeCoverageCollector , CollectingTestListener , ConsoleResultReporter i 47 innych. 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. 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. 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 . DebugHostLogOnFailureCollector Kolektor, który będzie gromadzić i rejestrować dzienniki po stronie hosta, gdy wystąpi awaria przypadku testowego. DeviceTraceCollector Kolektor, który rozpocznie śledzenie perfetto po uruchomieniu testu i zapisze plik śledzenia na końcu. 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. 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. 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. 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 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. 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. 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. ProtoResultReporter Reporter wyników tworzy protobuf TestRecord ze wszystkimi wynikami w środku. RebootReasonCollector Kolektor, który zbiera informacje o ponownym uruchomieniu urządzenia podczas testu i zgłasza je według przyczyny i liczby. 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ń. RetryLogSaverResultForwarder Forwarder, który obsługuje również przekazanie bieżącej próby, w której się znajdujemy. 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. 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. 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.

---

Umożliwia ITestInvocationListener s nasłuchiwanie, kiedy pliki dziennika są zapisywane.

Dzięki temu wiele ITestInvocationListener może używać tego samego zapisanego pliku dziennika podczas generowania raportów i uniknąć sytuacji, w której każdy odbiornik zapisuje plik indywidualnie, gdy ITestLogger.testLog(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource) jest wywoływana.

Klasy implementujące ten interfejs powinny mieć świadomość, że testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile) będzie wywoływany za każdym razem, gdy ITestLogger.testLog(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource) jest wywoływany.

Ta klasa przekazuje również globalne wystąpienie ILogSaver , dzięki czemu ITestInvocationListener s może zapisywać dodatkowe pliki w tej samej lokalizacji.

Streszczenie

Metody publiczne
default void	logAssociation (String dataName, LogFile logFile) W niektórych przypadkach log musi być silnie powiązany z przypadkami testowymi, ale możliwość zrobienia tego na bezpośrednim testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile) wywołanie zwrotne nie jest możliwe.
default void	setLogSaver ( ILogSaver logSaver) Ustaw ILogSaver , aby umożliwić implementatorowi zapisywanie plików.
default void	testLogSaved (String dataName, LogDataType dataType, InputStreamSource dataStream, LogFile logFile) Wywoływana, gdy zapisywany jest dziennik testu.

Metody publiczne

logAssociation

public void logAssociation (String dataName, 
                LogFile logFile)

W niektórych przypadkach log musi być silnie powiązany z przypadkami testowymi, ale możliwość zrobienia tego na bezpośrednim testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile) wywołanie zwrotne nie jest możliwe. Zatem to wywołanie zwrotne pozwala jawnie zapewnić silne powiązanie.

Parametry
dataName	String : nazwa danych
logFile	LogFile : LogFile , który był wcześniej rejestrowany i powinien być powiązany z przypadkiem testowym.

ustawLogSaver

public void setLogSaver (ILogSaver logSaver)

Ustaw ILogSaver , aby umożliwić implementatorowi zapisywanie plików.

Parametry
logSaver	ILogSaver : ILogSaver

testLogZapisano

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

Wywoływana, gdy zapisywany jest dziennik testu.

Powinien być używany zamiast ITestInvocationListener#testLog(String, LogDataType, InputStreamSource) .

Parametry
dataName	String : opisowa nazwa String danych. np. „device_logcat”. Uwaga dataName może nie być unikatowa na wywołanie. tj. realizatorzy muszą być w stanie obsłużyć wiele wywołań z tą samą nazwą danych
dataType	LogDataType : LogDataType danych
dataStream	InputStreamSource : InputStreamSource danych. Implementatorzy powinni wywoływać metodę createInputStream, aby rozpocząć odczytywanie danych, i upewnić się, że wynikowy InputStream zostanie zamknięty po zakończeniu.
logFile	LogFile : LogFile zawierający metadane zapisanego pliku.