Ab dem 27. März 2025 empfehlen wir, android-latest-release anstelle von aosp-main zu verwenden, um AOSP zu erstellen und Beiträge dazu zu leisten. Weitere Informationen finden Sie unter Änderungen am AOSP.

Diese Seite wurde von der Cloud Translation API übersetzt.

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 Protokollen mit dem globalen Datei-Saver.
LogcatCrashResultForwarder	Spezieller Listener: Bei Fehlern (Absturz des Instrumentierungsvorgangs) wird versucht, den Absturz aus dem Logcat zu extrahieren und der Fehlermeldung hinzuzufügen, die mit dem Test verknüpft ist.
PythonBinaryHostTest.PythonForwarder	Ergebnisweiterleiter, um den Namen der Ausführung durch den Binärnamen zu ersetzen.
ResultAndLogForwarder	Forwarder für Ergebnisse und Protokollereignisse.
RetryResultForwarder	Eine Erweiterung von `ResultForwarder`, die immer eine bestimmte Versuchszahl sendet.
ShardMainResultForwarder	Eine `ResultForwarder`, die die Ergebnisse von fragmentierten Testaufrufen kombiniert.
TestTimeoutEnforcer	Listener, mit denen die Ausführungszeit eines bestimmten Testfalls geprüft und der Test fehlgeschlagen wird, wenn er eine bestimmte Zeitüberschreitung überschreitet.

Bekannte indirekte Unterklassen

GranularRetriableTestWrapper.StartEndCollector, RetryLogSaverResultForwarder

GranularRetriableTestWrapper.StartEndCollector	Hilfsklasse zum Erfassen fehlender Laufstarts und -enden.
RetryLogSaverResultForwarder	Weiterleitung, die auch den aktuellen Versuch weiterleitet.

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

Zusammenfassung

Öffentliche Konstruktoren
`ResultForwarder(ITestInvocationListener... listeners)` Alternativer Variablenargumentkonstruktor für `ResultForwarder`.
`ResultForwarder( listeners)` Erstellen Sie eine `ResultForwarder`.

Geschützte Konstrukteure
`ResultForwarder()` Erstellen Sie eine `ResultForwarder` mit der Einstellung „Deferred Listener“.

Öffentliche Methoden
`TestSummary`	`getSummary()` Ermöglicht es dem InvocationListener, eine Zusammenfassung zurückzugeben.
`void`	`invocationEnded(long elapsedTime)` Gibt an, ob die Aufrufe erfolgreich oder aufgrund eines Fehlers beendet wurden.
`void`	`invocationFailed(FailureDescription failure)` Eine unvollständige Aufrufung wird aufgrund einer Fehlerbedingung gemeldet.
`void`	`invocationFailed(Throwable cause)` Eine unvollständige Aufrufung wird aufgrund einer Fehlerbedingung gemeldet.
`void`	`invocationSkipped(SkipReason reason)` Eine Aufrufung wird als übersprungen gemeldet.
`void`	`invocationStarted(IInvocationContext context)` Gibt den Beginn der Testausführung an.
`void`	`testAssumptionFailure(TestDescription test, String trace)` Wird aufgerufen, wenn ein atomarer Test meldet, dass eine Bedingung angenommen wird, die falsch ist.
`void`	`testAssumptionFailure(TestDescription test, FailureDescription failure)` Wird aufgerufen, wenn ein atomarer Test meldet, dass eine Bedingung angenommen wird, die falsch ist.
`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)` Gibt das Ende der Ausführung eines einzelnen Testfalls an.
`void`	`testFailed(TestDescription test, FailureDescription failure)` Hier wird der Fehler eines einzelnen Testfalls gemeldet.
`void`	`testFailed(TestDescription test, String trace)` Hier wird der Fehler eines einzelnen Testfalls gemeldet.
`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)` Enthält die zugehörigen Protokoll- oder Debug-Daten aus der Testausführung.
`void`	`testModuleEnded()` Gibt das Ende eines Modullaufs an.
`void`	`testModuleStarted(IInvocationContext moduleContext)` Gibt den Beginn der Ausführung eines Moduls an.
`void`	`testRunEnded(long elapsedTime, runMetrics)` Gibt das Ende des Testlaufs an.
`void`	`testRunFailed(FailureDescription failure)` Der Testlauf für Berichte konnte aufgrund eines Fehlers, der von `FailureDescription` beschrieben wurde, 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)` Gibt den Beginn eines Testlaufs an.
`void`	`testRunStarted(String runName, int testCount)` Gibt den Beginn eines Testlaufs an.
`void`	`testRunStarted(String runName, int testCount, int attemptNumber, long startTime)` Gibt den Beginn eines Testlaufs an.
`void`	`testRunStopped(long elapsedTime)` Der Testlauf für Berichte wurde aufgrund einer Nutzeranfrage vorzeitig beendet.
`void`	`testSkipped(TestDescription test, SkipReason reason)` Wird aufgerufen, wenn ein Test übersprungen und aus einem Grund nicht ausgeführt wurde, der normalerweise nicht erwartet wird.
`void`	`testStarted(TestDescription test, long startTime)` Alternative zu `testStarted(com.android.tradefed.result.TestDescription)`, bei der auch angegeben wird, wann der Test gestartet wurde. Wird mit `ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,Map))` kombiniert, um genaue Messungen zu ermöglichen.
`void`	`testStarted(TestDescription test)` Gibt den Beginn eines einzelnen Testfalls an.

Geschützte Methoden
	`getListeners()` Liste der Zuhörer abrufen
`void`	`setListeners(ITestInvocationListener... listeners)` Legen Sie die Listener nach dem Erstellen fest.
`void`	`setListeners( listeners)` Legen Sie die Listener nach dem Erstellen fest.

Öffentliche Konstruktoren

ResultForwarder

public ResultForwarder (ITestInvocationListener... listeners)

Alternativer Variablenargumentkonstruktor für ResultForwarder.

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

ResultForwarder

public ResultForwarder ( listeners)

Erstellen Sie eine ResultForwarder.

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

Geschützte Konstrukteure

ResultForwarder

protected ResultForwarder ()

Erstellen Sie eine ResultForwarder mit der Einstellung „Deferred Listener“. Nur für die Verwendung durch Unterklassen vorgesehen.

Öffentliche Methoden

getSummary

public TestSummary getSummary ()

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

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

invocationEnded

public void invocationEnded (long elapsedTime)

Gibt an, ob die Aufrufe erfolgreich oder aufgrund eines Fehlers beendet wurden.

Wird automatisch vom TradeFederation-Framework aufgerufen.

Parameter
`elapsedTime`	`long`: die verstrichene Zeit seit der Aufrufung in ms

invocationFailed

public void invocationFailed (FailureDescription failure)

Eine unvollständige Aufrufung wird aufgrund einer Fehlerbedingung gemeldet.

Wird automatisch vom TradeFederation-Framework aufgerufen.

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

invocationFailed

public void invocationFailed (Throwable cause)

Eine unvollständige Aufrufung wird aufgrund einer Fehlerbedingung gemeldet.

Wird automatisch vom TradeFederation-Framework aufgerufen.

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

invocationSkipped

public void invocationSkipped (SkipReason reason)

Eine Aufrufung wird als übersprungen gemeldet.

Parameter
`reason`	`SkipReason`

invocationStarted

public void invocationStarted (IInvocationContext context)

Gibt den Beginn der Testausführung an.

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

Parameter
`context`	`IInvocationContext`: Informationen zur Aufrufung

testAssumptionFailure

public void testAssumptionFailure (TestDescription test, 
                String trace)

Wird aufgerufen, wenn ein atomarer Test meldet, dass eine Bedingung angenommen wird, die falsch ist.

Parameter
`test`	`TestDescription`: identifiziert den Test
`trace`	`String`: Stack-Trace des Fehlers

testAssumptionFailure

public void testAssumptionFailure (TestDescription test, 
                FailureDescription failure)

Wird aufgerufen, wenn ein atomarer Test meldet, dass eine Bedingung angenommen wird, die falsch ist.

Parameter
`test`	`TestDescription`: identifiziert den Test
`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 diesen Messwert mit testStarted(com.android.tradefed.result.TestDescription, long), um genaue Ergebnisse zu erhalten.

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

testEnded

public void testEnded (TestDescription test, 
                 testMetrics)

Gibt das Ende der Ausführung eines einzelnen Testfalls an.

Wenn testFailed(TestDescription, FailureDescription) nicht aufgerufen wurde, wurde dieser Test bestanden. Außerdem werden alle Schlüssel/Wert-Messwerte zurückgegeben, die während der Ausführung des Testfalls gesendet wurden.

Parameter
`test`	`TestDescription`: identifiziert den Test
`testMetrics`	: `ERROR(/Map)` der gesendeten Messwerte

testFailed

public void testFailed (TestDescription test, 
                FailureDescription failure)

Hier wird der Fehler eines einzelnen Testfalls gemeldet.

Wird zwischen „testStarted“ und „testEnded“ aufgerufen.

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

testFailed

public void testFailed (TestDescription test, 
                String trace)

Hier wird der Fehler eines einzelnen Testfalls gemeldet.

Wird zwischen „testStarted“ und „testEnded“ aufgerufen.

Parameter
`test`	`TestDescription`: identifiziert den Test
`trace`	`String`: Stack-Trace 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`: identifiziert den Test

testLog

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

Enthält die zugehörigen Protokoll- oder Debug-Daten aus der Testausführung.

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

Das TradeFederation-Framework ruft diese Methode automatisch auf und stellt das Hostprotokoll und gegebenenfalls das Geräte-Logcat bereit.

Parameter
`dataName`	`String`: Ein `String` aussagekräftiger Name für die Daten, z. B. „device_logcat“. Hinweis: Der Datenname muss nicht für jeden Aufruf eindeutig sein. Entwickler müssen also in der Lage sein, mehrere Aufrufe mit demselben Datennamen zu verarbeiten.
`dataType`	`LogDataType`: die `LogDataType` der Daten
`dataStream`	`InputStreamSource`: die `InputStreamSource` der Daten. Implementer müssen createInputStream aufrufen, um mit dem Lesen der Daten zu beginnen, und den resultierenden InputStream nach Abschluss schließen. Die Aufrufer müssen dafür sorgen, dass die Datenquelle bis zum Abschluss der testLog-Methode vorhanden und zugänglich ist.

testModuleEnded

public void testModuleEnded ()

Gibt das Ende eines Modullaufs an.

testModuleStarted

public void testModuleStarted (IInvocationContext moduleContext)

Gibt den Beginn der Ausführung eines Moduls an. Dieser Rückruf ist mit testModuleEnded() verknüpft und in der Abfolge optional. Es wird nur bei einem Lauf verwendet, bei dem Module verwendet werden: suitebasierte Auslöser.

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

testRunEnded

public void testRunEnded (long elapsedTime, 
                 runMetrics)

Gibt das Ende des Testlaufs an.

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

testRunFailed

public void testRunFailed (FailureDescription failure)

Der Testlauf für Berichte konnte aufgrund eines Fehlers, der von FailureDescription beschrieben wurde, 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` mit einer Beschreibung des Grunds für den Ausführungsfehler.

testRunStarted

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

Gibt den Beginn eines Testlaufs an.

Parameter
`runName`	`String`: der Name des Testlaufs
`testCount`	`int`: Gesamtzahl der Tests im Testlauf
`attemptNumber`	`int`: Die Bestellnummer, die die verschiedenen Versuche desselben runName identifiziert, der mehrmals ausgeführt wird. Die „attemptNumber“ beginnt bei 0 und sollte bei jedem neuen Durchlauf erhöht werden. Wenn ein Test beispielsweise dreimal wiederholt wird, sollte er insgesamt vier Durchläufe mit demselben „runName“ haben und die „attemptNumber“ sollte von 0 auf 3 steigen.

testRunStarted

public void testRunStarted (String runName, 
                int testCount)

Gibt den Beginn eines Testlaufs an.

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)

Gibt den Beginn eines Testlaufs an.

Parameter
`runName`	`String`: der Name des Testlaufs
`testCount`	`int`: Gesamtzahl der Tests im Testlauf
`attemptNumber`	`int`: Die Bestellnummer, die die verschiedenen Versuche desselben runName identifiziert, der mehrmals ausgeführt wird. Die „attemptNumber“ beginnt bei 0 und sollte bei jedem neuen Durchlauf erhöht werden. Wenn ein Test beispielsweise dreimal wiederholt wird, sollte es insgesamt vier Durchläufe mit demselben „runName“ geben und die „attemptNumber“ sollte von 0 auf 3 steigen.
`startTime`	`long`: Zeitpunkt des Beginns der Ausführung, gemessen über `System.currentTimeMillis()`

testRunStopped

public void testRunStopped (long elapsedTime)

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

TODO: currently unused, consider removing

Parameter
`elapsedTime`	`long`: Vom Gerät gemeldete verstrichene Zeit in Millisekunden

testSkipped

public void testSkipped (TestDescription test, 
                SkipReason reason)

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

Parameter
`test`	`TestDescription`: identifiziert den Test
`reason`	`SkipReason`: `SkipReason`

testStarted

public void testStarted (TestDescription test, 
                long startTime)

Alternative zu testStarted(com.android.tradefed.result.TestDescription), bei der auch angegeben wird, wann der Test gestartet wurde. Wird mit ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,Map)) kombiniert, um genaue Messungen zu ermöglichen.

Parameter
`test`	`TestDescription`: identifiziert den Test
`startTime`	`long`: Die Uhrzeit, zu der der Test gestartet wurde, gemessen über `System.currentTimeMillis()`

testStarted

public void testStarted (TestDescription test)

Gibt den Beginn eines einzelnen Testfalls an. Ältere Benutzeroberfläche. Verwenden Sie nach Möglichkeit testStarted(com.android.tradefed.result.TestDescription).

Parameter
`test`	`TestDescription`: identifiziert den Test

Geschützte Methoden

getListeners

protected  getListeners ()

Liste der Zuhörer abrufen Nur für Unterklassen gedacht.

Returns
	Die Liste der `ITestInvocationListener`.

setListeners

protected void setListeners (ITestInvocationListener... listeners)

Legen Sie die Listener nach dem Erstellen fest. Nur für Unterklassen gedacht.

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

setListeners

protected void setListeners ( listeners)

Legen Sie die Listener nach dem Erstellen fest. Nur für Unterklassen gedacht.

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