À partir du 27 mars 2025, nous vous recommandons d'utiliser android-latest-release au lieu de aosp-main pour créer et contribuer à AOSP. Pour en savoir plus, consultez la section Modifications apportées à AOSP.

Cette page a été traduite par l'API Cloud Translation.

ITestLifeCycleReceiver

public interface ITestLifeCycleReceiver

com.android.tradefed.result.ITestLifeCycleReceiver

Sous-classes indirectes connues

AggregatePostProcessor, AtraceCollector, AtraceRunMetricCollector, AveragePostProcessor, BaseDeviceMetricCollector, BasePostProcessor, BluetoothConnectionLatencyCollector, BluetoothConnectionStateCollector, BluetoothConnectionSuccessRatePostProcessor, BluetoothHciSnoopLogCollector, BugreportCollector, BugreportzOnFailureCollector, BugreportzOnTestCaseFailureCollector, ClangCodeCoverageCollector, CodeCoverageCollector et 84 autres.

AggregatePostProcessor	Un agrégateur de métriques qui fournit le min, le max, la moyenne, la variance, l'écart type, le total, le nombre et éventuellement les centiles pour les métriques numériques collectées lors de plusieurs exécutions de tests, en les traitant comme des doubles.
AtraceCollector	Un `IMetricCollector` qui exécute atrace pendant un test, collecte le résultat et l'enregistre dans l'invocation.
AtraceRunMetricCollector	Collecte les traces de tous les répertoires de test du répertoire donné à partir de l'appareil de test, enregistre le répertoire de test et post-traite les fichiers de trace dans le répertoire de test, puis agrège les métriques.
AveragePostProcessor	Implémentation du post-processeur qui calcule la moyenne de la liste des métriques.
BaseDeviceMetricCollector	Implémentation de base de `IMetricCollector` qui permet de démarrer et d'arrêter la collecte sur `onTestRunStart(com.android.tradefed.device.metric.DeviceMetricData)` et `ERROR(/#onTestRunEnd(com.android.tradefed.device.metric.DeviceMetricData,Map))`.
BasePostProcessor	`IPostProcessor` de base que chaque implémentation doit étendre.
BluetoothConnectionLatencyCollector	Le collecteur enverra une configuration de métrique de durée statsd prédéfinie aux appareils et collectera la durée de connexion Bluetooth pour chaque profil.
BluetoothConnectionStateCollector	Ce collecteur collecte les métriques BluetoothConnectionStateChanged et enregistre le nombre d'états de connexion pour chaque profil.
BluetoothConnectionSuccessRatePostProcessor	Implémentation d'un post-processeur qui calcule le taux de réussite d'un profil Bluetooth Utilisez "metric-key-match" pour spécifier les métriques qui contiennent les états de connexion Bluetooth dans un tableau numérique. Exemple : [0, 1, 2, 3, 0, 1, 2, 3].
BluetoothHciSnoopLogCollector	Collecteur permettant d'activer l'enregistrement des données relatives à la connectivité HCI Bluetooth dans un journal snoop sur l'appareil testé et de collecter le journal pour chaque test.
BugreportCollector	`ITestInvocationListener` intermédiaire qui collecte les rapports de bug lorsque des événements configurables se produisent, puis appelle `ITestInvocationListener.testLog` sur ses enfants après chaque rapport de bug collecté.
BugreportzOnFailureCollector	Collectez un bugreportz lorsqu'un scénario de test échoue.
BugreportzOnTestCaseFailureCollector	Collectez un bugreportz lorsqu'un scénario de test échoue lors d'une exécution.
ClangCodeCoverageCollector	Un `BaseDeviceMetricCollector` qui extraira les mesures de couverture Clang de l'appareil et les enregistrera en tant qu'artefacts de test.
CodeCoverageCollector	Un `BaseDeviceMetricCollector` qui extrait les mesures de couverture Java et native de l'appareil et les enregistre en tant qu'artefacts de test.
CollectingTestListener	Un `ITestInvocationListener` qui collectera tous les résultats des tests.
CommandStatusHandler	Gestionnaire permettant de surveiller et de mettre à jour l'état d'un appel.
ConditionFailureMonitor	Surveillez les éventuels échecs d'invocation.
ConsoleResultReporter	Outil de création de rapports sur les résultats pour imprimer les résultats des tests dans la console.
CountTestCasesCollector	Compte et signale le nombre de scénarios de test pour un `IRemoteTest` donné.
CountingTestResultListener	`TestResultListener` qui suit le nombre total de tests par `TestStatus`
DebugHostLogOnFailureCollector	Collecteur qui collecte et enregistre les journaux côté hôte en cas d'échec d'un scénario de test.
DeviceReleaseReporter	Outil de signalement de la libération d'appareils qui gère la communication avec le processus parent pour libérer les appareils.
DeviceTraceCollector	Collecteur qui démarre le traçage perfetto au début d'une série de tests et enregistre le fichier de trace à la fin.
DeviceUnavailableMonitor	Ce listener tente de capturer uniquement un DNAE au niveau du scénario de test.
EventsLoggerListener	Écouteur qui enregistre tous les événements qu'il reçoit dans un fichier
FileProtoResultReporter	Reporter Proto qui vide le `TestRecord` dans un fichier.
FilePullerDeviceMetricCollector	Un `BaseDeviceMetricCollector` qui écoute la clé de métriques provenant de l'appareil et les extrait sous forme de fichier depuis l'appareil.
FilePullerLogCollector	Journaliseur du fichier signalé par le côté de l'appareil.
FilteredResultForwarder	Variante de `ResultForwarder` qui n'autorise qu'une liste d'autorisation de `TestDescription` à être signalée.
FormattedGeneratorReporter	Outil de création de rapports qui permet de générer des rapports dans un format spécifique.
GcovCodeCoverageCollector	Un `BaseDeviceMetricCollector` qui extrait les mesures de couverture gcov de l'appareil et les enregistre en tant qu'artefacts de test.
GcovKernelCodeCoverageCollector	Un `BaseDeviceMetricCollector` qui extrait les mesures de couverture du noyau gcov de debugfs et de l'appareil, puis les enregistre en tant qu'artefacts de test.
GranularRetriableTestWrapper.StartEndCollector	Classe d'assistance pour détecter les débuts et fins de course manquants.
HostStatsdMetricCollector	Un `IMetricCollector` qui collecte les métriques statsd côté hôte à l'aide des commandes de l'utilitaire statsd.
ICommandScheduler.IScheduledInvocationListener	Écouteur pour les événements d'invocation lorsque l'invocation est terminée.
ILogSaverListener	Permet aux `ITestInvocationListener` de savoir quand les fichiers journaux sont enregistrés.
IMetricCollector	Cette interface sera ajoutée en tant que décorateur lors de la création de rapports sur les résultats des tests afin de collecter les métriques correspondantes.
IPostProcessor	Les post-processeurs sont des objets Trade Federation destinés à permettre le traitement des métriques et des journaux APRÈS les tests et AVANT la création de rapports sur les résultats.
IShardableListener	`ITestInvocationListener` pouvant être fragmenté.
ISupportGranularResults	Interface indiquant si un `ITestInvocationListener` est compatible avec la réception de résultats précis ou non.
ITestInvocationListener	Écouteur pour les résultats des tests de l'appel de test.
ITestSummaryListener	Interface qui permet à `ITestInvocationListener` d'échanger des informations limitées via des résumés.
InvocationProtoResultReporter	Reporters pour stocker les informations de mise en cache au niveau de l'invocation et sa liste de modules
InvocationToJUnitResultForwarder	Classe qui écoute les événements `ITestInvocationListener` et les transmet à un `TestListener`.
JarHostTest.HostTestListener	Écouteur de wrapper qui transmet tous les événements, à l'exception de testRunStarted() et testRunEnded(), à l'écouteur intégré.
JavaCodeCoverageCollector	Un `BaseDeviceMetricCollector` qui extrait les mesures de couverture Java de l'appareil et les enregistre en tant qu'artefacts de test.
JsonHttpTestResultReporter	Un outil de signalement des résultats qui encode les résultats des métriques de test et les informations sur la branche et l'appareil au format JSON, puis les publie sur un point de terminaison de service HTTP.
LUCIResultReporter	Un outil de création de rapports sur les résultats qui enregistre les résultats des tests nécessaires à ResultDB et LUCI au format JSON (go/result-sink) et consigne l'emplacement du fichier dans la console.
LastShardDetector	Lorsque vous exécutez le partitionnement local, vous ne souhaitez parfois exécuter certaines actions que lorsque le dernier shard atteint `invocationEnded(long)`.
LegacySubprocessResultsReporter	Implémentation figée du rapporteur de résultats de sous-processus qui doit rester compatible avec les versions antérieures de TF/CTS (par exemple, 8 et versions ultérieures), malgré les modifications apportées à sa classe parente.
LogSaverResultForwarder	Un `ResultForwarder` pour enregistrer les journaux avec l'outil d'enregistrement de fichiers global.
LogcatCrashResultForwarder	Écouteur spécial : en cas d'échec (plantage du processus d'instrumentation), il tente d'extraire le plantage du logcat et l'ajoute au message d'échec associé au test.
LogcatOnFailureCollector	Collecteur qui capture et consigne un logcat en cas d'échec d'un scénario de test.
LogcatTimingMetricCollector	Collecteur de métriques qui collecte des informations de timing (par exemple, le temps de changement d'utilisateur) à partir de logcat lors d'un ou de plusieurs tests répétés en utilisant des modèles d'expression régulière donnés pour analyser les signaux de début et de fin d'un événement à partir des lignes logcat.
MetricFilePostProcessor	Permet d'importer le fichier journal des métriques collectées au niveau du test et de l'exécution.
MetricsXMLResultReporter	MetricsXMLResultReporter écrit les métriques de test et d'exécution dans un fichier XML, dans un dossier spécifié par le paramètre "metrics-folder" lors de la phase "invocationEnded" du test.
ModuleListener	Écouteur associé à chaque `IRemoteTest` de chaque module afin de collecter la liste des résultats.
ModuleLogcatCollector	Version du collecteur logcat, mais pour le module.
ModuleProtoResultReporter	Un outil de reporting des résultats destiné à ne signaler que les résultats au niveau du module.
ModuleResultsAndMetricsForwarder	Extension de `ResultAndLogForwarder` qui ajoute des métriques supplémentaires liées au module aux résultats du test.
NameMangleListener	Écouteur proxy permettant de traduire les noms de méthode, de classe et de package de test à mesure que les résultats sont signalés.
PassingTestFileReporter	Un `ITestInvocationListener` qui enregistre la liste des scénarios de test réussis dans un fichier de test
PerfettoFilePullerCollector	Un collecteur qui extrait les fichiers de trace Perfetto de l'appareil, les compresse éventuellement et les ajoute aux journaux de test.
PerfettoGenericPostProcessor	Post-processeur qui traite le fichier proto perfetto de métriques texte/binaires en paires clé/valeur en développant de manière récursive les messages et les champs proto avec des valeurs de chaîne jusqu'à ce que le champ avec une valeur numérique soit rencontré.
PerfettoPullerMetricCollector	Cette classe est obsolète. Utilisez plutôt `PerfettoFilePullerCollector` et `ERROR(/PerfettoTracePostProcessor)`.
PerfettoTracePostProcessor	Post-processeur qui récupère les fichiers de trace Perfetto à partir des journaux de test et exécute le processeur de trace sur ceux-ci pour produire un proto de métrique Perfetto.
PrettyTestEventLogger	Un enregistreur correspondant aux événements et les enregistrant pour faciliter le débogage.
ProtoResultReporter	Le générateur de rapports sur les résultats crée un fichier protobuf `TestRecord` contenant tous les résultats.
PythonBinaryHostTest.PythonForwarder	Transmetteur de résultats pour remplacer le nom de l'exécution par le nom du binaire.
RebootReasonCollector	Collecteur qui collecte les redémarrages d'appareils pendant l'exécution du test et les signale par motif et nombre.
RemoteTestTimeOutEnforcer	Écouteurs permettant de vérifier la durée d'exécution d'une configuration de test donnée et de la faire échouer si elle dépasse un délai d'inactivité donné.
ReportPassedTests	Filtres possibles pour exclure les tests réussis dans un fichier de rapport.
ResultAggregator	Transmetteur spécial qui agrège les résultats si nécessaire, en fonction de la stratégie de réessai adoptée.
ResultAndLogForwarder	Redirecteur pour les résultats et les événements de journaux.
ResultDBReporter	Outil de création de rapports sur les résultats qui importe les résultats des tests dans ResultDB.
ResultForwarder	`ITestInvocationListener` qui transmet les résultats d'invocation à une liste d'autres écouteurs.
ResultReporter
RetryLogSaverResultForwarder	Transmetteur qui gère également la transmission de la tentative actuelle.
RetryResultForwarder	Extension de `ResultForwarder` qui envoie toujours à un numéro de tentative donné.
RuntimeRestartCollector	Collecteur qui collecte les codes temporels des redémarrages du runtime (plantages du serveur système) pendant l'exécution du test, le cas échéant.
ScreenshotOnFailureCollector	Collecteur qui capture et enregistre une capture d'écran en cas d'échec d'un scénario de test.
ShardListener	Un `ITestInvocationListener` qui collecte les résultats d'un fragment d'invocation (c'est-à-dire une invocation divisée pour s'exécuter en parallèle sur plusieurs ressources) et les transmet à un autre écouteur.
ShardMainResultForwarder	`ResultForwarder` qui combine les résultats des appels de test segmentés.
ShowmapPullerMetricCollector	Implémentation de base de `FilePullerDeviceMetricCollector` qui permet d'extraire les fichiers showmap de l'appareil et de collecter les métriques à partir de ceux-ci.
StatsdBeforeAfterGaugeMetricPostProcessor	Post-processeur qui traite les métriques de jauge collectées selon une approche "avant/après", c'est-à-dire
StatsdEventMetricPostProcessor	Post-processeur qui traite les métriques d'événement dans les rapports statsd en paires clé/valeur, à l'aide des formateurs spécifiés sur le processeur.
StatsdGenericPostProcessor	Post-processeur qui traite les rapports statsd proto binaires en paires clé-valeur en développant le rapport sous forme d'arborescence.
StreamProtoResultReporter	Implémentation de `ProtoResultReporter`
SubprocessResultsReporter	Implémente `ITestInvocationListener` à spécifier en tant que result_reporter et transmet à partir du sous-processus les résultats des tests, des exécutions de tests et des appels de tests.
SuiteResultReporter	Collecte les résultats des tests pour l'ensemble de l'invocation de la suite et génère les résultats finaux.
TestResultListener	Simplification d'ITestLifecycleListener pour les implémenteurs qui ne s'intéressent qu'aux résultats de tests individuels.
TestRunResultListener	Écouteur permettant de lire l'état final de l'exécution du test.
TestTimeoutEnforcer	Écouteurs permettant de vérifier le temps d'exécution d'un cas de test donné et de le faire échouer s'il dépasse un délai d'attente donné.
TextResultReporter	Un outil de création de rapports sur les résultats des tests qui transmet les résultats à l'imprimante de résultats de texte JUnit.
TraceCmdCollector	Un `IMetricCollector` qui collecte les traces pendant le test à l'aide de trace-cmd et les enregistre dans l'invocation.
TradefedSandboxRunner.StubScheduledInvocationListener	Un stub `IScheduledInvocationListener` qui ne fait rien.
XmlFormattedGeneratorReporter	Implémentation de `FormattedGeneratorReporter` qui met en forme les résultats de la suite au format XML.
XmlResultReporter	É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
`default void`	`testAssumptionFailure(TestDescription test, String trace)` Appelé lorsqu'un test atomique signale qu'il suppose une condition qui est fausse
`default void`	`testAssumptionFailure(TestDescription test, FailureDescription failure)` Appelé lorsqu'un test atomique signale qu'il suppose une condition qui est fausse
`default void`	`testEnded(TestDescription test, long endTime, testMetrics)` Alternative à `ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map))` où nous pouvons spécifier directement l'heure de fin.
`default void`	`testEnded(TestDescription test, testMetrics)` Indique la fin de l'exécution d'un cas de test individuel.
`default void`	`testFailed(TestDescription test, FailureDescription failure)` Signalement de l'échec d'un cas de test individuel.
`default void`	`testFailed(TestDescription test, String trace)` Signalement de l'échec d'un cas de test individuel.
`default void`	`testIgnored(TestDescription 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.
`default void`	`testRunEnded(long elapsedTimeMillis, runMetrics)` Rapports de fin de série de tests.
`default void`	`testRunFailed(FailureDescription failure)` L'exécution du test des rapports n'a pas pu être effectuée en raison d'un échec décrit par `FailureDescription`.
`default void`	`testRunFailed(String errorMessage)` L'exécution du test des rapports n'a pas pu être effectuée en raison d'une erreur fatale.
`default void`	`testRunStarted(String runName, int testCount, int attemptNumber)` Indique le début d'une série de tests.
`default void`	`testRunStarted(String runName, int testCount)` Indique le début d'une série de tests.
`default void`	`testRunStarted(String runName, int testCount, int attemptNumber, long startTime)` Indique le début d'une série de tests.
`default void`	`testRunStopped(long elapsedTime)` L'exécution du test des rapports a été arrêtée avant la fin à la demande d'un utilisateur.
`default void`	`testSkipped(TestDescription test, SkipReason reason)` Appelée lorsqu'un test est ignoré et ne s'est pas exécuté pour une raison généralement inattendue.
`default void`	`testStarted(TestDescription test, long startTime)` Alternative à `testStarted(com.android.tradefed.result.TestDescription)` où nous spécifions également la date de début du test, combinée à `ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,Map))` pour une mesure précise.
`default void`	`testStarted(TestDescription test)` Indique le début d'un scénario de test individuel.

Méthodes publiques

testAssumptionFailure

public void testAssumptionFailure (TestDescription test, 
                String trace)

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

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

testAssumptionFailure

public void testAssumptionFailure (TestDescription test, 
                FailureDescription failure)

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

Paramètres
`test`	`TestDescription` : identifie le test
`failure`	`FailureDescription` : `FailureDescription` décrivant l'échec et son contexte.

testEnded

public void testEnded (TestDescription test, 
                long endTime, 
                 testMetrics)

Alternative à ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map)) où nous pouvons spécifier directement l'heure de fin. Combinez-le avec testStarted(com.android.tradefed.result.TestDescription, long) pour obtenir une mesure précise.

Paramètres
`test`	`TestDescription` : identifie le test
`endTime`	`long` : heure à laquelle le test s'est terminé, mesurée via `System.currentTimeMillis()`
`testMetrics`	: `ERROR(/Map)` des métriques émises.

testEnded

public void testEnded (TestDescription test, 
                 testMetrics)

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

Si testFailed(TestDescription, FailureDescription) 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`	`TestDescription` : identifie le test
`testMetrics`	: `ERROR(/Map)` des métriques émises.

testFailed

public void testFailed (TestDescription test, 
                FailureDescription failure)

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

Sera appelé entre testStarted et testEnded.

Paramètres
`test`	`TestDescription` : identifie le test
`failure`	`FailureDescription` : `FailureDescription` décrivant l'échec et son contexte.

testFailed

public void testFailed (TestDescription test, 
                String trace)

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

Sera appelé entre testStarted et testEnded.

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

testIgnored

public void testIgnored (TestDescription 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`	`TestDescription` : identifie le test

testRunEnded

public void testRunEnded (long elapsedTimeMillis, 
                 runMetrics)

Rapports de fin de série de tests.

Paramètres
`elapsedTimeMillis`	`long` : temps écoulé indiqué par l'appareil, en millisecondes
`runMetrics`	: paires clé/valeur signalées à la fin d'une série de tests

testRunFailed

public void testRunFailed (FailureDescription failure)

L'exécution du test des rapports n'a pas pu être effectuée en raison d'un échec décrit par FailureDescription.

Paramètres
`failure`	`FailureDescription` : `FailureDescription` décrivant l'échec et son contexte.

testRunFailed

public 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 void testRunStarted (String runName, 
                int testCount, 
                int attemptNumber)

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
`attemptNumber`	`int` : numéro de commande, identifiant les différentes tentatives du même runName qui sont exécutées plusieurs fois. attemptNumber est indexé sur 0 et doit être incrémenté à chaque nouvelle exécution. Par exemple, si un test est retenté de manière précise trois fois, il doit comporter quatre exécutions au total sous le même runName, et attemptNumber doit être compris entre 0 et 3.

testRunStarted

public 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

testRunStarted

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

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
`attemptNumber`	`int` : numéro de commande, identifiant les différentes tentatives du même runName qui sont exécutées plusieurs fois. Le numéro de tentative est indexé sur 0 et doit être incrémenté à chaque nouvelle exécution. Par exemple, si un test est retenté de manière granulaire trois fois, il doit comporter quatre exécutions au total sous le même runName, et le numéro de tentative est compris entre 0 et 3.
`startTime`	`long` : heure de début de l'exécution, mesurée avec `System.currentTimeMillis()`

testRunStopped

public void testRunStopped (long elapsedTime)

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

TODO : actuellement inutilisé, pensez à le supprimer

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

testSkipped

public void testSkipped (TestDescription test, 
                SkipReason reason)

Appelée lorsqu'un test est ignoré et ne s'est pas exécuté pour une raison généralement inattendue. Nous allons essayer de relancer ces tests pour tenter de les exécuter correctement.

Paramètres
`test`	`TestDescription` : identifie le test
`reason`	`SkipReason` : `SkipReason`

testStarted

public void testStarted (TestDescription test, 
                long startTime)

Alternative à testStarted(com.android.tradefed.result.TestDescription) où nous spécifions également la date de début du test, combinée à ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,Map)) pour une mesure précise.

Paramètres
`test`	`TestDescription` : identifie le test
`startTime`	`long` : heure à laquelle le test a commencé, mesurée via `System.currentTimeMillis()`

testStarted

public void testStarted (TestDescription test)

Indique le début d'un scénario de test individuel. Ancienne interface. Utilisez testStarted(com.android.tradefed.result.TestDescription) autant que possible.

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