ITestLifeCycleReceiver
public
interface
ITestLifeCycleReceiver
| com.android.tradefed.result.ITestLifeCycleReceiver |
Otrzymuje powiadomienia o zdarzeniach podczas testów instrumentacji.
Wzorzec oparty na org.junit.runner.notification.RunListener
Kolejność wywołań będzie następująca:
- testRunStarted
- testStarted
- [testFailed]
- [testAssumptionFailure]
- [testIgnored]
- testEnded
- ....
- [testRunFailed]
- testRunEnded
Podsumowanie
Metody publiczne | |
|---|---|
default
void
|
testAssumptionFailure(TestDescription test, String trace)
Wywoływana, gdy test atomowy zgłosi, że zakłada warunek, który jest fałszywy |
default
void
|
testAssumptionFailure(TestDescription test, FailureDescription failure)
Wywoływana, gdy test atomowy zgłosi, że zakłada warunek, który jest fałszywy |
default
void
|
testEnded(TestDescription test, long endTime,
Alternatywa dla |
default
void
|
testEnded(TestDescription test,
Zgłasza zakończenie 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ływana, gdy test nie zostanie uruchomiony, zwykle dlatego, że metoda testowa jest opatrzona adnotacją org.junit.Ignore. |
default
void
|
testRunEnded(long elapsedTimeMillis,
Raport na koniec testu. |
default
void
|
testRunFailed(FailureDescription failure)
Nie udało się dokończyć testu raportów z powodu błędu opisanego w |
default
void
|
testRunFailed(String errorMessage)
Nie udało się ukończyć testu raportów z powodu błędu krytycznego. |
default
void
|
testRunStarted(String runName, int testCount, int attemptNumber)
Zgłasza rozpoczęcie testu. |
default
void
|
testRunStarted(String runName, int testCount)
Zgłasza rozpoczęcie testu. |
default
void
|
testRunStarted(String runName, int testCount, int attemptNumber, long startTime)
Zgłasza rozpoczęcie testu. |
default
void
|
testRunStopped(long elapsedTime)
Testowe uruchomienie raportów zostało zatrzymane przed zakończeniem na prośbę użytkownika. |
default
void
|
testSkipped(TestDescription test, SkipReason reason)
Wywoływana, gdy test jest pomijany i nie jest wykonywany z przyczyny, która zwykle nie jest oczekiwana. |
default
void
|
testStarted(TestDescription test, long startTime)
Alternatywa dla |
default
void
|
testStarted(TestDescription test)
Zgłasza rozpoczęcie pojedynczego przypadku testowego. |
Metody publiczne
testAssumptionFailure
public void testAssumptionFailure (TestDescription test, String trace)
Wywoływana, gdy test atomowy zgłosi, że zakłada warunek, który jest fałszywy
| Parametry | |
|---|---|
test |
TestDescription: identyfikuje test. |
trace |
String: zrzut stosu błędu |
testAssumptionFailure
public void testAssumptionFailure (TestDescription test, FailureDescription failure)
Wywoływana, gdy test atomowy zgłosi, że zakłada warunek, który 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. Łącz z testStarted(com.android.tradefed.result.TestDescription, long), aby uzyskać dokładne pomiary.
| Parametry | |
|---|---|
test |
TestDescription: identyfikuje test. |
endTime |
long: czas zakończenia testu mierzony za pomocą System.currentTimeMillis() |
testMetrics |
: ERROR(/Map) wyemitowanych wskaźników |
testEnded
public void testEnded (TestDescription test,testMetrics)
Zgłasza zakończenie wykonania pojedynczego przypadku testowego.
Jeśli funkcja testFailed(TestDescription, FailureDescription) nie została wywołana, test został zaliczony. Zwraca też wszystkie dane klucz/wartość, które mogły zostać wyemitowane podczas wykonywania przypadku testowego.
| Parametry | |
|---|---|
test |
TestDescription: identyfikuje test. |
testMetrics |
: ERROR(/Map) wyemitowanych wskaźników |
testFailed
public void testFailed (TestDescription test, FailureDescription failure)
Zgłasza niepowodzenie pojedynczego przypadku testowego.
Będzie wywoływana między testStarted a testEnded.
| Parametry | |
|---|---|
test |
TestDescription: identyfikuje test. |
failure |
FailureDescription: FailureDescription opisujący błąd i jego kontekst. |
testFailed
public void testFailed (TestDescription test, String trace)
Zgłasza niepowodzenie pojedynczego przypadku testowego.
Będzie wywoływana między testStarted a testEnded.
| Parametry | |
|---|---|
test |
TestDescription: identyfikuje test. |
trace |
String: zrzut stosu błędu |
testIgnored
public void testIgnored (TestDescription test)
Wywoływana, gdy test nie zostanie uruchomiony, zwykle dlatego, że metoda testowa jest opatrzona adnotacją org.junit.Ignore.
| Parametry | |
|---|---|
test |
TestDescription: identyfikuje test. |
testRunEnded
public void testRunEnded (long elapsedTimeMillis,
runMetrics) Raport na koniec testu.
| Parametry | |
|---|---|
elapsedTimeMillis |
long: czas, który upłynął od ostatniego zgłoszenia przez urządzenie (w milisekundach) |
runMetrics |
: pary klucz-wartość zgłaszane na końcu testu |
testRunFailed
public void testRunFailed (FailureDescription failure)
Nie udało się dokończyć 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ę ukończyć testu raportów z powodu błędu krytycznego.
| Parametry | |
|---|---|
errorMessage |
String: String opisujący przyczynę niepowodzenia uruchomienia. |
testRunStarted
public void testRunStarted (String runName,
int testCount,
int attemptNumber)Zgłasza rozpoczęcie testu.
| Parametry | |
|---|---|
runName |
String: nazwa testu, |
testCount |
int: łączna liczba testów w teście |
attemptNumber |
int: numer zamówienia, który identyfikuje różne próby tego samego parametru runName
wykonywanego wielokrotnie. Wartość attemptNumber jest indeksowana od 0 i powinna zwiększać się za każdym razem, gdy następuje nowe uruchomienie. Przykład: test jest ponownie uruchamiany 3 razy, więc w sumie ma 4 uruchomienia pod tą samą nazwą runName, a wartość attemptNumber wynosi od 0 do 3. |
testRunStarted
public void testRunStarted (String runName,
int testCount)Zgłasza rozpoczęcie testu.
| Parametry | |
|---|---|
runName |
String: nazwa testu, |
testCount |
int: łączna liczba testów w teście |
testRunStarted
public void testRunStarted (String runName,
int testCount,
int attemptNumber,
long startTime)Zgłasza rozpoczęcie testu.
| Parametry | |
|---|---|
runName |
String: nazwa testu, |
testCount |
int: łączna liczba testów w teście |
attemptNumber |
int: numer zamówienia, który identyfikuje różne próby tego samego parametru runName
wykonywanego wielokrotnie. Numer próby jest indeksowany od 0 i powinien zwiększać się za każdym razem, gdy następuje nowe uruchomienie. Na przykład jeśli test jest ponownie uruchamiany 3 razy, powinien mieć łącznie 4 uruchomienia pod tą samą nazwą uruchomienia, a numer próby powinien wynosić od 0 do 3. |
startTime |
long: czas rozpoczęcia biegu mierzony za pomocą System.currentTimeMillis() |
testRunStopped
public void testRunStopped (long elapsedTime)
Testowe uruchomienie raportów zostało zatrzymane przed zakończeniem na prośbę użytkownika.
TODO: obecnie nieużywane, rozważ usunięcie
| Parametry | |
|---|---|
elapsedTime |
long: czas, który upłynął od ostatniego zgłoszenia przez urządzenie (w milisekundach) |
testSkipped
public void testSkipped (TestDescription test, SkipReason reason)
Wywoływana, gdy test jest pomijany i nie jest wykonywany z przyczyny, która zwykle nie jest oczekiwana. Te testy będą ponawiane, aby uzyskać prawidłowe wykonanie.
| 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 podajemy też datę rozpoczęcia testu, w połączeniu z ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,Map)), aby uzyskać dokładny pomiar.
| Parametry | |
|---|---|
test |
TestDescription: identyfikuje test. |
startTime |
long: czas rozpoczęcia testu mierzony za pomocą System.currentTimeMillis(). |
testStarted
public void testStarted (TestDescription test)
Zgłasza rozpoczęcie pojedynczego przypadku testowego. Starszy interfejs, w miarę możliwości używaj testStarted(com.android.tradefed.result.TestDescription).
| Parametry | |
|---|---|
test |
TestDescription: identyfikuje test. |