W 2026 r., aby dostosować się do naszego modelu stabilnego rozwoju trunk i zapewnić stabilność platformy w ekosystemie, będziemy publikować kod źródłowy w AOSP w drugim i czwartym kwartale. Do tworzenia i współtworzenia AOSP używaj gałęzi android-latest-release. Gałąź manifestu android-latest-release będzie zawsze odwoływać się do najnowszej wersji przesłanej do AOSP. Więcej informacji znajdziesz w artykule Zmiany w AOSP.

Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

ResultForwarder

public class ResultForwarder
extends Object implements ITestInvocationListener

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

Znane bezpośrednie podklasy

FilteredResultForwarder, JarHostTest.HostTestListener, LogSaverResultForwarder, LogcatCrashResultForwarder, PythonBinaryHostTest.PythonForwarder, ResultAndLogForwarder, RetryResultForwarder, ShardMainResultForwarder, TestTimeoutEnforcer

FilteredResultForwarder	Wariant `ResultForwarder`, który umożliwia zgłaszanie tylko `TestDescription` z listy dozwolonych.
JarHostTest.HostTestListener	Detektor opakowujący, który przekazuje wszystkie zdarzenia z wyjątkiem testRunStarted() i testRunEnded() do detektora osadzonego.
LogSaverResultForwarder	`ResultForwarder` do zapisywania logów za pomocą globalnego narzędzia do zapisywania plików.
LogcatCrashResultForwarder	Specjalny odbiornik: w przypadku awarii (proces instrumentacji ulega awarii) próbuje wyodrębnić z logcatu informacje o awarii i dodać je do komunikatu o błędzie powiązanego z testem.
PythonBinaryHostTest.PythonForwarder	Przekazywanie wyników, aby zastąpić nazwę uruchomienia nazwą pliku binarnego.
ResultAndLogForwarder	Przekazywanie wyników i zdarzeń z dziennika.
RetryResultForwarder	Rozszerzenie `ResultForwarder`, które zawsze przekazuje numer próby.
ShardMainResultForwarder	`ResultForwarder`, która łączy wyniki wywołań testu podzielonego na fragmenty.
TestTimeoutEnforcer	Słuchacze, którzy umożliwiają sprawdzenie czasu wykonania danego elementu testowania i przerwanie go, jeśli przekroczy on określony czas oczekiwania.

Znane podklasy pośrednie

GranularRetriableTestWrapper.StartEndCollector, ModuleResultsAndMetricsForwarder, RemoteTestTimeOutEnforcer, RetryLogSaverResultForwarder

GranularRetriableTestWrapper.StartEndCollector	Asystent zajęć, który wykrywa brakujące rozpoczęcie i zakończenie biegu.
ModuleResultsAndMetricsForwarder	Rozszerzenie `ResultAndLogForwarder`, które dodaje do wyników testu dodatkowe dane związane z modułem.
RemoteTestTimeOutEnforcer	Słuchacze, którzy umożliwiają sprawdzenie czasu wykonania danej konfiguracji testu i przerwanie go, jeśli przekroczy on określony limit czasu.
RetryLogSaverResultForwarder	Przekazuje też bieżącą próbę.

ITestInvocationListener, który przekazuje wyniki wywołania na listę innych odbiorców.

Podsumowanie

Konstruktory publiczne
`ResultForwarder(ITestInvocationListener... listeners)` Alternatywny konstruktor argumentów zmiennych dla `ResultForwarder`.
`ResultForwarder(List<ITestInvocationListener> listeners)` Utwórz `ResultForwarder`.

Konstruktory chronione
`ResultForwarder()` Utwórz `ResultForwarder` z ustawieniem odroczonego odbiornika.

Metody publiczne
`List<ITestInvocationListener>`	`getListeners()` Pobierz listę detektorów.
`TestSummary`	`getSummary()` Umożliwia interfejsowi InvocationListener zwracanie podsumowania.
`void`	`invocationEnded(long elapsedTime)` Informuje, że wywołanie zostało zakończone, niezależnie od tego, czy zakończyło się ono pomyślnie, czy 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`	`invocationSkipped(SkipReason reason)` Zgłasza wywołanie jako pominięte
`void`	`invocationStarted(IInvocationContext context)` Zgłasza rozpoczęcie wywołania testu.
`void`	`testAssumptionFailure(TestDescription test, String trace)` Wywoływana, gdy test atomowy zgłasza, że zakłada warunek, który jest fałszywy
`void`	`testAssumptionFailure(TestDescription test, FailureDescription failure)` Wywoływana, gdy test atomowy zgłasza, że zakłada warunek, który jest fałszywy
`void`	`testEnded(TestDescription test, long endTime, HashMap<String, MetricMeasurement.Metric> testMetrics)` Alternatywa dla `testEnded(TestDescription,Map)`, w której możemy bezpośrednio określić czas zakończenia.
`void`	`testEnded(TestDescription test, HashMap<String, MetricMeasurement.Metric> testMetrics)` Zgłasza zakończenie wykonania pojedynczego elementu testowania.
`void`	`testFailed(TestDescription test, FailureDescription failure)` Zgłasza niepowodzenie pojedynczego elementu testowania.
`void`	`testFailed(TestDescription test, String trace)` Zgłasza niepowodzenie pojedynczego elementu testowania.
`void`	`testIgnored(TestDescription test)` Wywoływana, gdy test nie zostanie uruchomiony, zwykle dlatego, że metoda testowa jest oznaczona adnotacją org.junit.Ignore.
`void`	`testLog(String dataName, LogDataType dataType, InputStreamSource dataStream)` Zawiera powiązane dane dziennika lub dane debugowania z wywołania testu.
`void`	`testModuleEnded()` Zgłasza zakończenie działania modułu.
`void`	`testModuleStarted(IInvocationContext moduleContext)` Zgłasza rozpoczęcie działania modułu.
`void`	`testRunEnded(long elapsedTime, HashMap<String, MetricMeasurement.Metric> runMetrics)` Zgłasza zakończenie sesji testowej.
`void`	`testRunFailed(FailureDescription failure)` Zgłasza, że nie udało się ukończyć sesji testowej z powodu błędu opisanego przez `FailureDescription`.
`void`	`testRunFailed(String errorMessage)` Zgłasza, że nie udało się ukończyć sesji testowej z powodu błędu krytycznego.
`void`	`testRunStarted(String runName, int testCount, int attemptNumber)` Zgłasza rozpoczęcie sesji testowej.
`void`	`testRunStarted(String runName, int testCount)` Zgłasza rozpoczęcie sesji testowej.
`void`	`testRunStarted(String runName, int testCount, int attemptNumber, long startTime)` Zgłasza rozpoczęcie sesji testowej.
`void`	`testRunStopped(long elapsedTime)` Zgłasza zatrzymanie sesji testowej przed zakończeniem na prośbę użytkownika.
`void`	`testSkipped(TestDescription test, SkipReason reason)` Wywoływana, gdy test jest pomijany i nie jest wykonywany z przyczyny, która zwykle nie jest oczekiwana.
`void`	`testStarted(TestDescription test, long startTime)` Alternatywa dla `testStarted(TestDescription)`, w której podajemy też datę rozpoczęcia testu, w połączeniu z `testEnded(TestDescription,long,Map)`, aby uzyskać dokładny pomiar.
`void`	`testStarted(TestDescription test)` Zgłasza rozpoczęcie pojedynczego elementu testowania.

Metody chronione
`void`	`setListeners(ITestInvocationListener... listeners)` Po zakończeniu budowy ustaw słuchawki.
`void`	`setListeners(List<ITestInvocationListener> listeners)` Po zakończeniu budowy ustaw słuchawki.

Konstruktory publiczne

ResultForwarder

public ResultForwarder (ITestInvocationListener... listeners)

Alternatywny konstruktor argumentów zmiennych dla ResultForwarder.

Parametry
`listeners`	`ITestInvocationListener`: prawdziwe adresy `ITestInvocationListener`, na które mają być przekazywane wyniki.

ResultForwarder

public ResultForwarder (List<ITestInvocationListener> listeners)

Utwórz ResultForwarder.

Parametry
`listeners`	`List`: prawdziwe adresy `ITestInvocationListener`, na które mają być przekazywane wyniki.

Konstruktory chronione

ResultForwarder

protected ResultForwarder ()

Utwórz ResultForwarder z ustawieniem odroczonego odbiornika. Przeznaczona tylko do użytku przez podklasy.

Metody publiczne

getListeners

public List<ITestInvocationListener> getListeners ()

Pobierz listę detektorów.

Zwraca
`List<ITestInvocationListener>`	Lista elementów typu `ITestInvocationListener`.

getSummary

public TestSummary getSummary ()

Umożliwia interfejsowi InvocationListener zwracanie podsumowania.

Zwraca
`TestSummary`	`TestSummary` podsumowująca bieg lub wartość null.

invocationEnded

public void invocationEnded (long elapsedTime)

Informuje, że wywołanie zostało zakończone, niezależnie od tego, czy zakończyło się ono pomyślnie, czy z powodu błędu.

Zostanie automatycznie wywołana przez platformę TradeFederation.

Parametry
`elapsedTime`	`long`: czas trwania wywołania w milisekundach.

invocationFailed

public void invocationFailed (FailureDescription failure)

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

Zostanie automatycznie wywołana przez platformę TradeFederation.

Parametry
`failure`	`FailureDescription`: `FailureDescription` opisująca przyczynę niepowodzenia.

invocationFailed

public void invocationFailed (Throwable cause)

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

Zostanie automatycznie wywołana przez platformę TradeFederation.

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

invocationSkipped

public void invocationSkipped (SkipReason reason)

Zgłasza wywołanie jako pominięte

Parametry
`reason`	`SkipReason`

invocationStarted

public void invocationStarted (IInvocationContext context)

Zgłasza rozpoczęcie wywołania testu.

Zostanie automatycznie wywołana przez platformę TradeFederation. Aby obsługiwać raportowanie z wielu urządzeń, reporterzy muszą zastąpić tę metodę.

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

testAssumptionFailure

public void testAssumptionFailure (TestDescription test, 
                String trace)

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

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

testAssumptionFailure

public void testAssumptionFailure (TestDescription test, 
                FailureDescription failure)

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

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

testEnded

public void testEnded (TestDescription test, 
                long endTime, 
                HashMap<String, MetricMeasurement.Metric> testMetrics)

Alternatywa dla testEnded(TestDescription,Map), w której możemy bezpośrednio określić czas zakończenia. Łącz z testStarted(TestDescription,long), aby uzyskać dokładne pomiary.

Parametry
`test`	`TestDescription`: identyfikuje test
`endTime`	`long`: czas zakończenia testu mierzony za pomocą `System.currentTimeMillis()`
`testMetrics`	`HashMap`: `Map` danych wygenerowanych

testEnded

public void testEnded (TestDescription test, 
                HashMap<String, MetricMeasurement.Metric> testMetrics)

Zgłasza zakończenie wykonania pojedynczego elementu testowania.

Jeśli funkcja testFailed(TestDescription, FailureDescription) nie została wywołana, test uznaje się za zaliczony. Zwraca też wszystkie dane klucz/wartość, które mogły zostać wyemitowane podczas wykonywania elementu testowania.

Parametry
`test`	`TestDescription`: identyfikuje test
`testMetrics`	`HashMap`: `Map` danych wygenerowanych

testFailed

public void testFailed (TestDescription test, 
                FailureDescription failure)

Zgłasza niepowodzenie pojedynczego elementu testowania.

Wywoływana między testStarted a testEnded.

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

testFailed

public void testFailed (TestDescription test, 
                String trace)

Zgłasza niepowodzenie pojedynczego elementu testowania.

Wywoływana między testStarted a testEnded.

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

testIgnored

public void testIgnored (TestDescription test)

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

Parametry
`test`	`TestDescription`: identyfikuje test

testLog

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

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

Musi być wywołana przed ERROR(ITestInvocationListener.invocationFailed(Throwable)/ITestInvocationListener#invocationFailed(java.lang.Throwable) ITestInvocationListener.invocationFailed(Throwable)) lub ERROR(/ITestInvocationListener#invocationEnded(long))

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

Parametry
`dataName`	`String`: opisowa nazwa danych, np. „device_logcat”.`String` Uwaga: parametr dataName może nie być unikalny w przypadku każdego wywołania. Oznacza to, że osoby wdrażające muszą być w stanie obsłużyć wiele wywołań z tą samą nazwą dataName.
`dataType`	`LogDataType`: `LogDataType` danych
`dataStream`	`InputStreamSource`: `InputStreamSource` danych. Osoby wdrażające powinny wywołać funkcję createInputStream, aby rozpocząć odczytywanie danych, i po zakończeniu zamknąć wynikowy strumień InputStream. Wywołujący powinni zadbać o to, aby źródło danych było dostępne do momentu zakończenia działania metody testLog.

testModuleEnded

public void testModuleEnded ()

Zgłasza zakończenie działania modułu.

testModuleStarted

public void testModuleStarted (IInvocationContext moduleContext)

Zgłasza rozpoczęcie działania modułu. Ten wywołanie zwrotne jest powiązane z elementem testModuleEnded() i jest opcjonalne w sekwencji. Jest używany tylko podczas uruchamiania modułów: narzędzi uruchamiających opartych na pakietach.

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

testRunEnded

public void testRunEnded (long elapsedTime, 
                HashMap<String, MetricMeasurement.Metric> runMetrics)

Zgłasza zakończenie sesji testowej. FIXME: Nie możemy mieć dwóch interfejsów Map<> z różnymi typami, więc musimy tutaj użyć HashMap.

Parametry
`elapsedTime`	`long`: czas, który upłynął od ostatniego zgłoszenia przez urządzenie (w milisekundach)
`runMetrics`	`HashMap`: pary klucz/wartość zgłaszane na zakończenie sesji testowej z parametrem `Metric`.

testRunFailed

public void testRunFailed (FailureDescription failure)

Zgłasza, że nie udało się ukończyć sesji testowej z powodu błędu opisanego przez FailureDescription.

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

testRunFailed

public void testRunFailed (String errorMessage)

Zgłasza, że nie udało się ukończyć sesji testowej z powodu błędu krytycznego.

Parametry
`errorMessage`	`String`: `String` opisuje przyczynę niepowodzenia uruchomienia.

testRunStarted

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

Zgłasza rozpoczęcie sesji testowej.

Parametry
`runName`	`String`: nazwa sesji testowej
`testCount`	`int`: łączna liczba testów podczas sesji testowej
`attemptNumber`	`int`: numer zamówienia, który identyfikuje różne próby tego samego uruchomienia runName wykonywanego wielokrotnie. Numer próby jest indeksowany od 0 i powinien zwiększać się za każdym razem, gdy następuje nowe uruchomienie. Przykład: test jest ponownie uruchamiany 3 razy, więc powinien mieć łącznie 4 uruchomienia pod tą samą nazwą uruchomienia, a numer próby powinien wynosić od 0 do 3.

testRunStarted

public void testRunStarted (String runName, 
                int testCount)

Zgłasza rozpoczęcie sesji testowej.

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

testRunStarted

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

Zgłasza rozpoczęcie sesji testowej.

Parametry
`runName`	`String`: nazwa sesji testowej
`testCount`	`int`: łączna liczba testów podczas sesji testowej
`attemptNumber`	`int`: numer zamówienia, który identyfikuje różne próby tego samego uruchomienia runName wykonywanego wielokrotnie. Wartość attemptNumber jest indeksowana od zera i powinna zwiększać się za każdym razem, gdy następuje nowe uruchomienie. Na przykład jeśli test jest ponownie uruchamiany 3 razy, powinien mieć łącznie 4 uruchomienia pod tą samą nazwą runName, a wartość attemptNumber powinna wynosić od 0 do 3.
`startTime`	`long`: czas rozpoczęcia uruchomienia mierzony za pomocą `System.currentTimeMillis()`

testRunStopped

public void testRunStopped (long elapsedTime)

Zgłasza zatrzymanie sesji testowej przed zakończeniem na prośbę użytkownika.

TODO: obecnie nieużywane, rozważ usunięcie

Parametry
`elapsedTime`	`long`: czas, który upłynął od ostatniego zgłoszenia przez urządzenie (w milisekundach)

testSkipped

public void testSkipped (TestDescription test, 
                SkipReason reason)

Wywoływana, gdy test jest pomijany i nie jest wykonywany z przyczyny, która zwykle nie jest oczekiwana. Te testy będą ponawiane, aby uzyskać prawidłowe wykonanie.

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

testStarted

public void testStarted (TestDescription test, 
                long startTime)

Alternatywa dla testStarted(TestDescription), w której podajemy też datę rozpoczęcia testu, w połączeniu z testEnded(TestDescription,long,Map), aby uzyskać dokładny pomiar.

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

testStarted

public void testStarted (TestDescription test)

Zgłasza rozpoczęcie pojedynczego elementu testowania. Jest to starszy interfejs; o ile to możliwe, używaj testStarted(TestDescription).

Parametry
`test`	`TestDescription`: identyfikuje test

Metody chronione

setListeners

protected void setListeners (ITestInvocationListener... listeners)

Po zakończeniu budowy ustaw słuchawki. Przeznaczona tylko do użytku przez podklasy.

Parametry
`listeners`	`ITestInvocationListener`: prawdziwe adresy `ITestInvocationListener`, na które mają być przekazywane wyniki.

setListeners

protected void setListeners (List<ITestInvocationListener> listeners)

Po zakończeniu budowy ustaw słuchawki. Przeznaczona tylko do użytku przez podklasy.

Parametry
`listeners`	`List`: prawdziwe adresy `ITestInvocationListener`, na które mają być przekazywane wyniki.