ITestLifeCycleReceiver

public interface ITestLifeCycleReceiver

com.android.tradefed.result.ITestLifeCycleReceiver

Bekannte indirekte Unterklassen AggregatePostProcessor , AtraceCollector , AtraceRunMetricCollector , AveragePostProcessor , BaseDeviceMetricCollector , BasePostProcessor , BluetoothConnectionLatencyCollector , BluetoothConnectionStateCollector , BluetoothConnectionSuccessRatePostProcessor , BluetoothHciSnoopLogCollector , BugreportCollector , BugreportzOnFailureCollector , BugreportzOnTestCaseFailureCollector , ClangCode , Collector TestCoverage7 , andere. AggregatePostProcessor Ein Metrikaggregator, der Min, Max, Mittelwert, Varianz, Standardabweichung, Summe, Anzahl und optional Perzentile für numerische Metriken angibt, die während Testläufen mit mehreren Iterationen erfasst wurden, und sie als Doubles behandelt. AtraceCollector Ein IMetricCollector , der während eines Tests Atrace ausführt und das Ergebnis sammelt und beim Aufruf protokolliert. AtraceRunMetricCollector Sammelt die Ablaufverfolgungen aus allen Testverzeichnissen unter dem angegebenen Verzeichnis vom Testgerät, protokolliert das Testverzeichnis und verarbeitet die Ablaufverfolgungsdateien unter dem Testverzeichnis nach und aggregiert die Metriken. AveragePostProcessor Implementierung eines Postprozessors, der den Durchschnitt der Liste der Metriken berechnet. BaseDeviceMetricCollector Basisimplementierung von IMetricCollector , die es ermöglicht, die Erfassung auf onTestRunStart(com.android.tradefed.device.metric.DeviceMetricData) und ERROR(/#onTestRunEnd(com.android.tradefed.device.metric.DeviceMetricData,Map)) zu starten und zu stoppen. BasePostProcessor Der Basis IPostProcessor , den jede Implementierung erweitern sollte. BluetoothConnectionLatencyCollector Der Collector überträgt eine vordefinierte statsd-Dauermetrikkonfiguration auf Geräte und erfasst die Bluetooth-Verbindungsdauer für jedes Profil. BluetoothConnectionStateCollector Dieser Kollektor sammelt BluetoothConnectionStateChanged-Metriken und zeichnet die Verbindungsstatusnummer für jedes Profil auf. BluetoothConnectionSuccessRatePostProcessor Implementierung eines Postprozessors, der die Erfolgsrate für ein Bluetooth-Profil berechnet Verwenden Sie „metric-key-match“, um Metriken anzugeben, die Bluetooth-Verbindungszustände in einem numerischen Array enthalten Beispiel [0, 1, 2, 3, 0, 1, 2, 3]. BluetoothHciSnoopLogCollector Collector zum Aktivieren der Bluetooth-HCI-Snoop-Protokollierung auf dem DUT und zum Sammeln des Protokolls für jeden Test. BugreportCollector Ein Pass-Through- ITestInvocationListener , der Fehlerberichte sammelt, wenn konfigurierbare Ereignisse auftreten, und dann ITestInvocationListener#testLog für seine untergeordneten Elemente aufruft, nachdem jeder Fehlerbericht gesammelt wurde. FehlerberichtzOnFailureCollector Sammeln Sie einen Bugreportz, wenn ein Testfall fehlschlägt. FehlerberichtzOnTestCaseFailureCollector Sammeln Sie einen Bugreportz, wenn ein Testfall in einem Lauf fehlschlägt. ClangCodeCoverageCollector Ein BaseDeviceMetricCollector , der Clang-Abdeckungsmessungen vom Gerät abruft und sie als Testartefakte protokolliert. CollectingTestListener Ein ITestInvocationListener , der alle Testergebnisse sammelt. CommandStatusHandler Handler, der hilft, den Status eines Aufrufs zu überwachen und zu aktualisieren. ConditionFailureMonitor Überwachen Sie den Aufruf auf Fehler. ConsoleResultReporter Ergebnisreporter zum Drucken der Testergebnisse auf der Konsole. CountTestCasesCollector Zählen und melden Sie die Anzahl der Testfälle für einen bestimmten IRemoteTest . CountingTestResultListener Ein TestResultListener , der die Gesamtzahl der Tests nach TestStatus verfolgt DebugHostLogOnFailureCollector Collector, der die hostseitigen Protokolle sammelt und protokolliert, wenn ein Testfallfehler auftritt. DeviceReleaseReporter Gerätefreigabe-Melder, der die Kommunikation der freizugebenden Geräte mit dem übergeordneten Prozess handhabt. DeviceTraceCollector Collector, der beim Start eines Testlaufs eine Perfetto-Ablaufverfolgung startet und am Ende eine Ablaufverfolgungsdatei protokolliert. DeviceUnavailableMonitor Dieser Listener versucht, nur eine DNAE auf Testfallebene zu erfassen. EventsLoggerListener Listener, der alle empfangenen Ereignisse in einer Datei protokolliert FileProtoResultReporter Proto-Reporter, der den TestRecord in eine Datei ausgibt. FilePullerDeviceMetricCollector Ein BaseDeviceMetricCollector , der auf Metrikschlüssel lauscht, die vom Gerät kommen, und sie als Datei vom Gerät abruft. FilePullerLogCollector Logger der geräteseitig gemeldeten Datei. FilteredResultForwarder Variante von ResultForwarder , die nur die Meldung einer Zulassungsliste von TestDescription zulässt. FormatierterGeneratorReporter Reporter, mit dem Berichte in einem bestimmten Format erstellt werden können. GcovCodeCoverageCollector Ein BaseDeviceMetricCollector , der gcov-Abdeckungsmessungen vom Gerät abruft und sie als Testartefakte protokolliert. GcovKernelCodeCoverageCollector Ein BaseDeviceMetricCollector , der Messungen der gcov-Kernelabdeckung aus debugfs und vom Gerät zieht und sie schließlich als Testartefakte protokolliert. GranularRetriableTestWrapper.StartEndCollector Klassenhelfer zum Erfassen fehlender Laufstarts und -endes. HostStatsdMetricCollector Ein IMetricCollector , der statsd-Metriken von der Hostseite mithilfe von statsd-Dienstprogrammbefehlen sammelt. ICommandScheduler.IScheduledInvocationListener Listener für Aufrufereignisse, wenn der Aufruf abgeschlossen ist. ILogSaverListener Ermöglicht ITestInvocationListener s zu lauschen, wenn Protokolldateien gespeichert werden. IMetricCollector Diese Schnittstelle wird als Decorator hinzugefügt, wenn Testergebnisse gemeldet werden, um übereinstimmende Metriken zu sammeln. IPostProcessor Postprozessoren sind ein Trade Federation-Objekt, das die Verarbeitung von Metriken und Protokollen NACH den Tests und VOR der Ergebnisberichterstattung ermöglichen soll. IShardableListener Ein ITestInvocationListener , der fragmentiert werden kann. ISupportGranularResults Schnittstelle, die angibt, ob ein ITestInvocationListener den Empfang der granularen Ergebnisse unterstützt oder nicht. ITestInvocationListener Listener für Testergebnisse aus dem Testaufruf. ITestSummaryListener Schnittstelle, die es ITestInvocationListener ermöglicht, einige begrenzte Informationen über Zusammenfassungen auszutauschen. InvocationToJUnitResultForwarder Eine Klasse, die auf ITestInvocationListener Ereignisse lauscht und sie an einen TestListener weiterleitet. JarHostTest.HostTestListener Wrapper-Listener, der alle Ereignisse außer testRunStarted() und testRunEnded() an den eingebetteten Listener weiterleitet. JavaCodeCoverageCollector Ein BaseDeviceMetricCollector , der Messungen der Java-Abdeckung vom Gerät abruft und sie als Testartefakte protokolliert. JsonHttpTestResultReporter Ein Ergebnisreporter, der die Ergebnisse von Testmetriken codiert und Geräteinformationen in JSON und POST in einen HTTP-Dienstendpunkt verzweigt LastShardDetector Beim Ausführen von lokalem Sharding möchten wir manchmal nur einige Aktionen ausführen, wenn der letzte Shard invocationEnded(long) erreicht. LegacySubprocessResultsReporter Eine eingefrorene Implementierung des Teilprozess-Ergebnisreporters, die trotz Änderungen in ihrer Oberklasse mit früheren Versionen von TF/CTS (zB 8+) kompatibel bleiben sollte. LogSaverResultForwarder Ein ResultForwarder zum Speichern von Protokollen mit dem globalen Dateischoner. LogcatCrashResultForwarder Spezieller Listener: Bei Fehlern (Absturz des Instrumentierungsprozesses) versucht er, den Absturz aus dem Logcat zu extrahieren und fügt ihn der Fehlermeldung hinzu, die dem Test zugeordnet ist. LogcatOnFailureCollector Collector, der ein Logcat erfasst und protokolliert, wenn ein Testfall fehlschlägt. LogcatTimingMetricCollector Ein Metriksammler, der Zeitinformationen (z. B. Benutzerwechselzeit) von Logcat während eines oder mehrerer wiederholter Tests sammelt, indem er bestimmte Regex-Muster verwendet, um Start- und Endsignale eines Ereignisses aus Logcat-Zeilen zu analysieren. MetricFilePostProcessor Wird zum Hochladen der Metrikprotokolldatei verwendet, die während der Test- und Laufebene gesammelt wurde. MetrikenXMLResultReporter MetricsXMLResultReporter schreibt Testmetriken und Ausführungsmetriken in eine XML-Datei in einem Ordner, der durch den metrics-folder-Parameter in der invocationEnded-Phase des Tests angegeben wird. ModulListener Listener, der an jeden IRemoteTest jedes Moduls angehängt ist, um die Ergebnisliste zu sammeln. ModulLogcatCollector Version des Logcat-Kollektors, aber für das Modul. NameMangleListener Ein Proxy-Listener zum Übersetzen von Testmethoden-, Klassen- und Paketnamen, wenn Ergebnisse gemeldet werden. PassingTestFileReporter Ein ITestInvocationListener , der die Liste der bestandenen Testfälle in einer Testdatei speichert PerfettoGenericPostProcessor Ein Postprozessor, der Text-/Binärmetrik-Perfetto-Proto-Dateien in Schlüssel-Wert-Paare verarbeitet, indem die Proto-Nachrichten und -Felder rekursiv mit Zeichenfolgenwerten erweitert werden, bis das Feld mit dem numerischen Wert gefunden wird. PerfettoPullerMetricCollector Basisimplementierung von FilePullerDeviceMetricCollector , die es ermöglicht, die Perfetto-Dateien vom Gerät abzurufen und die Metriken daraus zu sammeln. PrettyTestEventLogger Logger, der die Ereignisse abgleicht und sie protokolliert, um das Debuggen zu erleichtern. ProtoResultReporter Der Ergebnisreporter erstellt ein TestRecord Protobuf mit allen darin enthaltenen Ergebnissen. PythonBinaryHostTest.PythonForwarder Ergebnisweiterleitung zum Ersetzen des Ausführungsnamens durch den Binärnamen. RebootReasonCollector Collector, der den Neustart des Geräts während des Testlaufs erfasst und nach Grund und Anzahl meldet. RemoteTestTimeOutEnforcer Listener, die es ermöglichen, die Ausführungszeit einer bestimmten Testkonfiguration zu überprüfen und sie fehlschlagen zu lassen, wenn sie ein bestimmtes Timeout überschreitet. Melden Sie bestandene Tests Melden Sie in einer Datei mögliche Filter, um bestandene Tests auszuschließen. ErgebnisAggregator Spezieller Forwarder, der die Ergebnisse bei Bedarf basierend auf der verwendeten Wiederholungsstrategie aggregiert. ErgebnisAndLogForwarder Weiterleitung für Ergebnisse und Protokollereignisse. ErgebnisForwarder Ein ITestInvocationListener , der Aufrufergebnisse an eine Liste anderer Listener weiterleitet. RetryLogSaverResultForwarder Spediteur, der auch den aktuellen Versuch übernimmt, bei dem wir uns befinden. RetryResultForwarder Eine Erweiterung von ResultForwarder , die immer zu einer bestimmten Versuchsnummer pusht. RuntimeRestartCollector Collector, der Zeitstempel von Laufzeitneustarts (Systemserverabstürze) während des Testlaufs sammelt, falls vorhanden. ScreenshotOnFailureCollector Collector, der einen Screenshot erfasst und protokolliert, wenn ein Testfall fehlschlägt. ShardListener Ein ITestInvocationListener , der Ergebnisse von einem Aufruf-Shard (auch bekannt als Aufrufaufteilung zur parallelen Ausführung auf mehreren Ressourcen) erfasst und sie an einen anderen Listener weiterleitet. ShardMainResultForwarder Ein ResultForwarder , der die Ergebnisse von Sharding-Testaufrufen kombiniert. ShowmapPullerMetricCollector Basisimplementierung von FilePullerDeviceMetricCollector , die es ermöglicht, die Showmap-Dateien vom Gerät abzurufen und die Metriken davon zu sammeln. StatsdBeforeAfterGaugeMetricPostProcessor Ein Postprozessor, der Messwerte verarbeitet, die in einem „Vorher/Nachher“-Ansatz gesammelt wurden, d. h StatsdEventMetricPostProcessor Ein Postprozessor, der Ereignismetriken in statsd-Berichten in Schlüssel-Wert-Paare verarbeitet, wobei die auf dem Prozessor angegebenen Formatierer verwendet werden. StatsdGenericPostProcessor Ein Postprozessor, der binäre proto statsd-Berichte in Schlüssel-Wert-Paare verarbeitet, indem der Bericht als Baumstruktur erweitert wird. StreamProtoResultReporter Eine Implementierung von ProtoResultReporter SubprocessResultsReporter Implementiert ITestInvocationListener , der als result_reporter angegeben werden soll und vom Unterprozess die Ergebnisse von Tests, Testläufen und Testaufrufen weiterleitet. SuiteResultReporter Sammeln Sie Testergebnisse für einen ganzen Suite-Aufruf und geben Sie die Endergebnisse aus. TestFailureListener Früher hat der Listener bei einem Testfehler Maßnahmen ergriffen, wie z. TestResultListener Eine Vereinfachung von ITestLifecycleListener für Implementierer, die sich nur um einzelne Testergebnisse kümmern. TestTimeoutEnforcer Listener, die es ermöglichen, die Ausführungszeit eines bestimmten Testfalls zu überprüfen und ihn fehlschlagen zu lassen, wenn er ein bestimmtes Timeout überschreitet. TextResultReporter Ein Testergebnis-Reporter, der die Ergebnisse an den JUnit-Textergebnisdrucker weiterleitet. TraceCmdCollector Ein IMetricCollector , der Ablaufverfolgungen während des Tests mit „trace-cmd“ sammelt und sie beim Aufruf protokolliert. TradefedSandboxRunner.StubScheduledInvocationListener Ein Stub IScheduledInvocationListener , der nichts tut. XmlFormattedGeneratorReporter Implementierung des FormattedGeneratorReporter , dessen Format die Suite in ein XML-Format umwandelt. XmlResultReporter Schreibt JUnit-Ergebnisse in eine XML-Datei in einem Format, das mit Ants XMLJUnitResultFormatter konsistent ist.

---

Empfängt Ereignisbenachrichtigungen während Instrumentierungstestläufen.

Nach org.junit.runner.notification.RunListener gemustert

Die Reihenfolge der Aufrufe ist:

• testRunStarted
• testGestartet
• [im Test durchgefallen]
• [Testannahmefehler]
• [testIgnoriert]
• testBeendet
• ....
• [testRunFailed]
• testRunEnded

Zusammenfassung

Öffentliche Methoden
default void	testAssumptionFailure ( TestDescription test, String trace) Wird aufgerufen, wenn ein atomarer Test anzeigt, dass er eine falsche Bedingung annimmt
default void	testAssumptionFailure ( TestDescription test, FailureDescription failure) Wird aufgerufen, wenn ein atomarer Test anzeigt, dass er eine falsche Bedingung annimmt
default void	testEnded ( TestDescription test, long endTime, testMetrics) testEnded ( TestDescription test, long endTime, testMetrics) Alternative zu ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map)) wo wir die Endzeit direkt angeben können.
default void	testEnded ( TestDescription test, testMetrics) testEnded ( TestDescription test, testMetrics) Meldet das Ausführungsende eines einzelnen Testfalls.
default void	testFailed ( TestDescription test, FailureDescription failure) Meldet das Fehlschlagen eines einzelnen Testfalls.
default void	testFailed ( TestDescription test, String trace) Meldet das Fehlschlagen eines einzelnen Testfalls.
default void	testIgnored ( TestDescription test) Wird aufgerufen, wenn ein Test nicht ausgeführt wird, im Allgemeinen, weil eine Testmethode mit org.junit.Ignore kommentiert ist.
default void	testRunEnded (long elapsedTimeMillis, runMetrics) testRunEnded (long elapsedTimeMillis, runMetrics) Meldet das Ende des Testlaufs.
default void	testRunFailed ( FailureDescription failure) Der Berichtstestlauf konnte aufgrund eines von FailureDescription beschriebenen Fehlers nicht abgeschlossen werden.
default void	testRunFailed (String errorMessage) Berichtstestlauf konnte aufgrund eines schwerwiegenden Fehlers nicht abgeschlossen werden.
default void	testRunStarted (String runName, int testCount, int attemptNumber) Meldet den Start eines Testlaufs.
default void	testRunStarted (String runName, int testCount) Meldet den Start eines Testlaufs.
default void	testRunStarted (String runName, int testCount, int attemptNumber, long startTime) Meldet den Start eines Testlaufs.
default void	testRunStopped (long elapsedTime) Berichtet, dass der Testlauf aufgrund einer Benutzeranforderung vor Abschluss beendet wurde.
default void	testStarted ( TestDescription test, long startTime) Alternative zu testStarted(com.android.tradefed.result.TestDescription) , wo wir auch angeben, wann der Test gestartet wurde, kombiniert mit ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,Map)) für eine genaue Messung .
default void	testStarted ( TestDescription test) Meldet den Start eines einzelnen Testfalls.

Öffentliche Methoden

TestAnnahmeFehler

public void testAssumptionFailure (TestDescription test, 
                String trace)

Wird aufgerufen, wenn ein atomarer Test anzeigt, dass er eine falsche Bedingung annimmt

Parameter
test	TestDescription : identifiziert den Test
trace	String : Stack-Trace des Fehlers

TestAnnahmeFehler

public void testAssumptionFailure (TestDescription test, 
                FailureDescription failure)

Wird aufgerufen, wenn ein atomarer Test anzeigt, dass er eine falsche Bedingung annimmt

Parameter
test	TestDescription : identifiziert den Test
failure	FailureDescription : FailureDescription , die den Fehler und seinen Kontext beschreibt.

testBeendet

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

Alternative zu ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map)) wo wir die Endzeit direkt angeben können. Kombinieren Sie mit testStarted(com.android.tradefed.result.TestDescription, long) für eine genaue Messung.

Parameter
test	TestDescription : identifiziert den Test
endTime	long : die Zeit, zu der der Test endete, gemessen über ERROR(/System#currentTimeMillis())
testMetrics	: ein ERROR(/Map) der ausgegebenen Metriken

testBeendet

public void testEnded (TestDescription test, 
                 testMetrics)

Meldet das Ausführungsende eines einzelnen Testfalls.

Wenn testFailed(TestDescription, FailureDescription) nicht aufgerufen wurde, wurde dieser Test bestanden. Gibt auch alle Schlüssel/Wert-Metriken zurück, die möglicherweise während der Ausführung des Testfalls ausgegeben wurden.

Parameter
test	TestDescription : identifiziert den Test
testMetrics	: ein ERROR(/Map) der ausgegebenen Metriken

im Test durchgefallen

public void testFailed (TestDescription test, 
                FailureDescription failure)

Meldet das Fehlschlagen eines einzelnen Testfalls.

Wird zwischen testStarted und testEnded aufgerufen.

Parameter
test	TestDescription : identifiziert den Test
failure	FailureDescription : FailureDescription , die den Fehler und seinen Kontext beschreibt.

im Test durchgefallen

public void testFailed (TestDescription test, 
                String trace)

Meldet das Fehlschlagen eines einzelnen Testfalls.

Wird zwischen testStarted und testEnded aufgerufen.

Parameter
test	TestDescription : identifiziert den Test
trace	String : Stack-Trace des Fehlers

testIgnoriert

public void testIgnored (TestDescription test)

Wird aufgerufen, wenn ein Test nicht ausgeführt wird, im Allgemeinen, weil eine Testmethode mit org.junit.Ignore kommentiert ist.

Parameter
test	TestDescription : identifiziert den Test

testRunEnded

public void testRunEnded (long elapsedTimeMillis, 
                 runMetrics)

Meldet das Ende des Testlaufs. FIXME: Wir können nicht zwei Map<>-Schnittstellen mit unterschiedlichem Typ haben, also müssen wir hier HashMap verwenden.

Parameter
elapsedTimeMillis	long : vom Gerät gemeldete verstrichene Zeit in Millisekunden
runMetrics	: Schlüssel-Wert-Paare, die am Ende eines Testlaufs mit Metric gemeldet werden.

testRunFailed

public void testRunFailed (FailureDescription failure)

Der Berichtstestlauf konnte aufgrund eines von FailureDescription beschriebenen Fehlers nicht abgeschlossen werden.

Parameter
failure	FailureDescription : FailureDescription , die den Fehler und seinen Kontext beschreibt.

testRunFailed

public void testRunFailed (String errorMessage)

Berichtstestlauf konnte aufgrund eines schwerwiegenden Fehlers nicht abgeschlossen werden.

Parameter
errorMessage	String : ERROR(/String) beschreibt den Grund für den Ausführungsfehler.

testRunStarted

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

Meldet den Start eines Testlaufs.

Parameter
runName	String : der Name des Testlaufs
testCount	int : Gesamtzahl der Tests im Testlauf
attemptNumber	int : Auftragsnummer, die die verschiedenen Versuche desselben runName identifiziert, die mehrmals ausgeführt werden. Die tryNumber ist 0-indiziert und sollte bei jeder neuen Ausführung erhöht werden. Beispiel: Ein Test wird granular 3 Mal wiederholt, er sollte insgesamt 4 Läufe unter demselben RunName haben und die tryNumber liegt zwischen 0 und 3.

testRunStarted

public void testRunStarted (String runName, 
                int testCount)

Meldet den Start eines Testlaufs.

Parameter
runName	String : der Name des Testlaufs
testCount	int : Gesamtzahl der Tests im Testlauf

testRunStarted

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

Meldet den Start eines Testlaufs.

Parameter
runName	String : der Name des Testlaufs
testCount	int : Gesamtzahl der Tests im Testlauf
attemptNumber	int : Auftragsnummer, die die verschiedenen Versuche desselben runName identifiziert, die mehrmals ausgeführt werden. Die tryNumber ist 0-indiziert und sollte bei jeder neuen Ausführung erhöht werden. Beispiel: Ein Test wird granular 3 Mal wiederholt, er sollte insgesamt 4 Läufe unter demselben RunName haben und die tryNumber liegt zwischen 0 und 3.
startTime	long : die Zeit, zu der der Lauf gestartet wurde, gemessen über ERROR(/System#currentTimeMillis())

testRunStopped

public void testRunStopped (long elapsedTime)

Berichtet, dass der Testlauf aufgrund einer Benutzeranforderung vor Abschluss beendet wurde.

TODO: Derzeit nicht verwendet, erwägen Sie das Entfernen

Parameter
elapsedTime	long : vom Gerät gemeldete verstrichene Zeit in Millisekunden

testGestartet

public void testStarted (TestDescription test, 
                long startTime)

Alternative zu testStarted(com.android.tradefed.result.TestDescription) , wo wir auch angeben, wann der Test gestartet wurde, kombiniert mit ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,Map)) für eine genaue Messung .

Parameter
test	TestDescription : identifiziert den Test
startTime	long : die Zeit, zu der der Test gestartet wurde, gemessen über ERROR(/System#currentTimeMillis())

testGestartet

public void testStarted (TestDescription test)

Meldet den Start eines einzelnen Testfalls. Ältere Schnittstellen sollten nach Möglichkeit testStarted(com.android.tradefed.result.TestDescription) verwenden.

Parameter
test	TestDescription : identifiziert den Test