ITestLifeCycleReceiver

public interface ITestLifeCycleReceiver

com.android.tradefed.result.ITestLifeCycleReceiver


Empfängt Ereignisbenachrichtigungen während Instrumentierungstestläufen.

Nach dem Vorbild von org.junit.runner.notification.RunListener

Die Reihenfolge der Anrufe ist:

  • testRunStarted
  • testgestartet
  • [im Test durchgefallen]
  • [testAssumptionFailure]
  • [testIgnored]
  • testEnded
  • ....
  • [testRunFailed]
  • testRunEnded

Zusammenfassung

Öffentliche Methoden

default void testAssumptionFailure ( TestDescription test, String trace)

Wird aufgerufen, wenn ein Atomtest meldet, dass er eine falsche Bedingung annimmt

default void testAssumptionFailure ( TestDescription test, FailureDescription failure)

Wird aufgerufen, wenn ein Atomtest meldet, 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 den Fehler eines einzelnen Testfalls.

default void testFailed ( TestDescription test, String trace)

Meldet den Fehler 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 annotiert ist.

default void testRunEnded (long elapsedTimeMillis, runMetrics) testRunEnded (long elapsedTimeMillis, runMetrics)

Meldet das Ende des Testlaufs.

default void testRunFailed ( FailureDescription failure)

Der Testlauf des Berichts konnte aufgrund eines in FailureDescription beschriebenen Fehlers nicht abgeschlossen werden.

default void testRunFailed (String errorMessage)

Der Testlauf des Berichts 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)

Der Testlauf des Berichts wurde aufgrund einer Benutzeranfrage vor Abschluss abgebrochen.

default void testSkipped ( TestDescription test, SkipReason reason)

Wird aufgerufen, wenn ein Test übersprungen und aus einem normalerweise nicht erwarteten Grund nicht ausgeführt 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 Beginn eines einzelnen Testfalls.

Öffentliche Methoden

testAssumptionFailure

public void testAssumptionFailure (TestDescription test, 
                String trace)

Wird aufgerufen, wenn ein Atomtest meldet, dass er eine falsche Bedingung annimmt

Parameter
test TestDescription : Identifiziert den Test

trace String : Stack-Trace des Fehlers

testAssumptionFailure

public void testAssumptionFailure (TestDescription test, 
                FailureDescription failure)

Wird aufgerufen, wenn ein Atomtest meldet, dass er eine falsche Bedingung annimmt

Parameter
test TestDescription : Identifiziert den Test

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

testEnded

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. Für eine genaue Messung mit testStarted(com.android.tradefed.result.TestDescription, long) kombinieren.

Parameter
test TestDescription : Identifiziert den Test

endTime long : Die Zeit, zu der der Test endete, gemessen über System.currentTimeMillis()

testMetrics : ein ERROR(/Map) der ausgegebenen Metriken

testEnded

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 außerdem alle Schlüssel-/Wertmetriken 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 den Fehler 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 den Fehler eines einzelnen Testfalls.

Wird zwischen testStarted und testEnded aufgerufen.

Parameter
test TestDescription : Identifiziert den Test

trace String : Stack-Trace des Fehlers

testIgnored

public void testIgnored (TestDescription test)

Wird aufgerufen, wenn ein Test nicht ausgeführt wird, im Allgemeinen, weil eine Testmethode mit org.junit.Ignore annotiert 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, daher 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 Testlauf des Berichts konnte aufgrund eines in FailureDescription beschriebenen Fehlers nicht abgeschlossen werden.

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

testRunFailed

public void testRunFailed (String errorMessage)

Der Testlauf des Berichts konnte aufgrund eines schwerwiegenden Fehlers nicht abgeschlossen werden.

Parameter
errorMessage String : String , der den Grund für den Ausführungsfehler beschreibt.

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 jedem neuen Lauf erhöht werden. Beispiel: Ein Test wird granular dreimal wiederholt, es sollten insgesamt 4 Durchläufe unter demselben Laufnamen erfolgen und die Versuchsnummer 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 jedem neuen Lauf erhöht werden. Beispiel: Ein Test wird granular dreimal wiederholt, es sollten insgesamt 4 Durchläufe unter demselben Laufnamen erfolgen und die Versuchsnummer liegt zwischen 0 und 3.

startTime long : Die Zeit, zu der der Lauf gestartet wurde, gemessen über System.currentTimeMillis()

testRunStopped

public void testRunStopped (long elapsedTime)

Der Testlauf des Berichts wurde aufgrund einer Benutzeranfrage vor Abschluss abgebrochen.

TODO: derzeit nicht verwendet, erwägen Sie die Entfernung

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

testÜbersprungen

public void testSkipped (TestDescription test, 
                SkipReason reason)

Wird aufgerufen, wenn ein Test übersprungen und aus einem normalerweise nicht erwarteten Grund nicht ausgeführt wurde. Es wird versucht, diese Tests zu wiederholen, um eine ordnungsgemäße Ausführung sicherzustellen.

Parameter
test TestDescription : Identifiziert den Test

reason SkipReason : SkipReason

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 System.currentTimeMillis()

testgestartet

public void testStarted (TestDescription test)

Meldet den Beginn eines einzelnen Testfalls. Bei älteren Schnittstellen sollte nach Möglichkeit testStarted(com.android.tradefed.result.TestDescription) verwendet werden.

Parameter
test TestDescription : Identifiziert den Test