À partir de 2026, pour nous aligner sur notre modèle de développement stable et garantir la stabilité de la plate-forme pour l'écosystème, nous publierons le code source sur AOSP au deuxième et au quatrième trimestre. Pour créer et contribuer à AOSP, nous vous recommandons d'utiliser android-latest-release au lieu de aosp-main. La branche de fichier manifeste android-latest-release fera toujours référence à la version la plus récente envoyée à AOSP. Pour en savoir plus, consultez Modifications apportées à AOSP.

ITestRunListener

public interface ITestRunListener

com.android.ddmlib.testrunner.ITestRunListener

Sous-classes indirectes connues

StubTestRunListener, TestRunResult, TestRunToTestInvocationForwarder, XmlTestRunListener

StubTestRunListener	Implémentation stub de `ITestRunListener`
TestRunResult	Contient les résultats d'une seule série de tests.
TestRunToTestInvocationForwarder	Transférer de ddmlib `ITestRunListener` vers `ITestLifeCycleReceiver`.
XmlTestRunListener	Écrit les résultats JUnit dans des fichiers XML dans un format compatible avec XMLJUnitResultFormatter d'Ant.

Reçoit les notifications d'événements lors de l'exécution des tests d'instrumentation.

Basé sur org.junit.runner.notification.RunListener

La séquence d'appels sera la suivante :

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

Résumé

Méthodes publiques
`abstract void`	`testAssumptionFailure(TestIdentifier test, String trace)` Appelé lorsqu'un test atomique signale qu'il suppose une condition qui est fausse
`abstract void`	`testEnded(TestIdentifier test, testMetrics)` Indique la fin de l'exécution d'un cas de test individuel.
`abstract void`	`testFailed(TestIdentifier test, String trace)` Signalement de l'échec d'un cas de test individuel.
`abstract void`	`testIgnored(TestIdentifier test)` Appelé lorsqu'un test ne sera pas exécuté, généralement parce qu'une méthode de test est annotée avec org.junit.Ignore.
`abstract void`	`testRunEnded(long elapsedTime, runMetrics)` Rapports de fin de série de tests.
`abstract void`	`testRunFailed(String errorMessage)` L'exécution du test des rapports n'a pas pu être effectuée en raison d'une erreur fatale.
`abstract void`	`testRunStarted(String runName, int testCount)` Indique le début d'une série de tests.
`abstract void`	`testRunStopped(long elapsedTime)` Cette méthode est obsolète. Ce rappel n'est jamais appelé. À supprimer.
`abstract void`	`testStarted(TestIdentifier test)` Indique le début d'un scénario de test individuel.

Méthodes publiques

testAssumptionFailure

public abstract void testAssumptionFailure (TestIdentifier test, 
                String trace)

Appelé lorsqu'un test atomique signale qu'il suppose une condition qui est fausse

Paramètres
`test`	`TestIdentifier` : identifie le test
`trace`	`String` : trace de la pile d'échec

testEnded

public abstract void testEnded (TestIdentifier test, 
                 testMetrics)

Indique la fin de l'exécution d'un cas de test individuel.

Si testFailed(TestIdentifier, String) n'a pas été appelé, ce test a réussi. Renvoie également toutes les métriques clé/valeur qui ont pu être émises lors de l'exécution du cas de test.

Paramètres

test

TestIdentifier : identifie le test

testMetrics

: ERROR(/Map) des métriques émises lors de l'exécution du cas de test par android.app.Instrumentation#sendStatus. L'ordre d'insertion est conservé, sauf si vous émettez plusieurs fois la même clé. Notez que les clés standards définies dans IInstrumentationResultParser.StatusKeys sont filtrées de cette carte. Ddmlib peut ajouter des métriques de test supplémentaires définies dans IInstrumentationResultParser.StatusKeys.

testFailed

public abstract void testFailed (TestIdentifier test, 
                String trace)

Signalement de l'échec d'un cas de test individuel.

Sera appelé entre testStarted et testEnded.

Paramètres
`test`	`TestIdentifier` : identifie le test
`trace`	`String` : trace de la pile d'échec

testIgnored

public abstract void testIgnored (TestIdentifier test)

Appelé lorsqu'un test ne sera pas exécuté, généralement parce qu'une méthode de test est annotée avec org.junit.Ignore.

Paramètres
`test`	`TestIdentifier` : identifie le test

testRunEnded

public abstract void testRunEnded (long elapsedTime, 
                 runMetrics)

Rapports de fin de série de tests.

Paramètres

elapsedTime

long : temps écoulé indiqué par l'appareil, en millisecondes

runMetrics

: ERROR(/Map) des métriques émises lors de l'exécution du cas de test par android.app.Instrumentation#addResults. L'ordre d'insertion est conservé, sauf si vous émettez plusieurs fois la même clé. Notez que les clés standards définies dans IInstrumentationResultParser.StatusKeys sont filtrées de cette carte. Ddmlib peut ajouter des métriques de test supplémentaires définies dans IInstrumentationResultParser.StatusKeys.

testRunFailed

public abstract void testRunFailed (String errorMessage)

L'exécution du test des rapports n'a pas pu être effectuée en raison d'une erreur fatale.

Paramètres
`errorMessage`	`String` : `String` décrivant la raison de l'échec de l'exécution.

testRunStarted

public abstract void testRunStarted (String runName, 
                int testCount)

Indique le début d'une série de tests.

Paramètres
`runName`	`String` : nom de l'exécution du test
`testCount`	`int` : nombre total de tests dans l'exécution du test

testRunStopped

public abstract void testRunStopped (long elapsedTime)

Cette méthode est obsolète.
Ce rappel n'est jamais appelé. À supprimer.

L'exécution du test des rapports a été arrêtée avant la fin à la demande d'un utilisateur.

Paramètres
`elapsedTime`	`long` : temps écoulé indiqué par l'appareil, en millisecondes

testStarted

public abstract void testStarted (TestIdentifier test)

Indique le début d'un scénario de test individuel.

Paramètres
`test`	`TestIdentifier` : identifie le test