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.

ITestRunListener

public interface ITestRunListener

com.android.ddmlib.testrunner.ITestRunListener

Bekannte indirekte Unterklassen

StubTestRunListener, TestRunResult, TestRunToTestInvocationForwarder, XmlTestRunListener

StubTestRunListener	Stub-Implementierung von `ITestRunListener`
TestRunResult	Enthält Ergebnisse aus einem einzelnen Testlauf.
TestRunToTestInvocationForwarder	Weiterleitung von ddmlib `ITestRunListener` nach `ITestLifeCycleReceiver`.
XmlTestRunListener	Schreibt JUnit-Ergebnisse in XML-Dateien in einem Format, das mit dem XMLJUnitResultFormatter von Ant kompatibel ist.

Empfängt Ereignisbenachrichtigungen während der Ausführung von Instrumentierungstests.

Nach dem Vorbild von org.junit.runner.notification.RunListener

Die Reihenfolge der Aufrufe ist:

testRunStarted
testStarted
[testFailed]
[testAssumptionFailure]
[testIgnored]
testEnded
....
[testRunFailed]
testRunEnded

Zusammenfassung

Öffentliche Methoden
`abstract void`	`testAssumptionFailure(TestIdentifier test, String trace)` Wird aufgerufen, wenn bei einem atomaren Test eine Bedingung als falsch angenommen wird
`abstract void`	`testEnded(TestIdentifier test, testMetrics)` Meldet das Ende der Ausführung eines einzelnen Testlaufs.
`abstract void`	`testFailed(TestIdentifier test, String trace)` Meldet das Fehlschlagen eines einzelnen Testlaufs.
`abstract void`	`testIgnored(TestIdentifier test)` Wird aufgerufen, wenn ein Test nicht ausgeführt wird, in der Regel, weil eine Testmethode mit „org.junit.Ignore“ annotiert ist.
`abstract void`	`testRunEnded(long elapsedTime, runMetrics)` Meldet das Ende des Testlaufs.
`abstract void`	`testRunFailed(String errorMessage)` Der Testlauf für Berichte konnte aufgrund eines schwerwiegenden Fehlers nicht abgeschlossen werden.
`abstract void`	`testRunStarted(String runName, int testCount)` Meldet den Beginn eines Testlaufs.
`abstract void`	`testRunStopped(long elapsedTime)` Diese Methode ist veraltet. Dieser Callback wird nie aufgerufen. Wird gelöscht.
`abstract void`	`testStarted(TestIdentifier test)` Meldet den Beginn eines einzelnen Testlaufs.

Öffentliche Methoden

testAssumptionFailure

public abstract void testAssumptionFailure (TestIdentifier test, 
                String trace)

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

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

testEnded

public abstract void testEnded (TestIdentifier test, 
                 testMetrics)

Meldet das Ende der Ausführung eines einzelnen Testlaufs.

Wenn testFailed(TestIdentifier, String) 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

TestIdentifier: Gibt den Test an.

testMetrics

: Eine ERROR(/Map) der Messwerte, die während der Ausführung des Testlaufs von android.app.Instrumentation#sendStatus ausgegeben werden. Die Einfügereihenfolge wird beibehalten, es sei denn, Sie geben denselben Schlüssel mehrmals aus. Standardmäßig in IInstrumentationResultParser.StatusKeys definierte Schlüssel werden aus dieser Map herausgefiltert. DDMLib kann zusätzliche Testmesswerte hinzufügen, die in IInstrumentationResultParser.StatusKeys definiert sind.

testFailed

public abstract void testFailed (TestIdentifier test, 
                String trace)

Meldet das Fehlschlagen eines einzelnen Testlaufs.

Wird zwischen „testStarted“ und „testEnded“ aufgerufen.

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

testIgnored

public abstract void testIgnored (TestIdentifier test)

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

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

testRunEnded

public abstract void testRunEnded (long elapsedTime, 
                 runMetrics)

Meldet das Ende des Testlaufs.

Parameter

elapsedTime

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

runMetrics

: Eine ERROR(/Map) der Messwerte, die während der Ausführung des Testlaufs von android.app.Instrumentation#addResults ausgegeben werden. Die Einfügereihenfolge wird beibehalten, es sei denn, Sie geben denselben Schlüssel mehrmals aus. Standardmäßig in IInstrumentationResultParser.StatusKeys definierte Schlüssel werden aus dieser Map herausgefiltert. DDMLib kann zusätzliche Testmesswerte hinzufügen, die in IInstrumentationResultParser.StatusKeys definiert sind.

testRunFailed

public abstract 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 abstract 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

testRunStopped

public abstract void testRunStopped (long elapsedTime)

Diese Methode wurde eingestellt.
Dieser Callback wird nie aufgerufen. Wird gelöscht.

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

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

testStarted

public abstract void testStarted (TestIdentifier test)

Meldet den Beginn eines einzelnen Testlaufs.

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