ITestLifeCycleReceiver
public
interface
ITestLifeCycleReceiver
com.android.tradefed.result.ITestLifeCycleReceiver |
Otrzymuje powiadomienia o wystąpieniu zdarzeń podczas wykonywania testów instrumentacji.
Wzorowany na org.junit.runner.notification.RunListener
Sekwencja wywołań:
- testRunStarted
- testStarted
- [testFailed]
- [testAssumptionFailure]
- [testIgnored]
- testEnded
- ....
- [testRunFailed]
- testRunEnded
Podsumowanie
Metody publiczne | |
---|---|
default
void
|
testAssumptionFailure(TestDescription test, String trace)
Wywoływany, gdy test atomowy sygnalizuje, że przyjmuje założenie, że warunek jest fałszywy. |
default
void
|
testAssumptionFailure(TestDescription test, FailureDescription failure)
Wywoływany, gdy test atomowy sygnalizuje, że przyjmuje założenie, że warunek jest fałszywy. |
default
void
|
testEnded(TestDescription test, long endTime,
Alternatywa dla |
default
void
|
testEnded(TestDescription test,
Raportuje zakończenie wykonywania pojedynczego przypadku testu. |
default
void
|
testFailed(TestDescription test, FailureDescription failure)
Raportuje niepowodzenie pojedynczego przypadku testowego. |
default
void
|
testFailed(TestDescription test, String trace)
Raportuje niepowodzenie pojedynczego przypadku testowego. |
default
void
|
testIgnored(TestDescription test)
Wywoływany, gdy test nie zostanie uruchomiony, zwykle dlatego, że metoda testu jest oznaczona adnotacją org.junit.Ignore. |
default
void
|
testRunEnded(long elapsedTimeMillis,
Raportuje zakończenie testu. |
default
void
|
testRunFailed(FailureDescription failure)
Nie udało się przeprowadzić testu raportów z powodu błędu opisanego w |
default
void
|
testRunFailed(String errorMessage)
Nie udało się przeprowadzić testu raportów z powodu krytycznego błędu. |
default
void
|
testRunStarted(String runName, int testCount, int attemptNumber)
Raportuje rozpoczęcie testu. |
default
void
|
testRunStarted(String runName, int testCount)
Raportuje rozpoczęcie testu. |
default
void
|
testRunStarted(String runName, int testCount, int attemptNumber, long startTime)
Raportuje rozpoczęcie testu. |
default
void
|
testRunStopped(long elapsedTime)
Raporty o testach, które zostały przerwane przed zakończeniem na prośbę użytkownika. |
default
void
|
testSkipped(TestDescription test, SkipReason reason)
Wywoływany, gdy test jest pomijany i nie jest wykonywany z nieoczekiwanego powodu. |
default
void
|
testStarted(TestDescription test, long startTime)
Alternatywa dla |
default
void
|
testStarted(TestDescription test)
Raportuje rozpoczęcie indywidualnego przypadku testowego. |
Metody publiczne
testAssumptionFailure
public void testAssumptionFailure (TestDescription test, String trace)
Wywoływany, gdy test atomowy sygnalizuje, że przyjmuje założenie, że warunek jest fałszywy.
Parametry | |
---|---|
test |
TestDescription : identyfikuje test |
trace |
String : zrzut stosu błędu |
testAssumptionFailure
public void testAssumptionFailure (TestDescription test, FailureDescription failure)
Wywoływany, gdy test atomowy sygnalizuje, że przyjmuje założenie, że warunek jest fałszywy.
Parametry | |
---|---|
test |
TestDescription : identyfikuje test |
failure |
FailureDescription : FailureDescription opisujący błąd i jego kontekst. |
testEnded
public void testEnded (TestDescription test, long endTime,testMetrics)
Alternatywa dla ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map))
, w której możemy bezpośrednio określić czas zakończenia. Aby uzyskać dokładne pomiary, połącz je z elementem testStarted(com.android.tradefed.result.TestDescription, long)
.
Parametry | |
---|---|
test |
TestDescription : identyfikuje test |
endTime |
long : czas zakończenia testu mierzony za pomocą System.currentTimeMillis() |
testMetrics |
: ERROR(/Map) danych wyemitowanych |
testEnded
public void testEnded (TestDescription test,testMetrics)
Raportuje zakończenie wykonywania pojedynczego przypadku testu.
Jeśli funkcja testFailed(TestDescription, FailureDescription)
nie została wywołana, test się powiódł. Zwraca też wszystkie dane klucz-wartość, które mogły zostać wyemitowane podczas wykonywania przypadku testowego.
Parametry | |
---|---|
test |
TestDescription : identyfikuje test |
testMetrics |
: ERROR(/Map) danych wyemitowanych |
testFailed
public void testFailed (TestDescription test, FailureDescription failure)
Raportuje niepowodzenie pojedynczego przypadku testowego.
Jest wywoływany między testStarted i testEnded.
Parametry | |
---|---|
test |
TestDescription : identyfikuje test |
failure |
FailureDescription : FailureDescription opisujący błąd i jego kontekst. |
testFailed
public void testFailed (TestDescription test, String trace)
Raportuje niepowodzenie pojedynczego przypadku testowego.
Jest wywoływany między testStarted i testEnded.
Parametry | |
---|---|
test |
TestDescription : identyfikuje test |
trace |
String : zrzut stosu błędu |
testIgnored
public void testIgnored (TestDescription test)
Wywoływany, gdy test nie zostanie uruchomiony, zwykle dlatego, że metoda testu jest oznaczona adnotacją org.junit.Ignore.
Parametry | |
---|---|
test |
TestDescription : identyfikuje test |
testRunEnded
public void testRunEnded (long elapsedTimeMillis,runMetrics)
Raportuje zakończenie testu.
Parametry | |
---|---|
elapsedTimeMillis |
long : czas upłynął, milisekundy zgłoszone przez urządzenie |
runMetrics |
: pary klucz-wartość zgłoszone na końcu wykonania testu |
testRunFailed
public void testRunFailed (FailureDescription failure)
Nie udało się przeprowadzić testu raportów z powodu błędu opisanego w FailureDescription
.
Parametry | |
---|---|
failure |
FailureDescription : FailureDescription opisujący błąd i jego kontekst. |
testRunFailed
public void testRunFailed (String errorMessage)
Nie udało się przeprowadzić testu raportów z powodu krytycznego błędu.
Parametry | |
---|---|
errorMessage |
String : String opisujący przyczynę niepowodzenia wykonania. |
testRunStarted
public void testRunStarted (String runName, int testCount, int attemptNumber)
Raportuje rozpoczęcie testu.
Parametry | |
---|---|
runName |
String : nazwa testu; |
testCount |
int : łączna liczba testów w sesji testowej |
attemptNumber |
int : numer zamówienia, który identyfikuje różne próby tego samego runName, które są wykonywane wielokrotnie. attemptNumber ma indeks 0 i powinien zwiększać się za każdym razem, gdy następuje nowe wykonanie. Przykład: test jest szczegółowo powtarzany 3 razy, więc powinien mieć łącznie 4 wykonania z tym samym parametrem runName, a parametr attemptNumber powinien przyjmować wartości od 0 do 3. |
testRunStarted
public void testRunStarted (String runName, int testCount)
Raportuje rozpoczęcie testu.
Parametry | |
---|---|
runName |
String : nazwa testu; |
testCount |
int : łączna liczba testów w sesji testowej |
testRunStarted
public void testRunStarted (String runName, int testCount, int attemptNumber, long startTime)
Raportuje rozpoczęcie testu.
Parametry | |
---|---|
runName |
String : nazwa testu; |
testCount |
int : łączna liczba testów w sesji testowej |
attemptNumber |
int : numer zamówienia, który identyfikuje różne próby tego samego runName, które są wykonywane wielokrotnie. attemptNumber ma indeks 0 i powinien zwiększać się za każdym razem, gdy następuje nowe uruchomienie. Przykład: test jest szczegółowo powtarzany 3 razy, więc powinien mieć łącznie 4 uruchomienia pod tym samym runName, a attemptNumber powinien mieć wartość od 0 do 3. |
startTime |
long : czas rozpoczęcia wykonywania zadania, mierzony za pomocą System.currentTimeMillis() |
testRunStopped
public void testRunStopped (long elapsedTime)
Raporty o testach, które zostały przerwane przed zakończeniem na prośbę użytkownika.
TODO: currently unused, consider removing
Parametry | |
---|---|
elapsedTime |
long : czas upłynął, milisekundy zgłoszone przez urządzenie |
testSkipped
public void testSkipped (TestDescription test, SkipReason reason)
Wywoływany, gdy test jest pomijany i nie jest wykonywany z nieoczekiwanego powodu. Te testy zostaną powtórzone, aby sprawdzić, czy tym razem wszystko się uda.
Parametry | |
---|---|
test |
TestDescription : identyfikuje test |
reason |
SkipReason : SkipReason |
testStarted
public void testStarted (TestDescription test, long startTime)
Alternatywa dla testStarted(com.android.tradefed.result.TestDescription)
, w której określamy też, kiedy test się rozpoczął, w połączeniu z ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,Map))
, aby uzyskać dokładne wyniki.
Parametry | |
---|---|
test |
TestDescription : identyfikuje test |
startTime |
long : czas rozpoczęcia testu mierzony za pomocą funkcji System.currentTimeMillis() |
testStarted
public void testStarted (TestDescription test)
Raportuje rozpoczęcie indywidualnego przypadku testowego. Starszy interfejs, którego należy używać w miarę możliwości w przypadku testStarted(com.android.tradefed.result.TestDescription)
.
Parametry | |
---|---|
test |
TestDescription : identyfikuje test |