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

ShardListener

public class ShardListener
extends CollectingTestListener implements ISupportGranularResults

java.lang.Obiekt
↳	com.android.tradefed.result.CollectingTestListener
	↳	com.android.tradefed.invoker.ShardListener

ITestInvocationListener , który zbiera wyniki z fragmentu wywołania (znanego również jako podział wywołania do uruchamiania na wielu zasobach równolegle) i przekazuje je do innego odbiornika.

Streszczenie

Konstruktory publiczne
`ShardListener ( ITestInvocationListener main)` Utwórz `ShardListener` .

Metody publiczne
	`getUnderlyingResultReporter ()`
`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`	`setSupportGranularResults (boolean enableGranularResults)`
`boolean`	`supportGranularResults ()` Zwraca True, jeśli reporter obsługuje szczegółowe wyniki, w przeciwnym razie zwraca false.
`void`	`testLog (String dataName, LogDataType dataType, InputStreamSource dataStream)` Udostępnia powiązane dane dziennika lub debugowania z wywołania testowego.
`void`	`testLogSaved (String dataName, LogDataType dataType, InputStreamSource dataStream, LogFile logFile)`
`void`	`testModuleEnded ()` Zgłasza koniec uruchomienia modułu.
`void`	`testModuleStarted ( IInvocationContext moduleContext)` Zgłasza początek uruchomionego modułu.
`void`	`testRunEnded (long elapsedTime, runMetrics)` `testRunEnded (long elapsedTime, 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 failureMessage)` Testowanie raportów nie zostało ukończone z powodu błędu krytycznego.
`void`	`testRunStarted (String name, int numTests, int attemptNumber, long startTime)` Zgłasza początek przebiegu testowego.

Konstruktory publiczne

ShardListener

public ShardListener (ITestInvocationListener main)

Utwórz ShardListener .

Parametry
`main`	`ITestInvocationListener` : `ITestInvocationListener` wyniki powinny zostać przesłane. Aby zapobiec kolizjom z innymi `ShardListener` s, ten obiekt będzie synchronizowany na `main` podczas przekazywania wyników. A wyniki zostaną wysłane dopiero po zakończeniu fragmentu wywołania.

Metody publiczne

getUnderlyingResultReporter

public  getUnderlyingResultReporter ()

Zwroty

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.

setWsparcieSzczegółowe wyniki

public void setSupportGranularResults (boolean enableGranularResults)

Parametry
`enableGranularResults`	`boolean`

wsparcieSzczegółoweWyniki

public boolean supportGranularResults ()

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

Zwroty
`boolean`

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.

testLogZapisano

public void testLogSaved (String dataName, 
                LogDataType dataType, 
                InputStreamSource dataStream, 
                LogFile logFile)

Parametry
`dataName`	`String`
`dataType`	`LogDataType`
`dataStream`	`InputStreamSource`
`logFile`	`LogFile`

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 elapsedTime, 
                 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
`elapsedTime`	`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 failureMessage)

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

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

testRunStarted

public void testRunStarted (String name, 
                int numTests, 
                int attemptNumber, 
                long startTime)

Zgłasza początek przebiegu testowego.

Parametry
`name`	`String` : nazwa uruchomienia testu
`numTests`	`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())`