Raportujący wyniki Proto
public
abstract
class
ProtoResultReporter
extends Object
implements
ILogSaverListener,
ISupportGranularResults,
ITestInvocationListener
java.lang.Object | |
↳ | com.android.tradefed.result.proto.ProtoResultReporter |
Raportujący wyniki utworzył protobuf TestRecord
ze wszystkimi wynikami. Powinno być
o to, co zrobić z ostatnim proto w processFinalProto(com.android.tradefed.result.proto.TestRecordProto.TestRecord)
.
Podsumowanie
Konstruktory publiczne | |
---|---|
ProtoResultReporter()
|
Metody publiczne | |
---|---|
final
void
|
invocationEnded(long elapsedTime)
Raportuje, że wywołanie zostało zakończone (prawidłowo lub z powodu błędu) . |
void
|
invocationFailed(FailureDescription failure)
Zgłasza niepełne wywołanie z powodu błędu. |
void
|
invocationFailed(Throwable cause)
Zgłasza niepełne wywołanie z powodu błędu. |
void
|
invocationSkipped(SkipReason reason)
Zgłasza wywołanie jako pominięte |
final
void
|
invocationStarted(IInvocationContext context)
Raportuje początek wywołania testu. |
final
void
|
logAssociation(String dataName, LogFile logFile)
W niektórych przypadkach zapis musi być silnie powiązany z przypadkami testowymi, ale mieć możliwość
więc w przypadku sprzedaży bezpośredniej |
void
|
processFinalInvocationLogs(TestRecordProto.TestRecord invocationLogs)
Użyj rekordu wywołania, aby wysyłać pojedynczo wszystkie końcowe logi wywołania. |
void
|
processFinalProto(TestRecordProto.TestRecord finalRecord)
Obsługa ostatecznego protokołu ze wszystkimi wynikami. |
void
|
processStartInvocation(TestRecordProto.TestRecord invocationStartRecord, IInvocationContext invocationContext)
Obsługa rekordu testu częściowego wywołania po wystąpieniu |
void
|
processTestCaseEnded(TestRecordProto.TestRecord testCaseRecord)
Obsługa ostatecznego zapisu protokołu przypadku testowego po |
void
|
processTestCaseStarted(TestRecordProto.TestRecord testCaseStartedRecord)
Obsługa częściowego rekordu przypadku testowego po |
void
|
processTestModuleEnd(TestRecordProto.TestRecord moduleRecord)
Obsługa protokołu finalnego modułu po |
void
|
processTestModuleStarted(TestRecordProto.TestRecord moduleStartRecord)
Obsługa protokołu częściowego rekordu modułu po wystąpieniu |
void
|
processTestRunEnded(TestRecordProto.TestRecord runRecord, boolean moduleInProgress)
Obsługa protokołu sfinalizowanego uruchomienia rekordu uruchomienia po |
void
|
processTestRunStarted(TestRecordProto.TestRecord runStartedRecord)
Obsługa protokołu częściowego uruchomienia testu po |
void
|
setGranularResults(boolean granularResults)
|
void
|
setInlineRecordOfChildren(boolean inline)
|
boolean
|
supportGranularResults()
Zwraca wartość Prawda, jeśli reporter obsługuje szczegółowe wyniki. W przeciwnym razie zwraca wartość Fałsz. |
final
void
|
testAssumptionFailure(TestDescription test, String trace)
Wywoływane, gdy flagi testów atomowych wskazują, że przyjmuje się warunek o wartości fałszywego |
final
void
|
testAssumptionFailure(TestDescription test, FailureDescription failure)
Wywoływane, gdy flagi testów atomowych wskazują, że przyjmuje się warunek o wartości fałszywego |
final
void
|
testEnded(TestDescription test, long endTime,
Alternatywa dla parametru |
void
|
testEnded(TestDescription test,
Raportuje koniec wykonania danego przypadku testowego. |
final
void
|
testFailed(TestDescription test, FailureDescription failure)
Zgłasza niepowodzenie pojedynczego przypadku testowego. |
final
void
|
testFailed(TestDescription test, String trace)
Zgłasza niepowodzenie pojedynczego przypadku testowego. |
final
void
|
testIgnored(TestDescription test)
Wywoływana, gdy test nie zostanie uruchomiony, zazwyczaj dlatego, że metoda testowa jest oznaczona adnotacją org.junit.Ignoruj. |
final
void
|
testModuleEnded()
Raportuje zakończenie działania modułu. |
final
void
|
testModuleStarted(IInvocationContext moduleContext)
Raportuje początek uruchomionego modułu. |
final
void
|
testRunEnded(long elapsedTimeMillis,
Koniec przebiegu testowego raportów. |
final
void
|
testRunFailed(FailureDescription failure)
Nie udało się wykonać testu raportów z powodu błędu opisanego w |
final
void
|
testRunFailed(String errorMessage)
Nie udało się wykonać testu raportów z powodu błędu krytycznego. |
void
|
testRunStarted(String runName, int testCount, int attemptNumber)
Raportuje rozpoczęcie testu. |
final
void
|
testRunStarted(String runName, int testCount)
Raportuje rozpoczęcie testu. |
void
|
testRunStarted(String runName, int testCount, int attemptNumber, long startTime)
Raportuje rozpoczęcie testu. |
final
void
|
testSkipped(TestDescription test, SkipReason reason)
Wywoływane, gdy test został pominięty i nie został wykonany z przyczyn, które zwykle nie są oczekiwane. |
final
void
|
testStarted(TestDescription test, long startTime)
Alternatywa dla parametru |
final
void
|
testStarted(TestDescription test)
Raportuje początek pojedynczego przypadku testowego. |
Metody chronione | |
---|---|
TestRecordProto.ChildReference
|
createModuleChildReference(TestRecordProto.TestRecord record)
Tworzy referencję podrzędną modułu. |
Konstruktory publiczne
Raportujący wyniki Proto
public ProtoResultReporter ()
Metody publiczne
Zakończenie wywołania
public final 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 (FailureDescription failure)
Zgłasza niepełne wywołanie z powodu błędu.
będzie automatycznie wywoływana przez platformę federacji handlowej.
Parametry | |
---|---|
failure |
FailureDescription : FailureDescription opisujący przyczynę błędu; |
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 ). |
Wywołanie pominięte
public void invocationSkipped (SkipReason reason)
Zgłasza wywołanie jako pominięte
Parametry | |
---|---|
reason |
SkipReason |
Rozpoczęcie wywoływania
public final 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. |
powiązanie_logowania
public final void logAssociation (String dataName, LogFile logFile)
W niektórych przypadkach zapis musi być silnie powiązany z przypadkami testowymi, ale mieć możliwość
więc w przypadku sprzedaży bezpośredniej testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile)
oddzwanianie jest niemożliwe. Dzięki temu to wywołanie zwrotne umożliwia utworzenie silnego powiązania
bezpośrednio.
Parametry | |
---|---|
dataName |
String : nazwa danych |
logFile |
LogFile : LogFile , który został zarejestrowany wcześniej i powinny być powiązany z parametrem
dla danego przypadku testowego. |
trafficFinalInvocationLogs
public void processFinalInvocationLogs (TestRecordProto.TestRecord invocationLogs)
Użyj rekordu wywołania, aby wysyłać pojedynczo wszystkie końcowe logi wywołania.
Parametry | |
---|---|
invocationLogs |
TestRecordProto.TestRecord : sfinalizowany protokół reprezentujący wywołanie. |
procesFinalProto
public void processFinalProto (TestRecordProto.TestRecord finalRecord)
Obsługa ostatecznego protokołu ze wszystkimi wynikami.
Parametry | |
---|---|
finalRecord |
TestRecordProto.TestRecord : sfinalizowany dokument ze wszystkimi wynikami wywołania. |
ProcesStartInvocation
public void processStartInvocation (TestRecordProto.TestRecord invocationStartRecord, IInvocationContext invocationContext)
Obsługa rekordu testu częściowego wywołania po wystąpieniu invocationStarted(com.android.tradefed.invoker.IInvocationContext)
.
Parametry | |
---|---|
invocationStartRecord |
TestRecordProto.TestRecord : częściowy proto wypełniany po metodzie invocationStart. |
invocationContext |
IInvocationContext : wywołanie IInvocationContext . |
Zakończenie badania sprawy
public void processTestCaseEnded (TestRecordProto.TestRecord testCaseRecord)
Obsługa ostatecznego zapisu protokołu przypadku testowego po ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,HashMap))
.
Parametry | |
---|---|
testCaseRecord |
TestRecordProto.TestRecord : ostateczna wersja protokołu przedstawiającego przypadek testowy. |
procesTestCaseStarted (rozpoczęto test przypadku)
public void processTestCaseStarted (TestRecordProto.TestRecord testCaseStartedRecord)
Obsługa częściowego rekordu przypadku testowego po testStarted(com.android.tradefed.result.TestDescription, long)
.
Parametry | |
---|---|
testCaseStartedRecord |
TestRecordProto.TestRecord : częściowy protokół reprezentujący przypadek testowy. |
Zakończenie modułuTestu
public void processTestModuleEnd (TestRecordProto.TestRecord moduleRecord)
Obsługa protokołu finalnego modułu po testModuleEnded()
.
Parametry | |
---|---|
moduleRecord |
TestRecordProto.TestRecord : ostateczna wersja protokołu reprezentującego moduł. |
ModułTestuProcesuStarted
public void processTestModuleStarted (TestRecordProto.TestRecord moduleStartRecord)
Obsługa protokołu częściowego rekordu modułu po wystąpieniu testModuleStarted(com.android.tradefed.invoker.IInvocationContext)
.
Parametry | |
---|---|
moduleStartRecord |
TestRecordProto.TestRecord : częściowy protokół reprezentujący moduł. |
Zakończono bieg testowania procesu
public void processTestRunEnded (TestRecordProto.TestRecord runRecord, boolean moduleInProgress)
Obsługa protokołu sfinalizowanego uruchomienia rekordu uruchomienia po ERROR(/#testRunEnded(long,HashMap))
.
Parametry | |
---|---|
runRecord |
TestRecordProto.TestRecord : sfinalizowany protokół reprezentujący uruchomienie. |
moduleInProgress |
boolean : informacja o tym, czy moduł jest w toku. |
rozpoczęto proces testowania
public void processTestRunStarted (TestRecordProto.TestRecord runStartedRecord)
Obsługa protokołu częściowego uruchomienia testu po testRunStarted(String, int)
.
Parametry | |
---|---|
runStartedRecord |
TestRecordProto.TestRecord : częściowy protokół reprezentujący uruchomienie. |
Ustaw szczegółoweWyniki
public void setGranularResults (boolean granularResults)
Parametry | |
---|---|
granularResults |
boolean |
setInlineRecordOfDzieci
public void setInlineRecordOfChildren (boolean inline)
Parametry | |
---|---|
inline |
boolean |
Pomoc Szczegółowe wyniki
public boolean supportGranularResults ()
Zwraca wartość Prawda, jeśli reporter obsługuje szczegółowe wyniki. W przeciwnym razie zwraca wartość Fałsz.
Zwroty | |
---|---|
boolean |
Niepowodzenie testuZałożenia Niepowodzeń
public final 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 |
Niepowodzenie testuZałożenia Niepowodzeń
public final void testAssumptionFailure (TestDescription test, FailureDescription failure)
Wywoływane, gdy flagi testów atomowych wskazują, że przyjmuje się warunek o wartości fałszywego
Parametry | |
---|---|
test |
TestDescription : identyfikuje test |
failure |
FailureDescription : FailureDescription opisujący błąd i jego kontekst. |
testZakończony
public final void testEnded (TestDescription test, long endTime,testMetrics)
Alternatywa dla parametru ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map))
, w którym można określić godzinę zakończenia
bezpośrednio. Aby uzyskać dokładny pomiar, połącz go z polem testStarted(com.android.tradefed.result.TestDescription, long)
.
Parametry | |
---|---|
test |
TestDescription : identyfikuje test |
endTime |
long : czas zakończenia testu (mierzony w polu System.currentTimeMillis() ). |
testMetrics |
: ERROR(/Map) wysłanych wskaźników |
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 final void testFailed (TestDescription test, FailureDescription failure)
Zgłasza niepowodzenie pojedynczego przypadku testowego.
Jest wywoływana między testStarted a testEnded.
Parametry | |
---|---|
test |
TestDescription : identyfikuje test |
failure |
FailureDescription : FailureDescription opisujący błąd i jego kontekst. |
Niepowodzenie testu
public final 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 final 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 |
Zakończono moduł testowy
public final void testModuleEnded ()
Raportuje zakończenie działania modułu.
Początek modułu testowania
public final void testModuleStarted (IInvocationContext moduleContext)
Raportuje początek uruchomionego modułu. To wywołanie zwrotne jest powiązane z usługą testModuleEnded()
i jest opcjonalne w sekwencji. Używa się go tylko podczas biegu, w którym
moduły: aplikacje biegowe oparte na pakiecie.
Parametry | |
---|---|
moduleContext |
IInvocationContext : element IInvocationContext modułu. |
Zakończono bieg testowy
public final void testRunEnded (long elapsedTimeMillis,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 | |
---|---|
elapsedTimeMillis |
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 final void testRunFailed (FailureDescription failure)
Nie udało się wykonać testu raportów z powodu błędu opisanego w FailureDescription
.
Parametry | |
---|---|
failure |
FailureDescription : FailureDescription opisujący błąd i jego kontekst. |
Niepowodzenie testu uruchomienia
public final 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, int attemptNumber)
Raportuje rozpoczęcie testu.
Parametry | |
---|---|
runName |
String : nazwa uruchomienia testu |
testCount |
int : łączna liczba testów w teście |
attemptNumber |
int : numer zamówienia identyfikujący różne próby wykonania tej samej wartości runName
uruchamianych wiele razy. Liczba próbek jest indeksowana 0 i powinna być większa za każdym razem.
nowy bieg. np. Test został ponowiony po 3 próbach. Łącznie powinien przypadać 4 razy
działa w ramach tej samej nazwy runName, a parametr orderNumber mieści się w zakresie od 0 do 3. |
Uruchomiono test
public final 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 |
Uruchomiono test
public void testRunStarted (String runName, int testCount, int attemptNumber, long startTime)
Raportuje rozpoczęcie testu.
Parametry | |
---|---|
runName |
String : nazwa uruchomienia testu |
testCount |
int : łączna liczba testów w teście |
attemptNumber |
int : numer zamówienia identyfikujący różne próby wykonania tej samej wartości runName
uruchamianych wiele razy. Wartość orderNumber jest indeksowana o wartości 0 i powinna rosnąć za każdym razem, gdy
nowego uruchomienia. np. Test został ponowiony po 3 próbach. Powinien on mieć łącznie 4 uruchomienia.
w tej samej wartości runName, a parametr phishingNumber mieści się w zakresie od 0 do 3. |
startTime |
long : czas rozpoczęcia uruchomienia (mierzony w polu System.currentTimeMillis() ). |
testPominięto
public final void testSkipped (TestDescription test, SkipReason reason)
Wywoływane, gdy test został pominięty i nie został wykonany z przyczyn, które zwykle nie są oczekiwane. W tych testach zostaną ponowione próby przeprowadzenia prawidłowego wykonania.
Parametry | |
---|---|
test |
TestDescription : identyfikuje test |
reason |
SkipReason : SkipReason |
testStarted (rozpoczęto test)
public final void testStarted (TestDescription test, long startTime)
Alternatywa dla parametru testStarted(com.android.tradefed.result.TestDescription)
, gdzie również określamy, kiedy test został przeprowadzony
w połączeniu z parametrem 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 (określony za pomocą parametru System.currentTimeMillis() ). |
testStarted (rozpoczęto test)
public final 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 |
Metody chronione
createModuleChildOdniesienie
protected TestRecordProto.ChildReference createModuleChildReference (TestRecordProto.TestRecord record)
Tworzy referencję podrzędną modułu.
Parametry | |
---|---|
record |
TestRecordProto.TestRecord |
Zwroty | |
---|---|
TestRecordProto.ChildReference |