À 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 dans AOSP, utilisez android-latest-release. 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.

Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

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 exécution de test.
TestRunToTestInvocationForwarder	Transfère de ddmlib `ITestRunListener` vers `ITestLifeCycleReceiver`.
XmlTestRunListener	Écrit les résultats JUnit dans des fichiers XML dans un format cohérent avec XMLJUnitResultFormatter d'Ant.

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

Modèle 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ée lorsqu'un test atomique signale qu'il suppose une condition fausse
`abstract void`	`testEnded(TestIdentifier test, Map<String, String> testMetrics)` Signale la fin de l'exécution d'un cas de test individuel.
`abstract void`	`testFailed(TestIdentifier test, String trace)` Signale l'échec d'un cas de test individuel.
`abstract void`	`testIgnored(TestIdentifier test)` Appelée 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, Map<String, String> runMetrics)` Signale la fin de l'exécution du test.
`abstract void`	`testRunFailed(String errorMessage)` Signale que l'exécution du test n'a pas pu se terminer en raison d'une erreur fatale.
`abstract void`	`testRunStarted(String runName, int testCount)` Signale le début d'une exécution de test.
`abstract void`	`testRunStopped(long elapsedTime)` Cette méthode est obsolète. Ce rappel ne sera jamais appelé. À supprimer.
`abstract void`	`testStarted(TestIdentifier test)` Signale le début d'un cas de test individuel.

Méthodes publiques

testAssumptionFailure

public abstract void testAssumptionFailure (TestIdentifier test, 
                String trace)

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

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

testEnded

public abstract void testEnded (TestIdentifier test, 
                Map<String, String> testMetrics)

Signale 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

Map : 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)

Signale 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ée 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, 
                Map<String, String> runMetrics)

Signale la fin de l'exécution du test.

Paramètres

elapsedTime

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

runMetrics

Map : 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)

Signale que l'exécution du test n'a pas pu se terminer 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)

Signale le début d'une exécution de test.

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 ne sera jamais appelé. À supprimer.

Signale que l'exécution du test a été arrêtée avant la fin en raison d'une demande de l'utilisateur.

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

testStarted

public abstract void testStarted (TestIdentifier test)

Signale le début d'un cas de test individuel.

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