Ab 2026 werden wir den Quellcode im 2. und 4. Quartal in AOSP veröffentlichen, um unser trunk-stable-Entwicklungsmodell zu unterstützen und die Plattformstabilität für das Ökosystem zu gewährleisten. Für die Entwicklung und das Beitragen zu AOSP empfehlen wir die Verwendung von android-latest-release anstelle von aosp-main. Der Manifestzweig android-latest-release verweist immer auf das neueste Release, das an AOSP übertragen wurde. Weitere Informationen finden Sie unter Änderungen an AOSP.

ResultForwarder

public class ResultForwarder
extends Object implements ITestInvocationListener

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

Bekannte direkte Unterklassen

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

FilteredResultForwarder	Variante von `ResultForwarder`, bei der nur eine Zulassungsliste von `TestDescription` gemeldet werden kann.
JarHostTest.HostTestListener	Wrapper-Listener, der alle Ereignisse mit Ausnahme von testRunStarted() und testRunEnded() an den eingebetteten Listener weiterleitet.
LogSaverResultForwarder	Ein `ResultForwarder` zum Speichern von Logs mit dem globalen Dateispeichermodul.
LogcatCrashResultForwarder	Spezifischer Listener: Bei Fehlern (Absturz des Instrumentierungsprozesses) wird versucht, den Absturz aus dem Logcat zu extrahieren und der Fehlermeldung hinzuzufügen, die mit dem Test verknüpft ist.
PythonBinaryHostTest.PythonForwarder	Ergebnis-Forwarder, um den Ausführungsnamen durch den Binärnamen zu ersetzen.
ResultAndLogForwarder	Forwarder für Ergebnisse und Log-Ereignisse.
RetryResultForwarder	Eine Erweiterung von `ResultForwarder`, die immer auf eine bestimmte Versuchsnummer verweist.
ShardMainResultForwarder	Ein `ResultForwarder`, das die Ergebnisse von fragmentierten Testaufrufen kombiniert.
TestTimeoutEnforcer	Listener, mit denen die Ausführungszeit eines bestimmten Testlaufs geprüft und der Testlauf als fehlgeschlagen markiert werden kann, wenn ein bestimmtes Zeitlimit überschritten wird.

Bekannte indirekte Unterklassen

GranularRetriableTestWrapper.StartEndCollector, ModuleResultsAndMetricsForwarder, RemoteTestTimeOutEnforcer, RetryLogSaverResultForwarder

GranularRetriableTestWrapper.StartEndCollector	Klassenhelfer, um fehlende Laufstarts und ‑enden zu erkennen.
ModuleResultsAndMetricsForwarder	Eine Erweiterung von `ResultAndLogForwarder`, die den Testergebnissen zusätzliche modulbezogene Messwerte hinzufügt.
RemoteTestTimeOutEnforcer	Listener, mit denen die Ausführungszeit einer bestimmten Testkonfiguration geprüft und der Test fehlgeschlagen werden kann, wenn ein bestimmtes Zeitlimit überschritten wird.
RetryLogSaverResultForwarder	Forwarder, der auch den aktuellen Versuch weiterleitet.

Ein ITestInvocationListener, das Aufrufergebnisse an eine Liste anderer Listener weiterleitet.

Zusammenfassung

Öffentliche Konstruktoren
`ResultForwarder(ITestInvocationListener... listeners)` Alternativer Konstruktor mit variabler Argumentliste für `ResultForwarder`.
`ResultForwarder( listeners)` Erstellen Sie ein `ResultForwarder`.

Geschützte Konstruktoren
`ResultForwarder()` Erstellt eine `ResultForwarder` mit der Einstellung für verzögerte Listener.

Öffentliche Methoden
	`getListeners()` Liste der Listener abrufen
`TestSummary`	`getSummary()` Ermöglicht dem InvocationListener, eine Zusammenfassung zurückzugeben.
`void`	`invocationEnded(long elapsedTime)` Meldet, dass der Aufruf beendet wurde, unabhängig davon, ob dies erfolgreich oder aufgrund eines Fehlerzustands geschehen ist.
`void`	`invocationFailed(FailureDescription failure)` Meldet einen unvollständigen Aufruf aufgrund eines Fehlerzustands.
`void`	`invocationFailed(Throwable cause)` Meldet einen unvollständigen Aufruf aufgrund eines Fehlerzustands.
`void`	`invocationSkipped(SkipReason reason)` Meldet einen Aufruf als übersprungen
`void`	`invocationStarted(IInvocationContext context)` Meldet den Beginn des Testaufrufs.
`void`	`testAssumptionFailure(TestDescription test, String trace)` Wird aufgerufen, wenn bei einem atomaren Test eine Bedingung als falsch angenommen wird
`void`	`testAssumptionFailure(TestDescription test, FailureDescription failure)` Wird aufgerufen, wenn bei einem atomaren Test eine Bedingung als falsch angenommen wird
`void`	`testEnded(TestDescription test, long endTime, testMetrics)` Alternative zu `ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map))`, mit der wir die Endzeit direkt angeben können.
`void`	`testEnded(TestDescription test, testMetrics)` Meldet das Ende der Ausführung eines einzelnen Testlaufs.
`void`	`testFailed(TestDescription test, FailureDescription failure)` Meldet das Fehlschlagen eines einzelnen Testlaufs.
`void`	`testFailed(TestDescription test, String trace)` Meldet das Fehlschlagen eines einzelnen Testlaufs.
`void`	`testIgnored(TestDescription test)` Wird aufgerufen, wenn ein Test nicht ausgeführt wird, in der Regel, weil eine Testmethode mit „org.junit.Ignore“ annotiert ist.
`void`	`testLog(String dataName, LogDataType dataType, InputStreamSource dataStream)` Stellt die zugehörigen Protokoll- oder Debugging-Daten aus dem Testaufruf bereit.
`void`	`testModuleEnded()` Meldet das Ende einer Modulausführung.
`void`	`testModuleStarted(IInvocationContext moduleContext)` Meldet den Beginn der Ausführung eines Moduls.
`void`	`testRunEnded(long elapsedTime, runMetrics)` Meldet das Ende des Testlaufs.
`void`	`testRunFailed(FailureDescription failure)` Der Testlauf für Berichte konnte aufgrund eines Fehlers, der durch `FailureDescription` beschrieben wird, nicht abgeschlossen werden.
`void`	`testRunFailed(String errorMessage)` Der Testlauf für Berichte konnte aufgrund eines schwerwiegenden Fehlers nicht abgeschlossen werden.
`void`	`testRunStarted(String runName, int testCount, int attemptNumber)` Meldet den Beginn eines Testlaufs.
`void`	`testRunStarted(String runName, int testCount)` Meldet den Beginn eines Testlaufs.
`void`	`testRunStarted(String runName, int testCount, int attemptNumber, long startTime)` Meldet den Beginn eines Testlaufs.
`void`	`testRunStopped(long elapsedTime)` Der Testlauf für Berichte wurde aufgrund einer Nutzeranfrage vor Abschluss beendet.
`void`	`testSkipped(TestDescription test, SkipReason reason)` Wird aufgerufen, wenn ein Test übersprungen wird und aus einem Grund, der normalerweise nicht erwartet wird, nicht ausgeführt wurde.
`void`	`testStarted(TestDescription test, long startTime)` Alternative zu `testStarted(com.android.tradefed.result.TestDescription)`, bei der wir auch angeben, wann der Test gestartet wurde, in Kombination mit `ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,Map))` für eine genaue Messung.
`void`	`testStarted(TestDescription test)` Meldet den Beginn eines einzelnen Testlaufs.

Geschützte Methoden
`void`	`setListeners(ITestInvocationListener... listeners)` Legen Sie die Listener nach der Erstellung fest.
`void`	`setListeners( listeners)` Legen Sie die Listener nach der Erstellung fest.

Öffentliche Konstruktoren

ResultForwarder

public ResultForwarder (ITestInvocationListener... listeners)

Alternativer Konstruktor mit variabler Argumentliste für ResultForwarder.

Parameter
`listeners`	`ITestInvocationListener`: die echten `ITestInvocationListener`s, an die Ergebnisse weitergeleitet werden sollen

ResultForwarder

public ResultForwarder ( listeners)

Erstellen Sie ein ResultForwarder.

Parameter
`listeners`	: die echten `ITestInvocationListener`s, an die Ergebnisse weitergeleitet werden sollen

Geschützte Konstruktoren

ResultForwarder

protected ResultForwarder ()

Erstelle eine ResultForwarder mit der Einstellung für verzögerte Listener. Nur für die Verwendung durch Unterklassen vorgesehen.

Öffentliche Methoden

getListeners

public  getListeners ()

Liste der Listener abrufen

Returns
	Die Liste der `ITestInvocationListener`s.

getSummary

public TestSummary getSummary ()

Ermöglicht dem InvocationListener, eine Zusammenfassung zurückzugeben.

Returns
`TestSummary`	Eine `TestSummary`, die den Lauf zusammenfasst, oder „null“

invocationEnded

public void invocationEnded (long elapsedTime)

Meldet, dass der Aufruf beendet wurde, unabhängig davon, ob dies erfolgreich oder aufgrund eines Fehlerzustands geschehen ist.

Wird automatisch vom TradeFederation-Framework aufgerufen.

Parameter
`elapsedTime`	`long`: die verstrichene Zeit des Aufrufs in Millisekunden

invocationFailed

public void invocationFailed (FailureDescription failure)

Meldet einen unvollständigen Aufruf aufgrund eines Fehlerzustands.

Wird automatisch vom TradeFederation-Framework aufgerufen.

Parameter
`failure`	`FailureDescription`: die `FailureDescription`, die die Ursache des Fehlers beschreibt

invocationFailed

public void invocationFailed (Throwable cause)

Meldet einen unvollständigen Aufruf aufgrund eines Fehlerzustands.

Wird automatisch vom TradeFederation-Framework aufgerufen.

Parameter
`cause`	`Throwable`: die `Throwable`-Ursache des Fehlers

invocationSkipped

public void invocationSkipped (SkipReason reason)

Meldet einen Aufruf als übersprungen

Parameter
`reason`	`SkipReason`

invocationStarted

public void invocationStarted (IInvocationContext context)

Meldet den Beginn des Testaufrufs.

Wird automatisch vom TradeFederation-Framework aufgerufen. Reporter müssen diese Methode überschreiben, um die Berichterstellung für mehrere Geräte zu unterstützen.

Parameter
`context`	`IInvocationContext`: Informationen zum Aufruf

testAssumptionFailure

public void testAssumptionFailure (TestDescription test, 
                String trace)

Wird aufgerufen, wenn bei einem atomaren Test eine Bedingung als falsch angenommen wird

Parameter
`test`	`TestDescription`: Gibt den Test an.
`trace`	`String`: Stacktrace des Fehlers

testAssumptionFailure

public void testAssumptionFailure (TestDescription test, 
                FailureDescription failure)

Wird aufgerufen, wenn bei einem atomaren Test eine Bedingung als falsch angenommen wird

Parameter
`test`	`TestDescription`: Gibt den Test an.
`failure`	`FailureDescription`: `FailureDescription`, die den Fehler und seinen Kontext beschreibt.

testEnded

public void testEnded (TestDescription test, 
                long endTime, 
                 testMetrics)

Alternative zu ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map)), mit der wir die Endzeit direkt angeben können. Kombinieren Sie sie mit testStarted(com.android.tradefed.result.TestDescription, long), um genaue Ergebnisse zu erhalten.

Parameter
`test`	`TestDescription`: Gibt den Test an.
`endTime`	`long`: Die Uhrzeit, zu der der Test beendet wurde, gemessen über `System.currentTimeMillis()`
`testMetrics`	: eine `ERROR(/Map)` der ausgegebenen Messwerte

testEnded

public void testEnded (TestDescription test, 
                 testMetrics)

Meldet das Ende der Ausführung eines einzelnen Testlaufs.

Wenn testFailed(TestDescription, FailureDescription) nicht aufgerufen wurde, wurde dieser Test bestanden. Gibt auch alle Schlüssel/Wert-Messwerte zurück, die während der Ausführung des Testlaufs ausgegeben wurden.

Parameter
`test`	`TestDescription`: Gibt den Test an.
`testMetrics`	: eine `ERROR(/Map)` der ausgegebenen Messwerte

testFailed

public void testFailed (TestDescription test, 
                FailureDescription failure)

Meldet das Fehlschlagen eines einzelnen Testlaufs.

Wird zwischen „testStarted“ und „testEnded“ aufgerufen.

Parameter
`test`	`TestDescription`: Gibt den Test an.
`failure`	`FailureDescription`: `FailureDescription`, die den Fehler und seinen Kontext beschreibt.

testFailed

public void testFailed (TestDescription test, 
                String trace)

Meldet das Fehlschlagen eines einzelnen Testlaufs.

Wird zwischen „testStarted“ und „testEnded“ aufgerufen.

Parameter
`test`	`TestDescription`: Gibt den Test an.
`trace`	`String`: Stacktrace des Fehlers

testIgnored

public void testIgnored (TestDescription test)

Wird aufgerufen, wenn ein Test nicht ausgeführt wird, in der Regel, weil eine Testmethode mit „org.junit.Ignore“ annotiert ist.

Parameter
`test`	`TestDescription`: Gibt den Test an.

testLog

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

Stellt die zugehörigen Protokoll- oder Debugging-Daten aus dem Testaufruf bereit.

Muss vor ERROR(/ITestInvocationListener#invocationFailed(Throwable)) oder ERROR(/ITestInvocationListener#invocationEnded(long)) aufgerufen werden

Diese Methode wird automatisch vom TradeFederation-Framework aufgerufen und stellt das Host-Log und gegebenenfalls das Device-Logcat bereit.

Parameter
`dataName`	`String`: Ein `String` aussagekräftiger Name der Daten, z. B. „device_logcat“. Hinweis: dataName ist möglicherweise nicht pro Aufruf eindeutig. Implementierer müssen also mehrere Aufrufe mit demselben dataName verarbeiten können.
`dataType`	`LogDataType`: die `LogDataType` der Daten
`dataStream`	`InputStreamSource`: die `InputStreamSource` der Daten. Implementierer sollten createInputStream aufrufen, um mit dem Lesen der Daten zu beginnen, und den resultierenden InputStream schließen, wenn sie fertig sind. Anrufer sollten dafür sorgen, dass die Datenquelle bis zum Abschluss der testLog-Methode vorhanden und zugänglich bleibt.

testModuleEnded

public void testModuleEnded ()

Meldet das Ende einer Modulausführung.

testModuleStarted

public void testModuleStarted (IInvocationContext moduleContext)

Meldet den Beginn der Ausführung eines Moduls. Dieser Callback ist mit testModuleEnded() verknüpft und in der Sequenz optional. Es wird nur bei einem Lauf verwendet, bei dem Module verwendet werden: Suite-basierte Runner.

Parameter
`moduleContext`	`IInvocationContext`: die `IInvocationContext` des Moduls.

testRunEnded

public void testRunEnded (long elapsedTime, 
                 runMetrics)

Meldet das Ende des Testlaufs.

Parameter
`elapsedTime`	`long`: Die vom Gerät gemeldete verstrichene Zeit in Millisekunden.
`runMetrics`	: Schlüssel/Wert-Paare, die am Ende eines Testlaufs gemeldet werden

testRunFailed

public void testRunFailed (FailureDescription failure)

Der Testlauf für Berichte konnte aufgrund eines Fehlers, der durch FailureDescription beschrieben wird, nicht abgeschlossen werden.

Parameter
`failure`	`FailureDescription`: `FailureDescription`, die den Fehler und seinen Kontext beschreibt.

testRunFailed

public void testRunFailed (String errorMessage)

Der Testlauf für Berichte konnte aufgrund eines schwerwiegenden Fehlers nicht abgeschlossen werden.

Parameter
`errorMessage`	`String`: `String`, in der der Grund für den Fehler bei der Ausführung beschrieben wird.

testRunStarted

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

Meldet den Beginn eines Testlaufs.

Parameter
`runName`	`String`: der Name des Testlaufs
`testCount`	`int`: Gesamtzahl der Tests im Testlauf
`attemptNumber`	`int`: Auftragsnummer zur Identifizierung der verschiedenen Versuche desselben runName, die mehrmals ausgeführt werden. Die attemptNumber ist 0-basiert und sollte bei jedem neuen Lauf inkrementiert werden. Wenn ein Test beispielsweise dreimal wiederholt wird, sollte er insgesamt vier Läufe mit demselben runName haben und die attemptNumber sollte von 0 bis 3 reichen.

testRunStarted

public void testRunStarted (String runName, 
                int testCount)

Meldet den Beginn eines Testlaufs.

Parameter
`runName`	`String`: der Name des Testlaufs
`testCount`	`int`: Gesamtzahl der Tests im Testlauf

testRunStarted

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

Meldet den Beginn eines Testlaufs.

Parameter
`runName`	`String`: der Name des Testlaufs
`testCount`	`int`: Gesamtzahl der Tests im Testlauf
`attemptNumber`	`int`: Auftragsnummer zur Identifizierung der verschiedenen Versuche desselben runName, die mehrmals ausgeführt werden. Die attemptNumber ist 0-basiert und sollte bei jedem neuen Lauf inkrementiert werden. Beispiel: Ein Test wird dreimal wiederholt. Er sollte insgesamt vier Läufe mit demselben runName haben und die attemptNumber sollte von 0 bis 3 reichen.
`startTime`	`long`: Die Startzeit des Laufs, gemessen mit `System.currentTimeMillis()`

testRunStopped

public void testRunStopped (long elapsedTime)

Der Testlauf für Berichte wurde aufgrund einer Nutzeranfrage vor Abschluss beendet.

TODO: currently unused, consider removing

Parameter
`elapsedTime`	`long`: Die vom Gerät gemeldete verstrichene Zeit in Millisekunden.

testSkipped

public void testSkipped (TestDescription test, 
                SkipReason reason)

Wird aufgerufen, wenn ein Test übersprungen wird und aus einem Grund, der normalerweise nicht erwartet wird, nicht ausgeführt wurde. Diese Tests werden wiederholt, um eine ordnungsgemäße Ausführung zu erreichen.

Parameter
`test`	`TestDescription`: Gibt den Test an.
`reason`	`SkipReason`: `SkipReason`

testStarted

public void testStarted (TestDescription test, 
                long startTime)

Alternative zu testStarted(com.android.tradefed.result.TestDescription), bei der wir auch angeben, wann der Test gestartet wurde, in Kombination mit ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,Map)) für eine genaue Messung.

Parameter
`test`	`TestDescription`: Gibt den Test an.
`startTime`	`long`: Die Uhrzeit, zu der der Test begonnen hat, gemessen über `System.currentTimeMillis()`

testStarted

public void testStarted (TestDescription test)

Meldet den Beginn eines einzelnen Testlaufs. Ältere Schnittstelle. Verwenden Sie nach Möglichkeit testStarted(com.android.tradefed.result.TestDescription).

Parameter
`test`	`TestDescription`: Gibt den Test an.

Geschützte Methoden

setListeners

protected void setListeners (ITestInvocationListener... listeners)

Legen Sie die Listener nach der Erstellung fest. Nur für die Verwendung durch Unterklassen vorgesehen.

Parameter
`listeners`	`ITestInvocationListener`: die echten `ITestInvocationListener`s, an die Ergebnisse weitergeleitet werden sollen

setListeners

protected void setListeners ( listeners)

Legen Sie die Listener nach der Erstellung fest. Nur für die Verwendung durch Unterklassen vorgesehen.

Parameter
`listeners`	: die echten `ITestInvocationListener`s, an die Ergebnisse weitergeleitet werden sollen