Odbiornik ITestLifeCycle

public interface ITestLifeCycleReceiver

com.android.tradefed.result.ITestLifeCycleReceiver


Odbiera powiadomienia o zdarzeniach podczas testów oprzyrządowania.

Wzorowany po org.junit.runner.notification.RunListener

Sekwencja wezwań będzie następująca:

  • testUruchomiony
  • testRozpoczęto
  • [Test nieudany]
  • [testZałożenie Niepowodzenie]
  • [test zignorowano]
  • testZakończony
  • ....
  • [Uruchomienie testu nie powiodło się]
  • TestUruchomionyZakończony

Streszczenie

Metody publiczne

default void testAssumptionFailure ( TestDescription test, String trace)

Wywoływane, gdy atomowy test zaznaczy, że przyjmuje warunek, który jest fałszywy

default void testAssumptionFailure ( TestDescription test, FailureDescription failure)

Wywoływane, gdy atomowy test zaznaczy, że przyjmuje warunek, który jest fałszywy

default void testEnded ( TestDescription test, long endTime, testMetrics) 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.

default void testEnded ( TestDescription test, testMetrics) testEnded ( TestDescription test, testMetrics)

Raportuje zakończenie wykonywania 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, zwykle dlatego, że metoda testowa ma adnotację org.junit.Ignore.

default void testRunEnded (long elapsedTimeMillis, runMetrics) testRunEnded (long elapsedTimeMillis, runMetrics)

Raportuje koniec uruchomienia testowego.

default void testRunFailed ( FailureDescription failure)

Testowanie raportów nie powiodło się z powodu błędu opisanego przez FailureDescription .

default void testRunFailed (String errorMessage)

Testowanie raportów nie powiodło się z powodu błędu krytycznego.

default void testRunStarted (String runName, int testCount, int attemptNumber)

Raportuje początek uruchomienia testowego.

default void testRunStarted (String runName, int testCount)

Raportuje początek uruchomienia testowego.

default void testRunStarted (String runName, int testCount, int attemptNumber, long startTime)

Raportuje początek uruchomienia testowego.

default void testRunStopped (long elapsedTime)

Raporty, że uruchomienie testowe zostało zatrzymane przed zakończeniem z powodu żądania użytkownika.

default void testStarted ( TestDescription test, long startTime)

Alternatywa dla testStarted(com.android.tradefed.result.TestDescription) , gdzie określamy również, kiedy test został uruchomiony, w połączeniu z ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,Map)) dla dokładnego pomiaru .

default void testStarted ( TestDescription test)

Raportuje początek indywidualnego przypadku testowego.

Metody publiczne

testZałożenieNiepowodzenie

public void testAssumptionFailure (TestDescription test, 
                String trace)

Wywoływane, gdy atomowy test zaznaczy, że przyjmuje 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ływane, gdy atomowy test zaznaczy, że przyjmuje warunek, który jest fałszywy

Parametry
test TestDescription : identyfikuje test

failure FailureDescription : FailureDescription opisująca niepowodzenie i jego 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)

Raportuje zakończenie wykonywania pojedynczego przypadku testowego.

Jeśli testFailed(TestDescription, FailureDescription) nie został wywołany, ten 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.

Zostanie wywołana między testStarted i testEnded.

Parametry
test TestDescription : identyfikuje test

failure FailureDescription : FailureDescription opisująca niepowodzenie i jego kontekst.

Test nieudany

public void testFailed (TestDescription test, 
                String trace)

Zgłasza niepowodzenie pojedynczego przypadku testowego.

Zostanie wywołana między testStarted i testEnded.

Parametry
test TestDescription : identyfikuje test

trace String : ślad stosu awarii

testIgnorowane

public void testIgnored (TestDescription test)

Wywoływane, gdy test nie zostanie uruchomiony, zwykle dlatego, że metoda testowa ma adnotację org.junit.Ignore.

Parametry
test TestDescription : identyfikuje test

TestUruchomionyZakończony

public void testRunEnded (long elapsedTimeMillis, 
                 runMetrics)

Raportuje koniec uruchomienia testowego. FIXME: Nie możemy mieć dwóch interfejsów Map<> o różnych typach, więc musimy tutaj użyć HashMap.

Parametry
elapsedTimeMillis long : urządzenie zgłosiło czas, który upłynął, w milisekundach

runMetrics : pary klucz-wartość zgłoszone na koniec testu z Metric .

TestRunFailed

public void testRunFailed (FailureDescription failure)

Testowanie raportów nie powiodło się z powodu błędu opisanego przez FailureDescription .

Parametry
failure FailureDescription : FailureDescription opisująca niepowodzenie i jego kontekst.

TestRunFailed

public void testRunFailed (String errorMessage)

Testowanie raportów nie powiodło się z powodu błędu krytycznego.

Parametry
errorMessage String : String opisujący przyczynę niepowodzenia uruchomienia.

testUruchomiony

public void testRunStarted (String runName, 
                int testCount, 
                int attemptNumber)

Raportuje początek uruchomienia testowego.

Parametry
runName String : nazwa uruchomienia testowego

testCount int : całkowita liczba testów w przebiegu testowym

attemptNumber int : numer porządkowy, identyfikujący różne próby tego samego runName, które są uruchamiane wiele razy. PróbaNumber jest indeksowana 0 i powinna zwiększać się za każdym razem, gdy nastąpi nowe uruchomienie. Np. Test jest powtarzany 3 razy na poziomie granularnym, powinien mieć łącznie 4 przebiegi pod tą samą nazwą runName, a numer próby wynosi od 0 do 3.

testUruchomiony

public void testRunStarted (String runName, 
                int testCount)

Raportuje początek uruchomienia testowego.

Parametry
runName String : nazwa uruchomienia testowego

testCount int : całkowita liczba testów w przebiegu testowym

testUruchomiony

public void testRunStarted (String runName, 
                int testCount, 
                int attemptNumber, 
                long startTime)

Raportuje początek uruchomienia testowego.

Parametry
runName String : nazwa uruchomienia testowego

testCount int : całkowita liczba testów w przebiegu testowym

attemptNumber int : numer porządkowy, identyfikujący różne próby tego samego runName, które są uruchamiane wiele razy. PróbaNumber jest indeksowana 0 i powinna zwiększać się za każdym razem, gdy nastąpi nowe uruchomienie. Np. Test jest powtarzany 3 razy na poziomie granularnym, powinien mieć łącznie 4 przebiegi pod tą samą nazwą runName, a numer próby wynosi od 0 do 3.

startTime long : czas rozpoczęcia biegu, mierzony za pomocą System.currentTimeMillis()

testRunStopped

public void testRunStopped (long elapsedTime)

Raporty, że uruchomienie testowe zostało zatrzymane przed zakończeniem z powodu żądania użytkownika.

TODO: obecnie nieużywane, rozważ usunięcie

Parametry
elapsedTime long : urządzenie zgłosiło czas, który upłynął, w milisekundach

testRozpoczęto

public void testStarted (TestDescription test, 
                long startTime)

Alternatywa dla testStarted(com.android.tradefed.result.TestDescription) , gdzie określamy również, kiedy test został uruchomiony, w połączeniu z ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,Map)) dla dokładnego pomiaru .

Parametry
test TestDescription : identyfikuje test

startTime long : czas rozpoczęcia testu, mierzony za pomocą System.currentTimeMillis()

testRozpoczęto

public void testStarted (TestDescription test)

Raportuje początek indywidualnego przypadku testowego. Starszy interfejs powinien używać testStarted(com.android.tradefed.result.TestDescription) , gdy tylko jest to możliwe.

Parametry
test TestDescription : identyfikuje test