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

SubprocessResultsReporter

public class SubprocessResultsReporter
extends Object implements ILogSaverListener, ISupportGranularResults, ITestInvocationListener

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

Znane podklasy bezpośrednie

LegacySubprocessResultsReporter

LegacySubprocessResultsReporter zamrożoną implementację raportera wyników podprocesu, która powinna być zgodna z wcześniejszymi wersjami TF/CTS (np. 8 i nowszymi), pomimo zmian w superklasie.

Implementuje funkcję ITestInvocationListener, która ma być określona jako parametr result_reporter, a następnie przekazuje z podprocesu wyniki testów, uruchomienia testów i wywołania testów.

Podsumowanie

Konstruktory publiczne
`SubprocessResultsReporter()`

Metody publiczne
`void`	`close()`
`TestSummary`	`getSummary()` Umożliwia wywołaniu InvocationListener zwrócenie podsumowania.
`void`	`invocationEnded(long elapsedTime)` Raportuje, że wywołanie zostało zakończone pomyślnie lub z powodu jakiegoś 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`	`invocationStarted(IInvocationContext context)` Raportuje rozpoczęcie wywołania testu.
`void`	`logAssociation(String dataName, LogFile logFile)` W niektórych przypadkach log musi być silnie powiązany z przypadkami testowymi, ale nie można tego zrobić bezpośrednio w wywołaniu `testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile)`.
`void`	`printEvent(String key, Object event)` Funkcja pomocnicza do drukowania klucza zdarzenia, a potem obiektu JSON.
`void`	`setOutputTestLog(boolean outputTestLog)` Określa, czy test ma być zapisany.
`boolean`	`supportGranularResults()` Zwraca wartość „True” (Prawda), jeśli raportujący obsługuje szczegółowe wyniki, w przeciwnym razie zwraca wartość „False” (Fałsz).
`void`	`testAssumptionFailure(TestDescription testId, String trace)` Wywoływany, gdy test atomowy sygnalizuje, że przyjmuje założenie, że warunek jest fałszywy.
`void`	`testAssumptionFailure(TestDescription testId, FailureDescription failure)` Wywoływany, gdy test atomowy sygnalizuje, że przyjmuje założenie, że warunek jest fałszywy.
`void`	`testEnded(TestDescription testId, long endTime, metrics)` Alternatywa dla metody `ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map))`, w której można bezpośrednio podać godzinę zakończenia.
`void`	`testEnded(TestDescription testId, metrics)` Raportuje koniec wykonania danego przypadku testowego.
`void`	`testFailed(TestDescription testId, FailureDescription failure)` Raportuje niepowodzenie pojedynczego przypadku testowego.
`void`	`testFailed(TestDescription testId, String reason)` Raportuje niepowodzenie pojedynczego przypadku testowego.
`void`	`testIgnored(TestDescription testId)` Wywoływany, gdy test nie zostanie uruchomiony, zwykle dlatego, że metoda testu jest oznaczona adnotacją org.junit.Ignore.
`void`	`testLog(String dataName, LogDataType dataType, InputStreamSource dataStream)` Zawiera powiązane dane dziennika lub debugowania z wywołania testu.
`void`	`testModuleEnded()` Raportuje koniec wykonania modułu.
`void`	`testModuleStarted(IInvocationContext moduleContext)` zgłasza rozpoczęcie działania modułu.
`void`	`testRunEnded(long time, runMetrics)` Raportuje zakończenie testu.
`void`	`testRunFailed(FailureDescription failure)` Nie udało się przeprowadzić testu raportów z powodu błędu opisanego w `FailureDescription`.
`void`	`testRunFailed(String reason)` Nie udało się przeprowadzić testu raportów z powodu krytycznego błędu.
`void`	`testRunStarted(String runName, int testCount, int attemptNumber)` Raportuje rozpoczęcie testu.
`void`	`testRunStarted(String runName, int testCount)` Raportuje rozpoczęcie testu.
`void`	`testRunStarted(String runName, int testCount, int attemptNumber, long startTime)` Raportuje rozpoczęcie testu.
`void`	`testRunStopped(long arg0)` Raporty o testach, które zostały przerwane przed zakończeniem na prośbę użytkownika.
`void`	`testSkipped(TestDescription testId, SkipReason reason)` Wywoływane, gdy test został pominięty i nie został wykonany z przyczyn, które zwykle nie są oczekiwane.
`void`	`testStarted(TestDescription testId, long startTime)` Alternatywa dla parametru `testStarted(com.android.tradefed.result.TestDescription)`, w przypadku którego określamy również datę rozpoczęcia testu, w połączeniu z parametrem `ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,Map))`, aby zapewnić dokładny pomiar.
`void`	`testStarted(TestDescription testId)` Raportuje początek pojedynczego przypadku testowego.

Konstruktory publiczne

SubprocessResultsReporter

public SubprocessResultsReporter ()

Metody publiczne

zamknij

public void close ()

getPodsumowanie

public TestSummary getSummary ()

Umożliwia wywołaniu InvocationListener zwrócenie podsumowania.

Zwroty
`TestSummary`	`TestSummary` podsumowujący wykonanie, lub wartość null.

invocationEnded

public void invocationEnded (long elapsedTime)

Raport o zakończeniu wywołania (z powodu błędu lub bez błędu).

Będzie wywoływany automatycznie przez platformę TradeFederation.

Parametry
`elapsedTime`	`long`: upłynął czas wywołania w ms

invocationFailed

public void invocationFailed (FailureDescription failure)

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

Będzie wywoływany automatycznie przez platformę TradeFederation.

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

invocationFailed

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 niepowodzenia `Throwable`

invocationStarted

public void invocationStarted (IInvocationContext context)

Raportuje rozpoczęcie wywołania testu.

Będzie wywoływany automatycznie przez platformę TradeFederation. Raportujący muszą zastąpić tę metodę, aby zapewnić obsługę raportowania dotyczącego wielu urządzeń.

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

powiązanie_logowania

public void logAssociation (String dataName, 
                LogFile logFile)

W niektórych przypadkach log musi być silnie powiązany z przypadkami testowymi, ale nie można tego zrobić bezpośrednio w wywołaniu testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile). Dzięki temu wywołaniu zwrotnemu można wyraźnie powiązać dane.

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

printEvent

public void printEvent (String key, 
                Object event)

Funkcja pomocnicza do drukowania klucza zdarzenia, a potem obiektu JSON.

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

setOutputTestLog

public void setOutputTestLog (boolean outputTestLog)

Określa, czy zarejestrowany test ma być generowany.

Parametry
`outputTestLog`	`boolean`

supportGranularResults

public boolean supportGranularResults ()

Zwraca wartość Prawda, jeśli reporter obsługuje szczegółowe wyniki. W przeciwnym razie zwraca wartość Fałsz.

Zwroty
`boolean`

testAssumptionFailure

public void testAssumptionFailure (TestDescription testId, 
                String trace)

Wywoływany, gdy test atomowy sygnalizuje, że przyjmuje założenie, że warunek jest fałszywy.

Parametry
`testId`	`TestDescription`: identyfikuje test
`trace`	`String`: zrzut stosu błędu

testAssumptionFailure

public void testAssumptionFailure (TestDescription testId, 
                FailureDescription failure)

Wywoływany, gdy test atomowy sygnalizuje, że przyjmuje założenie, że warunek jest fałszywy.

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

testEnded

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. Aby uzyskać dokładne pomiary, połącz je z elementem testStarted(com.android.tradefed.result.TestDescription, long).

Parametry
`testId`	`TestDescription`: identyfikuje test
`endTime`	`long`: czas zakończenia testu mierzony za pomocą `System.currentTimeMillis()`
`metrics`	: `ERROR(/Map)` danych wyemitowanych

testZakończony

public void testEnded (TestDescription testId, 
                 metrics)

Raportuje zakończenie wykonywania pojedynczego przypadku testu.

Jeśli funkcja testFailed(TestDescription, FailureDescription) nie została wywołana, test się powiedzie. Zwraca również wszystkie wskaźniki klucz-wartość, które mogły zostać wygenerowane podczas wykonywania przypadku testowego.

Parametry
`testId`	`TestDescription`: identyfikuje test
`metrics`	: `ERROR(/Map)` wyemitowanych wskaźników

testFailed

public void testFailed (TestDescription testId, 
                FailureDescription failure)

Raportuje niepowodzenie pojedynczego przypadku testowego.

Jest wywoływany między testStarted i testEnded.

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

testFailed

public void testFailed (TestDescription testId, 
                String reason)

Raportuje niepowodzenie pojedynczego przypadku testowego.

Jest wywoływany między testStarted i testEnded.

Parametry
`testId`	`TestDescription`: identyfikuje test
`reason`	`String`: zrzut stosu błędu

testIgnored

public void testIgnored (TestDescription testId)

Wywoływany, gdy test nie zostanie uruchomiony, zwykle dlatego, że metoda testu jest oznaczona adnotacją org.junit.Ignore.

Parametry
`testId`	`TestDescription`: identyfikuje test

testLog

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

Zawiera powiązane dane dziennika lub debugowania z wywołania testu.

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

Framework TradeFederation automatycznie wywoła tę metodę, podając log hosta i w razie potrzeby logcat urządzenia.

Parametry
`dataName`	`String`: `String`nazwa opisowa danych, np. „device_logcat”. Uwaga: właściwość dataName nie może być unikalna w ramach pojedynczego wywołania, np. implementacje muszą być w stanie obsługiwać wiele wywołań z tą samą wartością dataName
`dataType`	`LogDataType`: `LogDataType` danych
`dataStream`	`InputStreamSource`: `InputStreamSource` danych. Implementatorzy powinni wywołać createInputStream, aby rozpocząć odczytywanie danych, i upewnić się, że zamkną powstały strumień wejściowy po zakończeniu. Osoby wywołujące tę metodę powinny zadbać o to, aby źródło danych było dostępne do momentu zakończenia metody testLog.

testModuleEnded

public void testModuleEnded ()

Raportuje koniec wykonania modułu.

testModuleStarted

public void testModuleStarted (IInvocationContext moduleContext)

zgłasza rozpoczęcie działania modułu. To wywołanie zwrotne jest powiązane z testModuleEnded() i jest opcjonalne w sekwencji. Jest używany tylko podczas wykonywania testu, który korzysta z modułów: modułów opartych na zestawach.

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

testRunEnded

public void testRunEnded (long time, 
                 runMetrics)

Koniec testu raportów.

Parametry
`time`	`long`: czas upłynął, milisekundy zgłoszone przez urządzenie
`runMetrics`	: pary klucz-wartość zgłoszone na końcu wykonania testu

Niepowodzenie testu uruchomienia

public void testRunFailed (FailureDescription failure)

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

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

testRunFailed

public void testRunFailed (String reason)

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

Parametry
`reason`	`String`: `String` opisujący przyczynę niepowodzenia wykonania.

testRunStarted

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

Raportuje rozpoczęcie testu.

Parametry
`runName`	`String`: nazwa testu;
`testCount`	`int`: łączna liczba testów w teście
`attemptNumber`	`int`: numer zamówienia, który identyfikuje różne próby tego samego runName, które są wykonywane wielokrotnie. attemptNumber ma indeks 0 i powinien zwiększać się za każdym razem, gdy następuje nowe wykonanie. Przykład: test jest powtarzany 3 razy, więc powinien mieć łącznie 4 wykonania pod tym samym runName, a attemptNumber będzie miał wartość od 0 do 3.

Uruchomiono test

public void testRunStarted (String runName, 
                int testCount)

Raportuje rozpoczęcie testu.

Parametry
`runName`	`String`: nazwa testu;
`testCount`	`int`: łączna liczba testów w sesji testowej

Uruchomiono test

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

Raportuje rozpoczęcie testu.

Parametry
`runName`	`String`: nazwa testu;
`testCount`	`int`: łączna liczba testów w teście
`attemptNumber`	`int`: numer zamówienia, który identyfikuje różne próby tego samego runName, które są wykonywane wielokrotnie. attemptNumber ma indeks 0 i powinien zwiększać się za każdym razem, gdy następuje nowe uruchomienie. Przykład: test jest szczegółowo powtarzany 3 razy, więc powinien mieć łącznie 4 uruchomienia pod tym samym runName, a attemptNumber powinien mieć wartość od 0 do 3.
`startTime`	`long`: czas rozpoczęcia wykonywania zadania, mierzony za pomocą `System.currentTimeMillis()`

testRunStopped

public void testRunStopped (long arg0)

Raporty o testach, które zostały przerwane przed zakończeniem na prośbę użytkownika.

TODO: currently unused, consider removing

Parametry
`arg0`	`long`: czas upłynął, milisekundy zgłoszone przez urządzenie

testSkipped

public void testSkipped (TestDescription testId, 
                SkipReason reason)

Wywoływany, gdy test jest pomijany i nie jest wykonywany z nieoczekiwanego powodu. Spróbujemy wykonać te testy jeszcze raz, aby uzyskać prawidłowe wykonanie.

Parametry
`testId`	`TestDescription`: identyfikuje test
`reason`	`SkipReason`: `SkipReason`

testStarted

public void testStarted (TestDescription testId, 
                long startTime)

Alternatywa dla testStarted(com.android.tradefed.result.TestDescription), w której określamy też, kiedy test się rozpoczął, w połączeniu z ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,Map)), aby uzyskać dokładne wyniki.

Parametry
`testId`	`TestDescription`: identyfikuje test
`startTime`	`long`: czas rozpoczęcia testu mierzony za pomocą funkcji `System.currentTimeMillis()`

testStarted

public void testStarted (TestDescription testId)

Raportuje rozpoczęcie indywidualnego przypadku testowego. Starszy interfejs, którego należy używać w miarę możliwości w przypadku testStarted(com.android.tradefed.result.TestDescription).

Parametry
`testId`	`TestDescription`: identyfikuje test