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 |
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 |
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 |
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 | 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 | 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 | 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 |