Ta strona została przetłumaczona przez Cloud Translation API.

SubprocessResultsReporter

public class SubprocessResultsReporter
extends Object implements ITestInvocationListener , ILogSaverListener , ISupportGranularResults

java.lang.Obiekt
↳	com.android.tradefed.result.SubprocessResultsReporter

Znane bezpośrednie podklasy

LegacySubprocessResultsReporter

LegacySubprocessResultsReporter Zamrożona implementacja raportującego wyniki podprocesu, która powinna pozostać kompatybilna z wcześniejszymi wersjami TF/CTS (np. 8+), pomimo zmian w swojej nadklasie.

Implementuje ITestInvocationListener do określenia jako result_reporter i przekazuje z podprocesu wyniki testów, przebiegów testowych, wywołań testowych.

Streszczenie

Konstruktory publiczne
`SubprocessResultsReporter ()`

Metody publiczne
`void`	`close ()`
`TestSummary`	`getSummary ()` Umożliwia InvocationListener zwrócenie podsumowania.
`void`	`invocationEnded (long elapsedTime)` Zgłasza, że wywołanie zakończyło się pomyślnie lub z powodu błędu.
`void`	`invocationFailed ( FailureDescription failure)` Zgłasza niekompletne wywołanie z powodu błędu.
`void`	`invocationFailed (Throwable cause)` Zgłasza niekompletne wywołanie z powodu błędu.
`void`	`invocationStarted ( IInvocationContext context)` Zgłasza początek wywołania testowego.
`void`	`logAssociation (String dataName, LogFile logFile)` W niektórych przypadkach log musi być silnie powiązany z przypadkami testowymi, ale możliwość zrobienia tego na bezpośrednim `testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile)` wywołanie zwrotne nie jest możliwe.
`void`	`printEvent (String key, Object event)` Pomocnik do wydrukowania klucza zdarzenia, a następnie obiektu json.
`void`	`setOutputTestLog (boolean outputTestLog)` Ustawia, czy powinniśmy wyświetlać zarejestrowany test, czy nie.
`boolean`	`supportGranularResults ()` Zwraca True, jeśli reporter obsługuje szczegółowe wyniki, w przeciwnym razie zwraca false.
`void`	`testAssumptionFailure ( TestDescription testId, String trace)` Wywoływana, gdy test atomowy oznacza, że zakłada warunek, który jest fałszywy
`void`	`testAssumptionFailure ( TestDescription testId, FailureDescription failure)` Wywoływana, gdy test atomowy oznacza, że zakłada warunek, który jest fałszywy
`void`	`testEnded ( TestDescription testId, long endTime, metrics)` `testEnded ( TestDescription testId, long endTime, metrics)` Alternatywa dla `ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map))` gdzie możemy bezpośrednio określić czas zakończenia.
`void`	`testEnded ( TestDescription testId, metrics)` `testEnded ( TestDescription testId, metrics)` Zgłasza koniec wykonania pojedynczego przypadku testowego.
`void`	`testFailed ( TestDescription testId, FailureDescription failure)` Zgłasza awarię pojedynczego przypadku testowego.
`void`	`testFailed ( TestDescription testId, String reason)` Zgłasza awarię pojedynczego przypadku testowego.
`void`	`testIgnored ( TestDescription testId)` Wywoływana, gdy test nie zostanie uruchomiony, zwykle dlatego, że metoda testowa ma adnotację org.junit.Ignore.
`void`	`testLog (String dataName, LogDataType dataType, InputStreamSource dataStream)` Udostępnia powiązane dane dziennika lub debugowania z wywołania testowego.
`void`	`testModuleEnded ()` Zgłasza koniec uruchomienia modułu.
`void`	`testModuleStarted ( IInvocationContext moduleContext)` Zgłasza początek uruchomionego modułu.
`void`	`testRunEnded (long time, runMetrics)` `testRunEnded (long time, runMetrics)` Zgłasza koniec przebiegu testowego.
`void`	`testRunFailed ( FailureDescription failure)` Przebieg testu raportów nie został ukończony z powodu błędu opisanego przez `FailureDescription` .
`void`	`testRunFailed (String reason)` Testowanie raportów nie zostało ukończone z powodu błędu krytycznego.
`void`	`testRunStarted (String runName, int testCount, int attemptNumber)` Zgłasza początek przebiegu testowego.
`void`	`testRunStarted (String runName, int testCount)` Zgłasza początek przebiegu testowego.
`void`	`testRunStarted (String runName, int testCount, int attemptNumber, long startTime)` Zgłasza początek przebiegu testowego.
`void`	`testRunStopped (long arg0)` Przebieg testu raportów został zatrzymany przed zakończeniem z powodu żądania użytkownika.
`void`	`testStarted ( TestDescription testId, long startTime)` Alternatywa dla `testStarted(com.android.tradefed.result.TestDescription)` , gdzie również określamy kiedy test został uruchomiony, w połączeniu z `ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,Map))` dla dokładnego pomiaru .
`void`	`testStarted ( TestDescription testId)` Raportuje początek pojedynczego przypadku testowego.

Konstruktory publiczne

SubprocessResultsReporter

public SubprocessResultsReporter ()

Metody publiczne

zamknąć

public void close ()

getStreszczenie

public TestSummary getSummary ()

Umożliwia InvocationListener zwrócenie podsumowania.

Zwroty
`TestSummary`	`TestSummary` podsumowujący przebieg lub null

wywołanie zakończone

public void invocationEnded (long elapsedTime)

Zgłasza, że wywołanie zakończyło się pomyślnie lub z powodu błędu.

Zostanie automatycznie wywołany przez platformę TradeFederation.

Parametry
`elapsedTime`	`long` : czas, który upłynął od wywołania w ms

wywołanie nie powiodło się

public void invocationFailed (FailureDescription failure)

Zgłasza niekompletne wywołanie z powodu błędu.

Zostanie automatycznie wywołany przez platformę TradeFederation.

Parametry
`failure`	`FailureDescription` : `FailureDescription` opisujący przyczynę niepowodzenia

wywołanie nie powiodło się

public void invocationFailed (Throwable cause)

Zgłasza niekompletne wywołanie z powodu błędu.

Zostanie automatycznie wywołany przez platformę TradeFederation.

Parametry
`cause`	`Throwable` : przyczyna niepowodzenia `ERROR(/Throwable)`

wywołanie rozpoczęte

public void invocationStarted (IInvocationContext context)

Zgłasza początek wywołania testowego.

Zostanie automatycznie wywołany przez platformę TradeFederation. Reporterzy muszą zastąpić tę metodę, aby obsługiwać raportowanie wielu urządzeń.

Parametry
`context`	`IInvocationContext` : informacje o wywołaniu

logAssociation

public void logAssociation (String dataName, 
                LogFile logFile)

W niektórych przypadkach log musi być silnie powiązany z przypadkami testowymi, ale możliwość zrobienia tego na bezpośrednim testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile) wywołanie zwrotne nie jest możliwe. Zatem to wywołanie zwrotne pozwala jawnie zapewnić silne powiązanie.

Parametry
`dataName`	`String` : nazwa danych
`logFile`	`LogFile` : `LogFile` , który był wcześniej rejestrowany i powinien być powiązany z przypadkiem testowym.

drukujZdarzenie

public void printEvent (String key, 
                Object event)

Pomocnik do wydrukowania klucza zdarzenia, a następnie obiektu json.

Parametry
`key`	`String`
`event`	`Object`

setOutputTestLog

public void setOutputTestLog (boolean outputTestLog)

Ustawia, czy powinniśmy wyświetlać zarejestrowany test, czy nie.

Parametry
`outputTestLog`	`boolean`

wsparcieSzczegółoweWyniki

public boolean supportGranularResults ()

Zwraca True, jeśli reporter obsługuje szczegółowe wyniki, w przeciwnym razie zwraca false.

Zwroty
`boolean`

testZałożenieNiepowodzenie

public void testAssumptionFailure (TestDescription testId, 
                String trace)

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

Parametry
`testId`	`TestDescription` : identyfikuje test
`trace`	`String` : ślad stosu awarii

testZałożenieNiepowodzenie

public void testAssumptionFailure (TestDescription testId, 
                FailureDescription failure)

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

Parametry
`testId`	`TestDescription` : identyfikuje test
`failure`	`FailureDescription` : `FailureDescription` opisujący błąd i jego kontekst.

test zakończony

public void testEnded (TestDescription testId, 
                long endTime, 
                 metrics)

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
`testId`	`TestDescription` : identyfikuje test
`endTime`	`long` : czas zakończenia testu, mierzony za pomocą `ERROR(/System#currentTimeMillis())`
`metrics`	: `ERROR(/Map)` emitowanych metryk

test zakończony

public void testEnded (TestDescription testId, 
                 metrics)

Zgłasza koniec wykonania pojedynczego przypadku testowego.

Jeśli testFailed(TestDescription, FailureDescription) nie został wywołany, ten test zakończył się pomyślnie. Zwraca również wszelkie metryki klucza/wartości, które mogły zostać wyemitowane podczas wykonywania przypadku testowego.

Parametry
`testId`	`TestDescription` : identyfikuje test
`metrics`	: `ERROR(/Map)` emitowanych metryk

Test nieudany

public void testFailed (TestDescription testId, 
                FailureDescription failure)

Zgłasza awarię pojedynczego przypadku testowego.

Zostanie wywołany między testStarted a testEnded.

Parametry
`testId`	`TestDescription` : identyfikuje test
`failure`	`FailureDescription` : `FailureDescription` opisujący błąd i jego kontekst.

Test nieudany

public void testFailed (TestDescription testId, 
                String reason)

Zgłasza awarię pojedynczego przypadku testowego.

Zostanie wywołany między testStarted a testEnded.

Parametry
`testId`	`TestDescription` : identyfikuje test
`reason`	`String` : ślad stosu awarii

zignorowano test

public void testIgnored (TestDescription testId)

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

Parametry
`testId`	`TestDescription` : identyfikuje test

dziennik testowy

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

Udostępnia powiązane dane dziennika lub debugowania z wywołania testowego.

Musi zostać wywołane przed ERROR(/ITestInvocationListener#invocationFailed(Throwable)) lub ERROR(/ITestInvocationListener#invocationEnded(long))

Platforma TradeFederation automatycznie wywoła tę metodę, dostarczając dziennik hosta i, jeśli ma to zastosowanie, logcat urządzenia.

Parametry
`dataName`	`String` : opisowa nazwa danych `ERROR(/String)` . np. „device_logcat”. Uwaga dataName może nie być unikatowa na wywołanie. tj. realizatorzy muszą być w stanie obsłużyć wiele wywołań z tą samą nazwą danych
`dataType`	`LogDataType` : `LogDataType` danych
`dataStream`	`InputStreamSource` : `InputStreamSource` danych. Implementatorzy powinni wywoływać metodę createInputStream, aby rozpocząć odczytywanie danych, i upewnić się, że wynikowy InputStream zostanie zamknięty po zakończeniu. Obiekty wywołujące powinny upewnić się, że źródło danych pozostaje obecne i dostępne do czasu zakończenia metody testLog.

testModuleEnd

public void testModuleEnded ()

Zgłasza koniec uruchomienia modułu.

moduł testowyrozpoczęty

public void testModuleStarted (IInvocationContext moduleContext)

Zgłasza początek uruchomionego modułu. To wywołanie zwrotne jest powiązane z testModuleEnded() i jest opcjonalne w sekwencji. Jest używany tylko podczas biegu, który korzysta z modułów: biegaczy opartych na pakietach.

Parametry
`moduleContext`	`IInvocationContext` : `IInvocationContext` modułu.

testRunEnded

public void testRunEnded (long time, 
                 runMetrics)

Zgłasza koniec przebiegu testowego. FIXME: Nie możemy mieć dwóch różnych interfejsów Map<>, więc musimy tutaj użyć HashMap.

Parametry
`time`	`long` : czas, który upłynął od urządzenia, w milisekundach
`runMetrics`	: pary klucz-wartość zgłaszane na koniec przebiegu testu z `Metric` .

testRunNie powiodło się

public void testRunFailed (FailureDescription failure)

Przebieg testu raportów nie został ukończony z powodu błędu opisanego przez FailureDescription .

Parametry
`failure`	`FailureDescription` : `FailureDescription` opisujący błąd i jego kontekst.

testRunNie powiodło się

public void testRunFailed (String reason)

Testowanie raportów nie zostało ukończone z powodu błędu krytycznego.

Parametry
`reason`	`String` : `ERROR(/String)` opisujący przyczynę niepowodzenia uruchomienia.

testRunStarted

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

Zgłasza początek przebiegu testowego.

Parametry
`runName`	`String` : nazwa uruchomienia testu
`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 0 i powinna zwiększać się za każdym razem, gdy nastąpi nowe uruchomienie. np. test jest ponawiany 3 razy w trybie granularnym, powinien mieć łącznie 4 przebiegi pod tą samą nazwą uruchomienia, a numer próby wynosi od 0 do 3.

testRunStarted

public void testRunStarted (String runName, 
                int testCount)

Zgłasza początek przebiegu testowego.

Parametry
`runName`	`String` : nazwa uruchomienia testu
`testCount`	`int` : całkowita liczba testów w przebiegu testu

testRunStarted

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

Zgłasza początek przebiegu testowego.

Parametry
`runName`	`String` : nazwa uruchomienia testu
`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 0 i powinna zwiększać się za każdym razem, gdy nastąpi nowe uruchomienie. np. test jest ponawiany 3 razy w trybie granularnym, powinien mieć łącznie 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ą `ERROR(/System#currentTimeMillis())`

testRunZatrzymany

public void testRunStopped (long arg0)

Przebieg testu raportów został zatrzymany przed zakończeniem z powodu żądania użytkownika.

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

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

testRozpoczęty

public void testStarted (TestDescription testId, 
                long startTime)

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

Parametry
`testId`	`TestDescription` : identyfikuje test
`startTime`	`long` : czas rozpoczęcia testu, mierzony za pomocą `ERROR(/System#currentTimeMillis())`

testRozpoczęty

public void testStarted (TestDescription testId)

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

Parametry
`testId`	`TestDescription` : identyfikuje test