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

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

Raportuje zakończenie testu.

default void testRunFailed(FailureDescription failure)

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

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

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