Odbiornik ITestLifeCycle
public interface ITestLifeCycleReceiver
com.android.tradefed.result.ITestLifeCycleReceiver |
Otrzymuje powiadomienia o zdarzeniach podczas przebiegów testów oprzyrządowania.
Wzorowany na org.junit.runner.notification.RunListener
Kolejność wywołań będzie następująca:
- Uruchomiono testRun
- test rozpoczęty
- [Test nieudany]
- [testZałożeniaNiepowodzenie]
- [testIgnorowany]
- testZakończony
- ....
- [testUruchomienie nie powiodło się]
- testRunZakończony
Streszczenie
Metody publiczne | |
---|---|
default void | testAssumptionFailure ( TestDescription test, String trace) Wywoływana, gdy test atomowy sygnalizuje, że zakłada warunek, który jest fałszywy |
default void | testAssumptionFailure ( TestDescription test, FailureDescription failure) Wywoływana, gdy test atomowy sygnalizuje, że zakłada warunek, który jest fałszywy |
default void | testEnded ( TestDescription test, long endTime, testMetrics) testEnded ( TestDescription test, long endTime, testMetrics) Alternatywa dla |
default void | testEnded ( TestDescription test, testMetrics) testEnded ( TestDescription test, testMetrics) Zgłasza koniec wykonania pojedynczego przypadku testowego. |
default void | testFailed ( TestDescription test, FailureDescription failure) Zgłasza niepowodzenie pojedynczego przypadku testowego. |
default void | testFailed ( TestDescription test, String trace) Zgłasza niepowodzenie pojedynczego przypadku testowego. |
default void | testIgnored ( TestDescription test) Wywoływane, gdy test nie zostanie uruchomiony, zazwyczaj dlatego, że metoda testowa jest oznaczona adnotacją org.junit.Ignore. |
default void | testRunEnded (long elapsedTimeMillis, runMetrics) testRunEnded (long elapsedTimeMillis, runMetrics) Zgłasza koniec przebiegu testowego. |
default void | testRunFailed ( FailureDescription failure) Raportuje, że przebieg testu nie został ukończony z powodu błędu opisanego w |
default void | testRunFailed (String errorMessage) Raportuje, że przebieg testu nie został ukończony z powodu błędu krytycznego. |
default void | testRunStarted (String runName, int testCount, int attemptNumber) Zgłasza rozpoczęcie przebiegu testowego. |
default void | testRunStarted (String runName, int testCount) Zgłasza rozpoczęcie przebiegu testowego. |
default void | testRunStarted (String runName, int testCount, int attemptNumber, long startTime) Zgłasza rozpoczęcie przebiegu testowego. |
default void | testRunStopped (long elapsedTime) Raportuje, że uruchomienie testowe zostało zatrzymane przed zakończeniem z powodu żądania użytkownika. |
default void | testSkipped ( TestDescription test, SkipReason reason) Wywoływane, gdy test został pominięty i nie został wykonany z powodu, którego zwykle się nie oczekuje. |
default void | testStarted ( TestDescription test, long startTime) Alternatywa dla |
default void | testStarted ( TestDescription test) Zgłasza rozpoczęcie pojedynczego przypadku testowego. |
Metody publiczne
testZałożenieNiepowodzenie
public void testAssumptionFailure (TestDescription test, String trace)
Wywoływana, gdy test atomowy sygnalizuje, że zakłada warunek, który jest fałszywy
Parametry | |
---|---|
test | TestDescription : identyfikuje test |
trace | String : ślad stosu awarii |
testZałożenieNiepowodzenie
public void testAssumptionFailure (TestDescription test, FailureDescription failure)
Wywoływana, gdy test atomowy sygnalizuje, że zakłada warunek, który jest fałszywy
Parametry | |
---|---|
test | TestDescription : identyfikuje test |
failure | FailureDescription : FailureDescription opisujący awarię i jej kontekst. |
testZakończony
public void testEnded (TestDescription test, long endTime,testMetrics)
Alternatywa dla ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map))
gdzie możemy bezpośrednio określić czas zakończenia. Połącz z testStarted(com.android.tradefed.result.TestDescription, long)
, aby uzyskać dokładny pomiar.
Parametry | |
---|---|
test | TestDescription : identyfikuje test |
endTime | long : czas zakończenia testu mierzony za pomocą System.currentTimeMillis() |
testMetrics | ERROR(/Map) emitowanych metryk |
testZakończony
public void testEnded (TestDescription test,testMetrics)
Zgłasza koniec wykonania pojedynczego przypadku testowego.
Jeśli testFailed(TestDescription, FailureDescription)
nie został wywołany, test zakończył się pomyślnie. Zwraca również wszelkie metryki klucz/wartość, które mogły zostać wyemitowane podczas wykonywania przypadku testowego.
Parametry | |
---|---|
test | TestDescription : identyfikuje test |
testMetrics | ERROR(/Map) emitowanych metryk |
Test nieudany
public void testFailed (TestDescription test, FailureDescription failure)
Zgłasza niepowodzenie pojedynczego przypadku testowego.
Będzie wywoływany pomiędzy testStarted i testEnded.
Parametry | |
---|---|
test | TestDescription : identyfikuje test |
failure | FailureDescription : FailureDescription opisujący awarię i jej kontekst. |
Test nieudany
public void testFailed (TestDescription test, String trace)
Zgłasza niepowodzenie pojedynczego przypadku testowego.
Będzie wywoływany pomiędzy testStarted i testEnded.
Parametry | |
---|---|
test | TestDescription : identyfikuje test |
trace | String : ślad stosu awarii |
testIgnorowany
public void testIgnored (TestDescription test)
Wywoływane, gdy test nie zostanie uruchomiony, zazwyczaj dlatego, że metoda testowa jest oznaczona adnotacją org.junit.Ignore.
Parametry | |
---|---|
test | TestDescription : identyfikuje test |
testRunZakończony
public void testRunEnded (long elapsedTimeMillis,runMetrics)
Zgłasza koniec przebiegu testowego. FIXME: Nie możemy mieć dwóch interfejsów Map<> różnych typów, więc musimy tutaj użyć HashMap.
Parametry | |
---|---|
elapsedTimeMillis | long : urządzenie zgłosiło czas, który upłynął, w milisekundach |
runMetrics | Metric . |
testRun nie powiódł się
public void testRunFailed (FailureDescription failure)
Raportuje, że przebieg testu nie został ukończony z powodu błędu opisanego w FailureDescription
.
Parametry | |
---|---|
failure | FailureDescription : FailureDescription opisujący awarię i jej kontekst. |
testRun nie powiódł się
public void testRunFailed (String errorMessage)
Raportuje, że przebieg testu nie został ukończony z powodu błędu krytycznego.
Parametry | |
---|---|
errorMessage | String : String opisujący przyczynę niepowodzenia uruchomienia. |
Uruchomiono testRun
public void testRunStarted (String runName, int testCount, int attemptNumber)
Zgłasza rozpoczęcie przebiegu testowego.
Parametry | |
---|---|
runName | String : nazwa przebiegu testowego |
testCount | int : całkowita liczba testów w przebiegu testu |
attemptNumber | int : numer zamówienia, identyfikujący różne próby tej samej nazwy runName, które są uruchamiane wiele razy. PróbaNumber jest indeksowana przez 0 i powinna zwiększać się za każdym razem, gdy nastąpi nowe uruchomienie. np. test jest szczegółowo powtarzany 3 razy, powinien mieć w sumie 4 przebiegi pod tą samą nazwą uruchomienia, a numer próby wynosi od 0 do 3. |
Uruchomiono testRun
public void testRunStarted (String runName, int testCount)
Zgłasza rozpoczęcie przebiegu testowego.
Parametry | |
---|---|
runName | String : nazwa przebiegu testowego |
testCount | int : całkowita liczba testów w przebiegu testu |
Uruchomiono testRun
public void testRunStarted (String runName, int testCount, int attemptNumber, long startTime)
Zgłasza rozpoczęcie przebiegu testowego.
Parametry | |
---|---|
runName | String : nazwa przebiegu testowego |
testCount | int : całkowita liczba testów w przebiegu testu |
attemptNumber | int : numer zamówienia, identyfikujący różne próby tej samej nazwy runName, które są uruchamiane wiele razy. PróbaNumber jest indeksowana przez 0 i powinna zwiększać się za każdym razem, gdy nastąpi nowe uruchomienie. np. test jest szczegółowo powtarzany 3 razy, powinien mieć w sumie 4 przebiegi pod tą samą nazwą uruchomienia, a numer próby wynosi od 0 do 3. |
startTime | long : czas rozpoczęcia przebiegu mierzony za pomocą System.currentTimeMillis() |
testRunZatrzymany
public void testRunStopped (long elapsedTime)
Raportuje, że uruchomienie testowe zostało zatrzymane przed zakończeniem z powodu żądania użytkownika.
DO ZROBIENIA: obecnie nieużywany, rozważ usunięcie
Parametry | |
---|---|
elapsedTime | long : urządzenie zgłosiło czas, który upłynął, w milisekundach |
testPominięty
public void testSkipped (TestDescription test, SkipReason reason)
Wywoływane, gdy test został pominięty i nie został wykonany z powodu, którego zwykle się nie oczekuje. Testy te zostaną ponowione, aby zapewnić ich prawidłowe wykonanie.
Parametry | |
---|---|
test | TestDescription : identyfikuje test |
reason | SkipReason : SkipReason |
test rozpoczęty
public void testStarted (TestDescription test, long startTime)
Alternatywa dla testStarted(com.android.tradefed.result.TestDescription)
, gdzie określamy również, kiedy test został rozpoczęty, w połączeniu z ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,Map))
w celu dokładnego pomiaru .
Parametry | |
---|---|
test | TestDescription : identyfikuje test |
startTime | long : czas rozpoczęcia testu mierzony za pomocą System.currentTimeMillis() |
test rozpoczęty
public void testStarted (TestDescription test)
Zgłasza rozpoczęcie pojedynczego przypadku testowego. Starszy interfejs, jeśli to możliwe, należy używać testStarted(com.android.tradefed.result.TestDescription)
.
Parametry | |
---|---|
test | TestDescription : identyfikuje test |