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 , BugreportzOnFailureColl ector , BugreportzOnTestCaseFailureCollector , ClangCodeCoverageCollector , CollectingTestListener et 76 autres.

AggregatePostProcessor	Un agrégateur de métriques qui donne le minimum, le maximum, la moyenne, la variance, l'écart type, le total, le nombre et éventuellement les centiles pour les métriques numériques collectées lors d'exécutions de tests à plusieurs itérations, en les traitant comme des doubles.
AtraceCollector	Un `IMetricCollector` qui exécute une trace pendant un test, collecte le résultat et le consigne dans l'invocation.
AtraceRunMetricCollector	Collecte les traces de tout le répertoire de test sous le répertoire donné à partir du périphérique de test, enregistre le répertoire de test et post-traite les fichiers de trace sous le répertoire de test et regroupe les métriques.
MoyennePostProcesseur	Implémentation d'un 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 transmettra une configuration métrique de durée de statistiques prédéfinie aux appareils et collectera la durée de connexion Bluetooth pour chaque profil.
BluetoothConnectionStateCollector	Ce collecteur collectera les métriques BluetoothConnectionStateChanged et enregistrera le numéro d’état de connexion pour chaque profil.
BluetoothConnectionSuccessRatePostProcessor	Implémentation d'un postprocesseur 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 pour activer la journalisation de surveillance Bluetooth HCI sur le DUT et pour collecter le journal pour chaque test.
Collecteur de rapports de bogues	Un `ITestInvocationListener` relais qui collecte les rapports de bogues lorsque des événements configurables se produisent, puis appelle `ITestInvocationListener#testLog` sur ses enfants après la collecte de chaque rapport de bogue.
BugreportzOnFailureCollector	Collectez un rapport de bug lorsqu'un scénario de test échoue.
BugreportzOnTestCaseFailureCollector	Collectez un rapport de bug 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.
CollecteTestListener	Un `ITestInvocationListener` qui collectera tous les résultats des tests.
Gestionnaire d'état de commande	Gestionnaire aidant à surveiller et à mettre à jour l’état d’une invocation.
ConditionFailureMonitor	Surveillez tout échec de l’appel.
ConsoleResultReporter	Reporteur de résultats pour imprimer les résultats des tests sur la console.
CountTestCasesCollector	Comptez et signalez le nombre de cas de test pour un `IRemoteTest` donné.
CountingTestResultListener	Un `TestResultListener` qui suit le nombre total de tests par `TestStatus`
DebugHostLogOnFailureCollector	Collecteur qui rassemblera et enregistrera les journaux côté hôte lorsqu'un échec de scénario de test se produit.
DeviceReleaseReporter	Reporteur de version de périphérique qui gère la communication avec le processus parent sur le ou les périphériques à libérer.
DeviceTraceCollector	Collecteur qui démarrera la trace parfaite au démarrage d'un test et enregistrera le fichier de trace à la fin.
AppareilIndisponibleMoniteur	Cet écouteur tente de capturer uniquement un DNAE au niveau du cas de test.
EventsLoggerListener	Écouteur qui enregistre tous les événements qu'il reçoit dans un fichier
FileProtoResultReporter	Reporteur Proto qui vide le `TestRecord` dans un fichier.
FilePullerDeviceMetricCollector	Un `BaseDeviceMetricCollector` qui écoute les clés de métriques provenant de l'appareil et les extrait sous forme de fichier de l'appareil.
FilePullerLogCollector	Enregistreur du fichier signalé par le côté appareil.
FilteredResultForwarder	Variante de `ResultForwarder` qui permet uniquement de signaler une liste blanche de `TestDescription` .
FormattedGeneratorReporter	Reporter qui permet de générer des rapports dans un format particulier.
GcovCodeCoverageCollector	Un `BaseDeviceMetricCollector` qui extraira les mesures de couverture gcov de l'appareil et les enregistrera en tant qu'artefacts de test.
GcovKernelCodeCoverageCollector	Un `BaseDeviceMetricCollector` qui extraira les mesures de couverture du noyau gcov des débogages et du périphérique, puis les enregistrera finalement en tant qu'artefacts de test.
GranularRetriableTestWrapper.StartEndCollector	Assistant de classe pour détecter le début et la fin d'une course manquante.
HostStatsdMetricCollector	Un `IMetricCollector` qui collecte les métriques statsd du côté hôte à l'aide des commandes de l'utilitaire statsd.
ICommandScheduler.IScheduledInvocationListener	Écouteur des événements d’invocation une fois l’invocation terminée.
ILogSaverListener	Permet aux `ITestInvocationListener` d'écouter lorsque les fichiers journaux sont enregistrés.
IMetricCollector	Cette interface sera ajoutée en tant que décorateur lors du reporting des résultats des tests afin de collecter les métriques correspondantes.
IPostProcesseur	Les post-processeurs sont un objet de la Fédération du commerce destiné à permettre le traitement des métriques et des journaux APRÈS les tests et AVANT le rapport des résultats.
IShardableListener	Un `ITestInvocationListener` qui peut être fragmenté.
ISupportGranularResults	Interface spécifiant si un `ITestInvocationListener` prend en charge ou non la réception des résultats granulaires.
ITestInvocationListener	Écouteur des résultats de test de l’invocation de test.
ITestSummaryListener	Interface qui permet à `ITestInvocationListener` d'échanger certaines informations limitées via des résumés.
InvocationToJUnitResultForwarder	Une classe qui écoute les événements `ITestInvocationListener` et les transmet à un `TestListener` .
JarHostTest.HostTestListener	Écouteur wrapper qui transmet tous les événements sauf testRunStarted() et testRunEnded() vers l'écouteur intégré.
JavaCodeCoverageCollector	Un `BaseDeviceMetricCollector` qui extraira les mesures de couverture Java de l'appareil et les enregistrera en tant qu'artefacts de test.
JsonHttpTestResultReporter	Un rapporteur de résultats qui encode les résultats des métriques de test et les informations sur les appareils en JSON et POST dans un point de terminaison de service HTTP.
LUCIResultReporter	Un rapporteur de résultats qui enregistre les résultats des tests nécessaires à ResultDB et LUCI au format JSON (go/result-sink) et enregistre l'emplacement du fichier dans la console.
DernierDétecteur de fragments	Lors de l'exécution d'un partitionnement local, nous souhaitons parfois exécuter certaines actions uniquement lorsque le dernier fragment atteint `invocationEnded(long)` .
LegacySubprocessResultsReporter	Une implémentation gelée du rapporteur de résultats de sous-processus qui devrait rester compatible avec les versions antérieures de TF/CTS (par exemple 8+), malgré les changements dans sa superclasse.
LogSaverResultForwarder	Un `ResultForwarder` pour enregistrer les journaux avec l'économiseur de fichiers global.
LogcatCrashResultForwarder	Écouteur spécial : en cas d'échec (plantage du processus d'instrumentation), il tentera d'extraire du logcat le crash et l'ajoutera au message d'échec associé au test.
LogcatOnFailureCollector	Collecteur qui capturera et enregistrera un logcat lorsqu'un scénario de test échoue.
LogcatTimingMetricCollector	Un collecteur de métriques qui collecte des informations de synchronisation (par exemple, l'heure de changement d'utilisateur) à partir de logcat lors d'un ou 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	Utilisé pour télécharger le fichier journal des métriques collecté pendant le niveau de test et d'exécution.
MetricsXMLResultReporter	MetricsXMLResultReporter écrit les métriques de test et exécute les métriques dans un fichier XML dans un dossier spécifié par le paramètre metrics-folder lors de la phase invocationEnded du test.
ModuleÉcouteur	Listener attaché à chaque `IRemoteTest` de chaque module afin de récupérer la liste des résultats.
ModuleLogcatCollector	Version du collecteur logcat mais pour le module.
NomMangleListener	Un écouteur proxy pour traduire les noms de méthodes de test, de classes et de packages au fur et à mesure que les résultats sont rapportés.
PassingTestFileReporter	Un `ITestInvocationListener` qui enregistre la liste des cas de test réussis dans un fichier de test
PerfettoGenericPostProcessor	Un post-processeur qui traite le fichier proto texte/métrique binaire parfait en paires clé-valeur en développant de manière récursive les messages proto et les champs avec des valeurs de chaîne jusqu'à ce que le champ avec une valeur numérique soit rencontré.
PerfettoPullerMetricCollector	Implémentation de base de `FilePullerDeviceMetricCollector` qui permet d'extraire les fichiers parfaits de l'appareil et d'en collecter les métriques.
JoliTestEventLogger	Enregistreur faisant correspondre les événements et les enregistrant afin de faciliter le débogage.
ProtoResultReporter	Le rapporteur de résultats crée un protobuf `TestRecord` avec tous les résultats à l'intérieur.
PythonBinaryHostTest.PythonForwarder	redirecteur de résultats pour remplacer le nom d'exécution par le nom binaire.
RebootReasonCollector	Collecteur qui collecte le redémarrage de l'appareil pendant l'exécution du test et les signale par raison et nombre.
RemoteTestTimeOutEnforcer	Des écouteurs qui permettent de vérifier le temps d'exécution d'une configuration de test donnée et de l'échouer si elle dépasse un délai d'attente donné.
RapportPassedTests	Signaler dans un fichier les filtres possibles pour exclure le test réussi.
Agrégateur de résultats	Transitaire spécial qui regroupe les résultats en cas de besoin, en fonction de la stratégie de nouvelle tentative adoptée.
RésultatEtLogForwarder	Forwarder pour les résultats et les événements de journaux.
Transmetteur de résultats	`ITestInvocationListener` qui transmet les résultats de l'appel à une liste d'autres écouteurs.
RetryLogSaverResultForwarder	Forwarder qui gère également la tentative actuelle dans laquelle nous nous trouvons.
RéessayerResultForwarder	Une extension de `ResultForwarder` qui pousse toujours vers un numéro de tentative donné.
RuntimeRestartCollector	Collecteur qui collecte les horodatages des redémarrages d'exécution (pannes du serveur système) pendant l'exécution du test, le cas échéant.
Capture d'écran sur FailureCollector	Collecteur qui capturera et enregistrera une capture d'écran lorsqu'un scénario de test échoue.
ShardListener	Un `ITestInvocationListener` qui collecte les résultats d'une partition d'appel (c'est-à-dire une division d'appel à exécuter sur plusieurs ressources en parallèle) et les transmet à un autre écouteur.
ShardMainResultForwarder	Un `ResultForwarder` qui combine les résultats d’appels de test fragmentés.
ShowmapPullerMetricCollector	Implémentation de base de `FilePullerDeviceMetricCollector` qui permet d'extraire les fichiers showmap de l'appareil et d'en collecter les métriques.
StatsdBeforeAfterGaugeMetricPostProcessor	Un post-processeur qui traite les métriques de jauge collectées selon une approche « avant/après », c'est-à-dire
StatsdEventMetricPostProcessor	Un 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	Un post-processeur qui traite les rapports proto statsd binaires en paires clé-valeur en développant le rapport sous forme d'arborescence.
StreamProtoResultReporter	Une 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 invocations de tests.
SuiteResultReporter	Collectez les résultats des tests pour un appel de suite complet et affichez les résultats finaux.
TestFailureListener	L'écouteur avait l'habitude de prendre des mesures telles qu'une capture d'écran, un rapport de bogue, une collecte de logcat en cas d'échec d'un test, sur demande.
TestResultListener	Une simplification de ITestLifecycleListener pour les implémenteurs qui ne se soucient que des résultats de tests individuels.
TestTimeoutEnforcer	Des écouteurs qui permettent de vérifier le temps d'exécution d'un scénario de test donné et de l'échouer s'il dépasse un délai d'attente donné.
TextReporter	Un rapporteur de résultats de test qui transmet les résultats à l'imprimante de résultats de texte JUnit.
TraceCmdCollector	`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 du `FormattedGeneratorReporter` qui formate la suite au format XML.
XmlResultReporter	É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 pendant les tests d’instrumentation.

Inspiré de org.junit.runner.notification.RunListener

La séquence d'appels sera la suivante :

testRunStarted
testDémarré
[test échoué]
[testAssomptionFailure]
[testIgnoré]
testFin
....
[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 fausse
`default void`	`testAssumptionFailure ( TestDescription test, FailureDescription failure)` Appelé lorsqu'un test atomique signale qu'il suppose une condition fausse
`default void`	`testEnded ( TestDescription test, long endTime, testMetrics)` `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)` `testEnded ( TestDescription test, testMetrics)` Signale la fin de l’exécution d’un scénario de test individuel.
`default void`	`testFailed ( TestDescription test, FailureDescription failure)` Signale l’échec d’un scénario de test individuel.
`default void`	`testFailed ( TestDescription test, String trace)` Signale l’échec d’un scénario 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)` `testRunEnded (long elapsedTimeMillis, runMetrics)` Signale la fin du test.
`default void`	`testRunFailed ( FailureDescription failure)` L’exécution du test des rapports n’a pas abouti en raison d’un échec décrit par `FailureDescription` .
`default void`	`testRunFailed (String errorMessage)` L’exécution du test des rapports n’a pas abouti en raison d’une erreur fatale.
`default void`	`testRunStarted (String runName, int testCount, int attemptNumber)` Signale le début d’une exécution de test.
`default void`	`testRunStarted (String runName, int testCount)` Signale le début d’une exécution de test.
`default void`	`testRunStarted (String runName, int testCount, int attemptNumber, long startTime)` Signale le début d’une exécution de test.
`default void`	`testRunStopped (long elapsedTime)` L’exécution du test des rapports s’est arrêtée avant la fin en raison d’une demande de l’utilisateur.
`default void`	`testStarted ( TestDescription test, long startTime)` Alternative à `testStarted(com.android.tradefed.result.TestDescription)` où nous spécifions également quand le test a été démarré, combiné avec `ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,Map))` pour une mesure précise .
`default void`	`testStarted ( TestDescription test)` Signale le début d’un scénario de test individuel.

Méthodes publiques

testhypothèseéchec

public void testAssumptionFailure (TestDescription test, 
                String trace)

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

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

testhypothèseéchec

public void testAssumptionFailure (TestDescription test, 
                FailureDescription failure)

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

Paramètres
`test`	`TestDescription` : identifie le test
`failure`	`FailureDescription` : `FailureDescription` décrivant la panne et son contexte.

testFin

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 avec testStarted(com.android.tradefed.result.TestDescription, long) pour une mesure précise.

Paramètres
`test`	`TestDescription` : identifie le test
`endTime`	`long` : l'heure de fin du test, mesurée via `System.currentTimeMillis()`
`testMetrics`	: une `ERROR(/Map)` des métriques émises

testFin

public void testEnded (TestDescription test, 
                 testMetrics)

Signale la fin de l’exécution d’un scénario de test individuel.

Si testFailed(TestDescription, FailureDescription) n’a pas été invoqué, ce test a réussi. Renvoie également toutes les métriques clé/valeur qui peuvent avoir été émises lors de l'exécution du scénario de test.

Paramètres
`test`	`TestDescription` : identifie le test
`testMetrics`	: une `ERROR(/Map)` des métriques émises

test échoué

public void testFailed (TestDescription test, 
                FailureDescription failure)

Signale l’échec d’un scénario de test individuel.

Sera appelé entre testStarted et testEnded.

Paramètres
`test`	`TestDescription` : identifie le test
`failure`	`FailureDescription` : `FailureDescription` décrivant la panne et son contexte.

test échoué

public void testFailed (TestDescription test, 
                String trace)

Signale l’échec d’un scénario de test individuel.

Sera appelé entre testStarted et testEnded.

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

testIgnoré

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)

Signale la fin du test. FIXME : Nous ne pouvons pas avoir deux interfaces Map<> de type différent, nous devons donc utiliser HashMap ici.

Paramètres
`elapsedTimeMillis`	`long` : l'appareil a signalé le temps écoulé, en millisecondes
`runMetrics`	: paires clé-valeur signalées à la fin d'un test avec `Metric` .

testRunFailed

public void testRunFailed (FailureDescription failure)

L’exécution du test des rapports n’a pas abouti en raison d’un échec décrit par FailureDescription .

Paramètres
`failure`	`FailureDescription` : `FailureDescription` décrivant la panne et son contexte.

testRunFailed

public void testRunFailed (String errorMessage)

L’exécution du test des rapports n’a pas abouti 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)

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

Paramètres
`runName`	`String` : le nom du test
`testCount`	`int` : nombre total de tests en cours de test
`attemptNumber`	`int` : numéro d'ordre, identifiant les différentes tentatives d'un même runName qui s'exécutent plusieurs fois. Le tentNumber est indexé sur 0 et doit s’incrémenter à chaque fois qu’une nouvelle exécution se produit. Par exemple, un test granulaire est réessayé 3 fois, il doit avoir 4 exécutions au total sous le même nom d'exécution et le numéro de tentative est compris entre 0 et 3.

testRunStarted

public void testRunStarted (String runName, 
                int testCount)

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

Paramètres
`runName`	`String` : le nom du test
`testCount`	`int` : nombre total de tests en cours de test

testRunStarted

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

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

Paramètres
`runName`	`String` : le nom du test
`testCount`	`int` : nombre total de tests en cours de test
`attemptNumber`	`int` : numéro d'ordre, identifiant les différentes tentatives d'un même runName qui s'exécutent plusieurs fois. Le tentNumber est indexé sur 0 et doit s’incrémenter à chaque fois qu’une nouvelle exécution se produit. Par exemple, un test granulaire est réessayé 3 fois, il doit avoir 4 exécutions au total sous le même nom d'exécution et le numéro de tentative est compris entre 0 et 3.
`startTime`	`long` : l'heure de démarrage de l'exécution, mesurée via `System.currentTimeMillis()`

testRunStopped

public void testRunStopped (long elapsedTime)

L’exécution du test des rapports s’est arrêtée avant la fin en raison d’une demande de l’utilisateur.

TODO : actuellement inutilisé, pensez à le supprimer

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

testDémarré

public void testStarted (TestDescription test, 
                long startTime)

Alternative à testStarted(com.android.tradefed.result.TestDescription) où nous spécifions également quand le test a été démarré, combiné avec ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,Map)) pour une mesure précise .

Paramètres
`test`	`TestDescription` : identifie le test
`startTime`	`long` : l'heure de démarrage du test, mesurée via `System.currentTimeMillis()`

testDémarré

public void testStarted (TestDescription test)

Signale le début d’un scénario de test individuel. L'interface plus ancienne doit utiliser testStarted(com.android.tradefed.result.TestDescription) autant que possible.

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