ITestLifeCycleReceiver

public interface ITestLifeCycleReceiver

com.android.tradefed.result.ITestLifeCycleReceiver


Erhält Ereignisbenachrichtigungen während Instrumentierungstests.

Basierend auf org.junit.runner.notification.RunListener

Die Aufrufabfolge sieht so aus:

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

Zusammenfassung

Öffentliche Methoden

default void testAssumptionFailure(TestDescription test, String trace)

Wird aufgerufen, wenn ein Atomtest meldet, dass eine Bedingung falsch ist

default void testAssumptionFailure(TestDescription test, FailureDescription failure)

Wird aufgerufen, wenn ein atomarer Test meldet, dass eine Bedingung angenommen wird, die falsch ist.

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

Alternative zu ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map)), bei der die Endzeit direkt angegeben werden kann.

default void testEnded(TestDescription test, testMetrics)

Gibt das Ende der Ausführung eines einzelnen Testfalls an.

default void testFailed(TestDescription test, FailureDescription failure)

Hier wird der Fehler eines einzelnen Testfalls gemeldet.

default void testFailed(TestDescription test, String trace)

Meldet das Scheitern eines einzelnen Testlaufs.

default void testIgnored(TestDescription test)

Wird aufgerufen, wenn ein Test nicht ausgeführt wird. Dies ist im Allgemeinen der Fall, weil eine Testmethode mit org.junit.Ignorieren annotiert ist.

default void testRunEnded(long elapsedTimeMillis, runMetrics)

Gibt das Ende des Testlaufs an.

default void testRunFailed(FailureDescription failure)

Der Testlauf für Berichte konnte aufgrund eines Fehlers, der von FailureDescription beschrieben wurde, nicht abgeschlossen werden.

default void testRunFailed(String errorMessage)

Der Testlauf für Berichte konnte aufgrund eines schwerwiegenden Fehlers nicht abgeschlossen werden.

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

Gibt den Beginn eines Testlaufs an.

default void testRunStarted(String runName, int testCount)

Meldet den Start eines Testlaufs.

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

Gibt den Beginn eines Testlaufs an.

default void testRunStopped(long elapsedTime)

Der Testlauf für Berichte wurde aufgrund einer Nutzeranfrage vorzeitig beendet.

default void testSkipped(TestDescription test, SkipReason reason)

Wird aufgerufen, wenn ein Test übersprungen und aus einem Grund nicht ausgeführt wurde, der normalerweise nicht erwartet wird.

default void testStarted(TestDescription test, long startTime)

Alternative zu testStarted(com.android.tradefed.result.TestDescription), bei der auch angegeben wird, wann der Test gestartet wurde. Wird mit ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,Map)) kombiniert, um genaue Messungen zu ermöglichen.

default void testStarted(TestDescription test)

Gibt den Beginn eines einzelnen Testfalls an.

Öffentliche Methoden

testAssumptionFailure

public void testAssumptionFailure (TestDescription test, 
                String trace)

Wird aufgerufen, wenn ein atomarer Test meldet, dass eine Bedingung angenommen wird, die falsch ist.

Parameter
test TestDescription: identifiziert den Test

trace String: Stack-Trace des Fehlers

testAssumptionFailure

public void testAssumptionFailure (TestDescription test, 
                FailureDescription failure)

Wird aufgerufen, wenn ein atomarer Test meldet, dass eine Bedingung angenommen wird, die falsch ist.

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)), mit der wir die Endzeit direkt angeben können. In Kombination mit testStarted(com.android.tradefed.result.TestDescription, long) erhalten Sie eine genaue Messung.

Parameter
test TestDescription: identifiziert den Test

endTime long: Der Zeitpunkt, an dem der Test endete, gemessen über System.currentTimeMillis()

testMetrics : ERROR(/Map) der gesendeten Messwerte

testEnded

public void testEnded (TestDescription test, 
                 testMetrics)

Gibt das Ende der Ausführung eines einzelnen Testfalls an.

Wenn testFailed(TestDescription, FailureDescription) nicht aufgerufen wurde, ist dieser Test erfolgreich. Außerdem werden alle Schlüssel/Wert-Messwerte zurückgegeben, die während der Ausführung des Testfalls gesendet wurden.

Parameter
test TestDescription: Identifiziert den Test

testMetrics : ERROR(/Map) der gesendeten Messwerte

testFailed

public void testFailed (TestDescription test, 
                FailureDescription failure)

Hier wird der Fehler eines einzelnen Testfalls gemeldet.

Wird zwischen „testStarted“ und „testEnded“ aufgerufen.

Parameter
test TestDescription: identifiziert den Test

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

testFailed

public void testFailed (TestDescription test, 
                String trace)

Hier wird der Fehler eines einzelnen Testfalls gemeldet.

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. Dies ist im Allgemeinen der Fall, weil eine Testmethode mit org.junit.Ignorieren annotiert ist.

Parameter
test TestDescription: Identifiziert den Test

testRunEnded

public void testRunEnded (long elapsedTimeMillis, 
                 runMetrics)

Ende des Testlaufs für Berichte.

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

runMetrics : Schlüssel/Wert-Paare, die am Ende eines Testlaufs erfasst werden

testRunFailed (Testlauf fehlgeschlagen)

public void testRunFailed (FailureDescription failure)

Der Testlauf für Berichte 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)

Der Testlauf für Berichte konnte aufgrund eines schwerwiegenden Fehlers nicht abgeschlossen werden.

Parameter
errorMessage String: String mit einer Beschreibung des Grunds für den Ausführungsfehler.

testRunStarted

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

Gibt den Beginn eines Testlaufs an.

Parameter
runName String: der Name des Testlaufs

testCount int: Gesamtzahl der Tests im Testlauf

attemptNumber int: Die Bestellnummer, die die verschiedenen Versuche desselben runName identifiziert, der mehrmals ausgeführt wird. Die „attemptNumber“ beginnt bei 0 und sollte bei jedem neuen Durchlauf erhöht werden. Wenn ein Test beispielsweise dreimal wiederholt wird, sollte er insgesamt vier Durchläufe mit demselben „runName“ haben und die „attemptNumber“ sollte von 0 auf 3 steigen.

testRunStarted

public void testRunStarted (String runName, 
                int testCount)

Gibt den Beginn eines Testlaufs an.

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)

Gibt den Beginn eines Testlaufs an.

Parameter
runName String: der Name des Testlaufs

testCount int: Gesamtzahl der Tests im Testlauf

attemptNumber int: Die Bestellnummer, die die verschiedenen Versuche desselben runName identifiziert, der mehrmals ausgeführt wird. Die „trialNumber“ ist 0-indexiert und muss bei jeder neuen Ausführung erhöht werden. Beispiel: Ein Test wird dreimal wiederholt, sollte insgesamt 4 Ausführungen unter demselben runName haben und die „trialNumber“ liegt zwischen 0 und 3.

startTime long: Der Zeitpunkt, zu dem die Ausführung gestartet wurde, gemessen über System.currentTimeMillis()

testRunStopped

public void testRunStopped (long elapsedTime)

Der Testlauf für Berichte wurde aufgrund einer Nutzeranfrage vorzeitig beendet.

TODO: currently unused, consider removing

Parameter
elapsedTime long: Gerät hat die verstrichene Zeit in Millisekunden gemeldet

TestSkipped

public void testSkipped (TestDescription test, 
                SkipReason reason)

Wird aufgerufen, wenn ein Test übersprungen und aus einem Grund nicht ausgeführt wurde, der normalerweise nicht erwartet wird. Diese Tests werden wiederholt, um eine korrekte Ausführung zu erreichen.

Parameter
test TestDescription: identifiziert den Test

reason SkipReason: SkipReason

testStarted

public void testStarted (TestDescription test, 
                long startTime)

Alternative zu testStarted(com.android.tradefed.result.TestDescription), bei der auch angegeben wird, wann der Test gestartet wurde. Wird mit ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,Map)) kombiniert, um genaue Messungen zu ermöglichen.

Parameter
test TestDescription: identifiziert den Test

startTime long: Der Zeitpunkt, zu dem der Test gestartet wurde, gemessen über System.currentTimeMillis()

testStarted

public void testStarted (TestDescription test)

Gibt den Beginn eines einzelnen Testfalls an. Ältere Benutzeroberfläche. Verwenden Sie nach Möglichkeit testStarted(com.android.tradefed.result.TestDescription).

Parameter
test TestDescription: Identifiziert den Test