Ab 2026 werden wir, um unser stabiles Entwicklungsmodell für den Trunk zu unterstützen und die Plattformstabilität für das Ökosystem zu gewährleisten, den Quellcode im 2. und 4. Quartal in AOSP veröffentlichen. Verwenden Sie android-latest-release, um AOSP zu entwickeln und dazu beizutragen. Der Manifestzweig android-latest-release verweist immer auf das neueste Release, das an AOSP übertragen wurde. Weitere Informationen finden Sie unter Änderungen an AOSP.

Google verwendet KI-Technologie, um Inhalte in Ihre bevorzugte Sprache zu übersetzen. KI-Übersetzungen können Fehler enthalten.

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` zu `ITestLifeCycleReceiver`.
XmlTestRunListener	Schreibt JUnit-Ergebnisse in XML-Dateien in einem Format, das mit dem XMLJUnitResultFormatter von Ant übereinstimmt.

Empfängt Ereignisbenachrichtigungen während von Instrumentierungstests.

Nach dem Muster 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 ein atomarer Test meldet, dass er eine Bedingung voraussetzt, die nicht erfüllt ist.
`abstract void`	`testEnded(TestIdentifier test, Map<String, String> testMetrics)` Meldet das Ende der Ausführung eines einzelnen Testlaufs.
`abstract void`	`testFailed(TestIdentifier test, String trace)` Meldet den Fehler 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, Map<String, String> runMetrics)` Meldet das Ende des Testlaufs.
`abstract void`	`testRunFailed(String errorMessage)` Meldet, dass der Testlauf aufgrund eines schwerwiegenden Fehlers nicht abgeschlossen wurde.
`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 ein atomarer Test meldet, dass er eine Bedingung voraussetzt, die nicht erfüllt ist.

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

testEnded

public abstract void testEnded (TestIdentifier test, 
                Map<String, String> 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

Map: Map der Messwerte, die während der Ausführung des Testlaufs von android.app.Instrumentation#sendStatus ausgegeben werden. Solange derselbe Schlüssel nicht mehrmals ausgegeben wird, bleibt die Einfügereihenfolge dieselbe. In IInstrumentationResultParser.StatusKeys definierte Standardschlü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 den Fehler 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, 
                Map<String, String> runMetrics)

Meldet das Ende des Testlaufs.

Parameter

elapsedTime

long: vom Gerät gemeldete verstrichene Zeit in Millisekunden

runMetrics

Map: Map der Messwerte, die während der Ausführung des Testlaufs von android.app.Instrumentation#addResults ausgegeben werden. Solange derselbe Schlüssel nicht mehrmals ausgegeben wird, bleibt die Einfügereihenfolge dieselbe. In IInstrumentationResultParser.StatusKeys definierte Standardschlü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)

Meldet, dass der Testlauf aufgrund eines schwerwiegenden Fehlers nicht abgeschlossen wurde.

Parameter
`errorMessage`	`String`: `String`, in dem 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`: Name des Testlaufs
`testCount`	`int`: Gesamtzahl der Tests im Testlauf

testRunStopped

public abstract void testRunStopped (long elapsedTime)

Diese Methode ist veraltet.
Dieser Callback wird nie aufgerufen. Wird gelöscht.

Meldet, dass der Testlauf aufgrund einer Nutzeranfrage vor Abschluss beendet wurde.

Parameter
`elapsedTime`	`long`: 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