Kolektor raportów o błędach

public class BugreportCollector
extends Object implements ITestInvocationListener

java.lang.Object
↳ com.android.tradefed.result.BugreportCollector,

Przekazujący ITestInvocationListener, który zbiera raporty o błędach w przypadku zdarzeń możliwych do skonfigurowania a następnie wywołuje ITestInvocationListener#testLog w swoich elementach podrzędnych po każdym .

Zachowania: (FIXME: dokończ)

  • Wykonaj przechwytywanie po każdym przypadku, jeśli któryś z przypadków testowych się nie uda
  • Wykonaj przechwytywanie po każdym przypadku testowania
  • Wykonaj po każdym nieudanym przypadku testowania
  • Rejestruj

Podsumowanie

Zagnieżdżone klasy

class BugreportCollector.Predicate

Pełny predykat określający, kiedy należy zarejestrować raport o błędzie. 

interface BugreportCollector.SubPredicate

 

Fieldsem

public static final BugreportCollector.Predicate AFTER_FAILED_TESTCASES

Wstępnie zdefiniowany predykat, który uruchamia się po każdym nieudanym przypadku testowania.

public static final BugreportCollector.Predicate AT_START

Wstępnie zdefiniowany predykat, który uruchamia się przy rozpoczęciu pierwszego wywołania

Konstruktory publiczne

BugreportCollector(ITestInvocationListener listener, ITestDevice testDevice)

Metody publiczne

void addPredicate(BugreportCollector.Predicate p)
void blockUntilIdle()

Blokuj, dopóki kolektor nie będzie zbierać żadnych raportów o błędach.

TestSummary getSummary()

Umożliwia usłudze InvocationListener zwrócenie podsumowania.

void invocationEnded(long elapsedTime)

Raportuje, że wywołanie zostało zakończone (prawidłowo lub z powodu błędu) .

void invocationFailed(Throwable cause)

Zgłasza niepełne wywołanie z powodu błędu.

void invocationStarted(IInvocationContext context)

Raportuje początek wywołania testu.

void setAsynchronous(boolean asynchronous)

Określ, czy zbieranie zgłoszeń o błędach ma być zbierane w innym wątku (asynchronous = true) lub zablokuj rozmówcę do momentu zarejestrowania raportu o błędzie (asynchronous = false).

void setDescriptiveName(String name)

Ustaw opisową nazwę, która będzie używana podczas rejestrowania raportów o błędach.

void setDeviceWaitTime(int waitTime)

Ustaw czas (w sekundach) oczekiwania na przejście urządzenia do trybu online, zanim spróbujemy zarejestrować raport o błędach.

void testAssumptionFailure(TestDescription test, String trace)

Wywoływane, gdy flagi testów atomowych wskazują, że przyjmuje się warunek o wartości fałszywego

void testEnded(TestDescription test, testMetrics)

Raportuje koniec wykonania danego przypadku testowego.

void testFailed(TestDescription test, String trace)

Zgłasza niepowodzenie pojedynczego przypadku testowego.

void testIgnored(TestDescription test)

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

void testLog(String dataName, LogDataType dataType, InputStreamSource dataStream)

Podaje powiązany dziennik lub dane debugowania z wywołania testu.

void testRunEnded(long elapsedTime, runMetrics)

Koniec przebiegu testowego raportów.

void testRunFailed(String errorMessage)

Nie udało się wykonać testu raportów z powodu błędu krytycznego.

void testRunStarted(String runName, int testCount)

Raportuje rozpoczęcie testu.

void testRunStopped(long elapsedTime)

Test raportów został zatrzymany przed ukończeniem na prośbę użytkownika.

void testStarted(TestDescription test)

Raportuje początek pojedynczego przypadku testowego.

Fieldsem

AFTER_FAILED_TESTCASES

public static final BugreportCollector.Predicate AFTER_FAILED_TESTCASES

Wstępnie zdefiniowany predykat, który uruchamia się po każdym nieudanym przypadku testowania.

AT_START

public static final BugreportCollector.Predicate AT_START

Wstępnie zdefiniowany predykat, który uruchamia się przy rozpoczęciu pierwszego wywołania

Konstruktory publiczne

Kolektor raportów o błędach

public BugreportCollector (ITestInvocationListener listener, 
                ITestDevice testDevice)

Parametry
listener ITestInvocationListener

testDevice ITestDevice

Metody publiczne

dodawanie predykatu

public void addPredicate (BugreportCollector.Predicate p)

Parametry
p BugreportCollector.Predicate

blockUntilIdle

public void blockUntilIdle ()

Blokuj, dopóki kolektor nie będzie zbierać żadnych raportów o błędach. Jeśli kolektor nie jest aktywnie zbieranie raportu o błędzie, zwrot natychmiastowy

getPodsumowanie

public TestSummary getSummary ()

Umożliwia usłudze InvocationListener zwrócenie podsumowania.

Zwroty
TestSummary TestSummary podsumowujący uruchomienie lub wartość null

Zakończenie wywołania

public void invocationEnded (long elapsedTime)

Raportuje, że wywołanie zostało zakończone (prawidłowo lub z powodu błędu) .

będzie automatycznie wywoływana przez platformę federacji handlowej.

Parametry
elapsedTime long: czas, jaki upłynął wywołania w milisekundach,

Błąd wywołania

public void invocationFailed (Throwable cause)

Zgłasza niepełne wywołanie z powodu błędu.

będzie automatycznie wywoływana przez platformę federacji handlowej.

Parametry
cause Throwable: przyczyna błędu (Throwable).

Rozpoczęcie wywoływania

public void invocationStarted (IInvocationContext context)

Raportuje początek wywołania testu.

będzie automatycznie wywoływana przez platformę federacji handlowej. Raportujący muszą zastąpić aby umożliwić raportowanie wielu urządzeń.

Parametry
context IInvocationContext: informacje o wywołaniu.

setAsynchronous

public void setAsynchronous (boolean asynchronous)

Określ, czy zbieranie zgłoszeń o błędach ma być zbierane w innym wątku (asynchronous = true) lub zablokuj rozmówcę do momentu zarejestrowania raportu o błędzie (asynchronous = false).

Parametry
asynchronous boolean

setDescriptiveName

public void setDescriptiveName (String name)

Ustaw opisową nazwę, która będzie używana podczas rejestrowania raportów o błędach. Jeśli null, BugreportCollector wróci do domyślnego zachowania polegającego na serializacji nazwy zdarzenie, które spowodowało zebranie raportu o błędzie.

Parametry
name String

setDeviceWaitTime

public void setDeviceWaitTime (int waitTime)

Ustaw czas (w sekundach) oczekiwania na przejście urządzenia do trybu online, zanim spróbujemy zarejestrować raport o błędach. Jeśli ma wartość ujemną, nie zostanie przeprowadzona żadna kontrola. Dowolny DeviceNotAvailableException napotkanych podczas tego sprawdzania zostanie zarejestrowana i zignorowana.

Parametry
waitTime int

Niepowodzenie testuZałożenia Niepowodzeń

public void testAssumptionFailure (TestDescription test, 
                String trace)

Wywoływane, gdy flagi testów atomowych wskazują, że przyjmuje się warunek o wartości fałszywego

Parametry
test TestDescription: identyfikuje test
trace String: zrzut stosu niepowodzenia

testZakończony

public void testEnded (TestDescription test, 
                 testMetrics)

Raportuje koniec wykonania danego przypadku testowego.

Jeśli funkcja testFailed(TestDescription, FailureDescription) nie została wywołana, test zaliczony. Zwraca również dowolną parę klucz/wartość wskaźniki, które mogły zostać wyemitowane podczas wykonywania przypadku testowego.

Parametry
test TestDescription: identyfikuje test
testMetrics : ERROR(/Map) wysłanych wskaźników

Niepowodzenie testu

public void testFailed (TestDescription test, 
                String trace)

Zgłasza niepowodzenie pojedynczego przypadku testowego.

Jest wywoływana między testStarted a testEnded.

Parametry
test TestDescription: identyfikuje test
trace String: zrzut stosu niepowodzenia

testignorowany

public void testIgnored (TestDescription test)

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

Parametry
test TestDescription: identyfikuje test

dziennik testów

public void testLog (String dataName, 
                LogDataType dataType, 
                InputStreamSource dataStream)

Podaje powiązany dziennik lub dane debugowania z wywołania testu.

Należy wywołać przed ERROR(/ITestInvocationListener#invocationFailed(Throwable)) lub ERROR(/ITestInvocationListener#invocationEnded(long))

Platforma federacji handlu detalicznego automatycznie wywoła tę metodę, dostarczając dziennik hosta. a w razie potrzeby także dziennik urządzenia.

Parametry
dataName String: opisowa nazwa danych typu String. np. „device_logcat”. Notatka Wartość dataName nie może być unikalna na każdym wywołaniu. Oznacza to, że implementujący muszą być w stanie obsłużyć wiele wywołań z tą samą wartością dataName
dataType LogDataType: element LogDataType danych
dataStream InputStreamSource: element InputStreamSource danych. Implementatorzy powinni wywołać createInputStream, aby zacząć odczytywać dane i upewnić się, że Strumień wejściowy po zakończeniu. Rozmówca powinien zadbać o to, aby źródło danych było nadal źródłem danych. obecny i dostępny do chwili zakończenia działania metody testLog.

Zakończono bieg testowy

public void testRunEnded (long elapsedTime, 
                 runMetrics)

Koniec przebiegu testowego raportów. NAPRAWDŹ: nie możemy mieć dwóch map<> z interfejsami różnego typu. musimy użyć Skrótu HashMap.

Parametry
elapsedTime long: czas, który upłynął od urządzenia, w milisekundach
runMetrics : pary klucz-wartość raportowane po zakończeniu testu z użyciem Metric.

Niepowodzenie testu uruchomienia

public void testRunFailed (String errorMessage)

Nie udało się wykonać testu raportów z powodu błędu krytycznego.

Parametry
errorMessage String: String z opisem przyczyny niepowodzenia uruchomienia.

Uruchomiono test

public void testRunStarted (String runName, 
                int testCount)

Raportuje rozpoczęcie testu.

Parametry
runName String: nazwa uruchomienia testu
testCount int: łączna liczba testów w teście

Zatrzymano uruchomienie testu

public void testRunStopped (long elapsedTime)

Test raportów został zatrzymany przed ukończeniem na prośbę użytkownika.

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

Parametry
elapsedTime long: czas, który upłynął od urządzenia, w milisekundach

testStarted (rozpoczęto test)

public void testStarted (TestDescription test)

Raportuje początek pojedynczego przypadku testowego. W starszym interfejsie należy w miarę możliwości używać interfejsu testStarted(com.android.tradefed.result.TestDescription).

Parametry
test TestDescription: identyfikuje test