Odbiornik ITestLifeCycle

public interface ITestLifeCycleReceiver

com.android.tradefed.result.ITestLifeCycleReceiver


Otrzymuje powiadomienia o zdarzeniach podczas przebiegów testów oprzyrządowania.

Wzorowany na org.junit.runner.notification.RunListener

Kolejność wywołań będzie następująca:

  • Uruchomiono testRun
  • test rozpoczęty
  • [Test nieudany]
  • [testZałożeniaNiepowodzenie]
  • [testIgnorowany]
  • testZakończony
  • ....
  • [testUruchomienie nie powiodło się]
  • testRunZakończony

Streszczenie

Metody publiczne

default void testAssumptionFailure ( TestDescription test, String trace)

Wywoływana, gdy test atomowy sygnalizuje, że zakłada warunek, który jest fałszywy

default void testAssumptionFailure ( TestDescription test, FailureDescription failure)

Wywoływana, gdy test atomowy sygnalizuje, że zakłada 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)

Zgłasza koniec 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ływane, gdy test nie zostanie uruchomiony, zazwyczaj dlatego, że metoda testowa jest oznaczona adnotacją org.junit.Ignore.

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

Zgłasza koniec przebiegu testowego.

default void testRunFailed ( FailureDescription failure)

Raportuje, że przebieg testu nie został ukończony z powodu błędu opisanego w FailureDescription .

default void testRunFailed (String errorMessage)

Raportuje, że przebieg testu nie został ukończony z powodu błędu krytycznego.

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

Zgłasza rozpoczęcie przebiegu testowego.

default void testRunStarted (String runName, int testCount)

Zgłasza rozpoczęcie przebiegu testowego.

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

Zgłasza rozpoczęcie przebiegu testowego.

default void testRunStopped (long elapsedTime)

Raportuje, ż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ł rozpoczęty, w połączeniu z ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,Map)) w celu dokładnego pomiaru .

default void testStarted ( TestDescription test)

Zgłasza rozpoczęcie pojedynczego przypadku testowego.

Metody publiczne

testZałożenieNiepowodzenie

public void testAssumptionFailure (TestDescription test, 
                String trace)

Wywoływana, gdy test atomowy sygnalizuje, że zakłada 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ływana, gdy test atomowy sygnalizuje, że zakłada warunek, który jest fałszywy

Parametry
test TestDescription : identyfikuje test

failure FailureDescription : FailureDescription opisujący awarię i jej 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)

Zgłasza koniec wykonania pojedynczego przypadku testowego.

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

Będzie wywoływany pomiędzy testStarted i testEnded.

Parametry
test TestDescription : identyfikuje test

failure FailureDescription : FailureDescription opisujący awarię i jej kontekst.

Test nieudany

public void testFailed (TestDescription test, 
                String trace)

Zgłasza niepowodzenie pojedynczego przypadku testowego.

Będzie wywoływany pomiędzy testStarted i testEnded.

Parametry
test TestDescription : identyfikuje test

trace String : ślad stosu awarii

testIgnorowany

public void testIgnored (TestDescription test)

Wywoływane, gdy test nie zostanie uruchomiony, zazwyczaj dlatego, że metoda testowa jest oznaczona adnotacją org.junit.Ignore.

Parametry
test TestDescription : identyfikuje test

testRunZakończony

public void testRunEnded (long elapsedTimeMillis, 
                 runMetrics)

Zgłasza koniec przebiegu testowego. FIXME: Nie możemy mieć dwóch interfejsów Map<> różnych typów, 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łaszane na koniec przebiegu testowego z Metric .

testRun nie powiódł się

public void testRunFailed (FailureDescription failure)

Raportuje, że przebieg testu nie został ukończony z powodu błędu opisanego w FailureDescription .

Parametry
failure FailureDescription : FailureDescription opisujący awarię i jej kontekst.

testRun nie powiódł się

public void testRunFailed (String errorMessage)

Raportuje, że przebieg testu nie został ukończony z powodu błędu krytycznego.

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

Uruchomiono testRun

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

Zgłasza rozpoczęcie przebiegu testowego.

Parametry
runName String : nazwa przebiegu testowego

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

attemptNumber int : numer zamówienia, identyfikujący różne próby tej samej nazwy runName, które są uruchamiane wiele razy. PróbaNumber jest indeksowana przez 0 i powinna zwiększać się za każdym razem, gdy nastąpi nowe uruchomienie. np. test jest szczegółowo powtarzany 3 razy, powinien mieć w sumie 4 przebiegi pod tą samą nazwą uruchomienia, a numer próby wynosi od 0 do 3.

Uruchomiono testRun

public void testRunStarted (String runName, 
                int testCount)

Zgłasza rozpoczęcie przebiegu testowego.

Parametry
runName String : nazwa przebiegu testowego

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

Uruchomiono testRun

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

Zgłasza rozpoczęcie przebiegu testowego.

Parametry
runName String : nazwa przebiegu testowego

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

attemptNumber int : numer zamówienia, identyfikujący różne próby tej samej nazwy runName, które są uruchamiane wiele razy. PróbaNumber jest indeksowana przez 0 i powinna zwiększać się za każdym razem, gdy nastąpi nowe uruchomienie. np. test jest szczegółowo powtarzany 3 razy, powinien mieć w sumie 4 przebiegi pod tą samą nazwą uruchomienia, a numer próby wynosi od 0 do 3.

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

testRunZatrzymany

public void testRunStopped (long elapsedTime)

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

DO ZROBIENIA: obecnie nieużywany, rozważ usunięcie

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

test rozpoczęty

public void testStarted (TestDescription test, 
                long startTime)

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

Parametry
test TestDescription : identyfikuje test

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

test rozpoczęty

public void testStarted (TestDescription test)

Zgłasza rozpoczęcie pojedynczego przypadku testowego. Starszy interfejs, jeśli to możliwe, należy używać testStarted(com.android.tradefed.result.TestDescription) .

Parametry
test TestDescription : identyfikuje test