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

ShardListener

public class ShardListener
extends CollectingTestListener implements ISupportGranularResults

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

ITestInvocationListener, który zbiera wyniki z fragmentu wywołania (czyli podział wywołań, aby działać równolegle na wielu zasobach), i przekierowuje je do innego detektora.

Podsumowanie

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

Metody publiczne
	`getUnderlyingResultReporter()`
`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`	`invocationSkipped(SkipReason reason)` Zgłasza wywołanie jako pominięte
`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`	`setSupportGranularResults(boolean enableGranularResults)`
`boolean`	`supportGranularResults()` Zwraca wartość „True” (Prawda), jeśli raportujący obsługuje szczegółowe wyniki, w przeciwnym razie zwraca wartość „False” (Fałsz).
`void`	`testLog(String dataName, LogDataType dataType, InputStreamSource dataStream)` Zawiera powiązane dane dziennika lub debugowania z wywołania testu.
`void`	`testLogSaved(String dataName, LogDataType dataType, InputStreamSource dataStream, LogFile logFile)`
`void`	`testModuleEnded()` Raportuje koniec wykonania modułu.
`void`	`testModuleStarted(IInvocationContext moduleContext)` Raportuje początek uruchomionego modułu.
`void`	`testRunEnded(long elapsedTime, runMetrics)` Koniec testu raportów.
`void`	`testRunFailed(FailureDescription failure)` Nie udało się przeprowadzić testu raportów z powodu błędu opisanego w `FailureDescription`.
`void`	`testRunFailed(String failureMessage)` Nie udało się przeprowadzić testu raportów z powodu krytycznego błędu.
`void`	`testRunStarted(String name, int numTests, int attemptNumber, long startTime)` Raportuje rozpoczęcie testu.

Konstruktory publiczne

ShardListener

public ShardListener (ITestInvocationListener main)

Utwórz ShardListener.

Parametry
`main`	`ITestInvocationListener`: `ITestInvocationListener` wyników, które mają zostać przekazane. Aby zapobiec kolizjom z innymi obiektami `ShardListener`, ten obiekt zostanie zsynchronizowany `main` podczas przekazywania wyników. Wyniki będą wysyłane dopiero po zakończeniu fragmentu kodu wywołania.

Metody publiczne

getUnderlyingResultReporter

public  getUnderlyingResultReporter ()

Zwroty

invocationEnded

public void invocationEnded (long elapsedTime)

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

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

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

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

Wywołanie pominięte

public void invocationSkipped (SkipReason reason)

zgłasza wywołanie jako pominięte;

Parametry
`reason`	`SkipReason`

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 przypadkiem testowym, ale nie można tego zrobić w przypadku bezpośredniego wywołania zwrotnego 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.

setSupportGranularResults

public void setSupportGranularResults (boolean enableGranularResults)

Parametry
`enableGranularResults`	`boolean`

supportGranularResults

public boolean supportGranularResults ()

Zwraca wartość Prawda, jeśli raportujący obsługuje szczegółowe wyniki, w przeciwnym razie zwraca wartość Fałsz.

Zwroty
`boolean`

testLog

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

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

Wymagane wywołanie 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: imię i nazwisko może nie być unikalne w przypadku każdego wywołania. Oznacza to, że implementatorzy muszą mieć możliwość obsługi wielu wywołań z tym samym imieniem i nazwiskiem.
`dataType`	`LogDataType`: `LogDataType` danych
`dataStream`	`InputStreamSource`: element `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.

testLogSaved

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

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

testModuleEnded

public void testModuleEnded ()

Raportuje koniec wykonania modułu.

testModuleStarted

public void testModuleStarted (IInvocationContext moduleContext)

Raportuje początek uruchomionego modułu. To wywołanie zwrotne jest powiązane z testModuleEnded() i jest opcjonalne w sekwencji. Jest używany tylko podczas uruchomienia, w którym używane są moduły: aplikacje biegowe oparte na pakiecie.

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

testRunEnded

public void testRunEnded (long elapsedTime, 
                 runMetrics)

Koniec testu raportów.

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

testRunFailed

public void testRunFailed (FailureDescription failure)

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

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

testRunFailed

public void testRunFailed (String failureMessage)

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

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

Uruchomiono test

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

Raportuje rozpoczęcie testu.

Parametry
`name`	`String`: nazwa uruchomienia testu
`numTests`	`int`: łączna liczba testów w sesji testowej
`attemptNumber`	`int`: numer zamówienia, który identyfikuje różne próby tego samego runName, które są wykonywane wielokrotnie. Wartość orderNumber ma wartość 0 zindeksowana i powinna wzrastać przy każdym nowym uruchomieniu. Na przykład: 3 próby są szczegółowo ponawiane, powinny mieć łącznie 4 uruchomienia z tą samą nazwą uruchomienia, a wartość orderNumber musi mieścić się w przedziale od 0 do 3.
`startTime`	`long`: czas rozpoczęcia wykonywania zadania, mierzony za pomocą `System.currentTimeMillis()`