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, testMetrics)

Alternatywa dla ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map)), w której możemy bezpośrednio określić czas zakończenia.

default void testEnded(TestDescription test, testMetrics)

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, runMetrics)

Raport na koniec testu.

default void testRunFailed(FailureDescription failure)

Nie udało się dokończyć testu raportów z powodu błędu opisanego w FailureDescription.

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

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.