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 wywołania podzielonego na kilka zasobów do działania równoległego) i przekazuje je innemu odbiorcy.

Podsumowanie

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

Metody publiczne
	`getUnderlyingResultReporter()`
`void`	`invocationEnded(long elapsedTime)` Informuje, że wywołanie zostało zakończone (z powodu błędu lub pomyślnie).
`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)` zgłasza rozpoczęcie działania modułu.
`void`	`testRunEnded(long elapsedTime, 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 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ć przesłane. Aby zapobiec kolizji z innymi obiektami `ShardListener`, ten obiekt będzie synchronizowany z usługą `main` podczas przesyłania wyników. Wyniki zostaną wysłane dopiero po zakończeniu wywołania.

Metody publiczne

getUnderlyingResultReporter

public  getUnderlyingResultReporter ()

Zwroty

invocationEnded

public void invocationEnded (long elapsedTime)

Informuje, że wywołanie zostało zakończone (z powodu błędu lub pomyślnie).

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 wywoływany automatycznie przez platformę TradeFederation.

Parametry
`cause`	`Throwable`: przyczyna niepowodzenia `Throwable`

invocationSkipped

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. Aby umożliwić raportowanie z kilku urządzeń, autorzy raportów muszą zastąpić tę metodę.

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 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 testowym.

setSupportGranularResults

public void setSupportGranularResults (boolean enableGranularResults)

Parametry
`enableGranularResults`	`boolean`

supportGranularResults

public boolean supportGranularResults ()

Zwraca wartość „True” (Prawda), jeśli raportujący obsługuje szczegółowe wyniki, w przeciwnym razie zwraca wartość „False” (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.

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: nazwa danych może nie być unikalna dla każdego wywołania. Oznacza to, że implementatorzy muszą mieć możliwość obsługi wielu wywołań z tą samą nazwą danych.
`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.

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)

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 elapsedTime, 
                 runMetrics)

Raportuje zakończenie testu.

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.

testRunStarted

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

Raportuje rozpoczęcie testu.

Parametry
`name`	`String`: nazwa 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. 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 nazwą runName, a wartość attemptNumber powinna się zmieniać od 0 do 3.
`startTime`	`long`: czas rozpoczęcia wykonywania zadania, mierzony za pomocą `System.currentTimeMillis()`