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

ITestInvocationListener

public interface ITestInvocationListener
implements ITestLifeCycleReceiver, ITestLogger

com.android.tradefed.result.ITestInvocationListener

Sous-classes indirectes connues

AggregatePostProcessor	Agrégateur de métriques qui indique la valeur minimale, la valeur maximale, 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 test à plusieurs itérations, en les traitant comme des doubles.
AtraceCollector	`IMetricCollector` qui exécute une trace pendant un test, collecte le résultat et les consigne dans l'appel.
AtraceRunMetricCollector	Collecte les traces de l'ensemble du répertoire de test sous le répertoire donné à partir de l'appareil de test, consigne le répertoire de test et post-traite les fichiers de trace sous le répertoire de test, puis agrège les métriques.
AveragePostProcessor	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 de métrique de durée statsd prédéfinie aux appareils et collectera la durée de la connexion Bluetooth pour chaque profil.
BluetoothConnectionStateCollector	Ce collecteur collecte les métriques BluetoothConnectionStateChanged et enregistre le numéro d'état de la connexion pour chaque profil.
BluetoothConnectionSuccessRatePostProcessor	Implémentation d'un post-processeur qui calcule le taux de réussite pour un profil Bluetooth Utilisez "metric-key-match" pour spécifier les métriques contenant des états de connexion Bluetooth dans un tableau numérique (par exemple, [0, 1, 2, 3, 0, 1, 2, 3]).
BluetoothHciSnoopLogCollector	Le collecteur permet d'activer la journalisation du trafic HCI Bluetooth sur l'appareil testé et de collecter le journal de chaque test.
BugreportCollector	`ITestInvocationListener` de passthrough qui collecte les rapports de bugs 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 cas de test d'une exécution échoue.
ClangCodeCoverageCollector	Un `BaseDeviceMetricCollector` qui extrait les mesures de couverture Clang de l'appareil et les consigne en tant qu'artefacts de test.
CollectingTestListener	Un `ITestInvocationListener` qui collecte tous les résultats des tests.
CommandStatusHandler	Gestionnaire permettant de surveiller et de mettre à jour l'état d'une invocation.
ConditionFailureMonitor	Surveillez les échecs d'appel.
ConsoleResultReporter	Rapporteur de résultats pour imprimer les résultats du test dans la console.
CountTestCasesCollector	Compte et indique le nombre de scénarios de test pour un `IRemoteTest` donné.
DebugHostLogOnFailureCollector	Collecteur qui collecte et consigne les journaux côté hôte en cas d'échec d'un cas de test.
DeviceReleaseReporter	Outil de signalement de la libération de l'appareil qui gère la communication avec le processus parent de l'appareil ou des appareils à libérer.
DeviceTraceCollector	Collecteur qui démarre le traçage perfetto au début d'une exécution de test et enregistre le fichier de traçage à la fin.
Écran non disponible	Cet écouteur tente de capturer un DNAE au niveau du scénario de test uniquement.
EventsLoggerListener	Écouteur qui consigne tous les événements reçus dans un fichier
FileProtoResultReporter	Rapporteur Proto qui transfère `TestRecord` dans un fichier.
FilePullerDeviceMetricCollector	Un `BaseDeviceMetricCollector` qui écoute la clé de métrique provenant de l'appareil et la récupère en tant que fichier de l'appareil.
FilePullerLogCollector	Enregistreur du fichier signalé côté 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 permettant de générer des rapports dans un format particulier.
GcovCodecoverCollector	Un `BaseDeviceMetricCollector` qui extrait les mesures de couverture gcov de l'appareil et les consigne en tant qu'artefacts de test.
GcovKernelCodeCoverageCollector	Un `BaseDeviceMetricCollector` qui extrait les mesures de couverture du noyau gcov des debugfs et de l'appareil, puis les consigne en tant qu'artefacts de test.
GranularRetriableTestWrapper.StartEndCollector	Assistant de classe pour détecter le début et la fin de l'exécution manquants.
HostStatsdMetricCollector	Un `IMetricCollector` qui collecte des métriques statsd côté hôte à l'aide de commandes d'utilitaire statsd.
ICommandScheduler.IScheduledInvocationListener	Écouteur des événements d'invocation une fois l'invocation terminée.
ILogSaverListener	Permet aux `ITestInvocationListener` d'écouter les fichiers journaux lorsqu'ils 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 un objet de fédération du commerce destiné à 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	Un `ITestInvocationListener` qui peut être segmenté.
ISupportGranularResults	Interface spécifiant si un `ITestInvocationListener` est compatible avec la réception des résultats détaillés ou non.
ITestSummaryListener	Interface permettant à `ITestInvocationListener` d'échanger certaines informations limitées via des récapitulatifs.
InvocationToJUnitResultForwarder	Une classe qui écoute les événements `ITestInvocationListener` et les transmet à `TestListener`.
JarHostTest.HostTestListener	Écouteur de wrapper qui transfère 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 consigne en tant qu'artefacts de test.
JsonHttpTestResultReporter	Un rapporteur de résultats qui encode les résultats des métriques de test, ainsi que la branche et les informations sur l'appareil au format JSON et POST dans un point de terminaison de service HTTP
LUCIResultReporter	Rapporteur de résultats qui enregistre les résultats des tests requis par ResultDB et LUCI au format JSON (go/result-sink) et enregistre l'emplacement du fichier dans la console.
LastShardDetector	Lorsque vous exécutez le fractionnement local, il arrive que vous ne souhaitiez exécuter certaines actions que lorsque le dernier segment atteint `invocationEnded(long)`.
LegacySubprocessResultsReporter	Implémentation figée du rapporteur de résultats du sous-processus qui devrait rester compatible avec les versions antérieures de TF/CTS (par exemple, version 8 et ultérieures), malgré les modifications apportées à sa superclasse.
LogSaverResultForwarder	`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 du logcat le plantage 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 temporelles (par exemple, le temps de changement de l'utilisateur) à partir de logcat pendant un ou plusieurs tests répétés. Il utilise 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 de journal des métriques collecté au niveau du test et de l'exécution.
MetricsXMLResultReporter	MetricsXMLResultReporter écrit les métriques de test et les exécute dans un fichier XML situé dans un dossier spécifié par le paramètre "metrics-folder" à 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	Outil de création de rapports sur les résultats destiné à générer uniquement des rapports au niveau du module.
NameMangleListener	Un écouteur proxy pour traduire les noms de méthode, de classe et de package de test lorsque 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
PerfettoGenericPostProcessor	Post-processeur qui convertit le fichier proto de métrique textuelle/binaire perfetto 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	Implémentation de base de `FilePullerDeviceMetricCollector` qui permet d'extraire les fichiers Perfetto de l'appareil et de collecter les métriques à partir de celui-ci.
PrettyTestEventLogger	Journalisation des événements afin de faciliter le débogage.
ProtoResultReporter	Result Reporter crée un protobuf `TestRecord` contenant tous les résultats.
PythonBinaryHostTest.PythonForwarder	Transmetteur de résultats pour remplacer le nom de l'exécution par le nom binaire.
RedémarrerReasonCollector	Collecteur qui collecte les redémarrages de l'appareil pendant l'exécution du test et les signale par raison et nombre.
RemoteTestTimeOutEnforcer	Les écouteurs permettent de vérifier la durée d'exécution d'une configuration de test donnée et de l'échouer si elle dépasse un certain délai.
ReportPassedTests	Enregistrez dans un fichier les filtres possibles pour exclure les tests réussis.
ResultAggregator	Transmetteur spécial qui agrège les résultats si nécessaire, en fonction de la stratégie de nouvelle tentative adoptée.
ResultAndLogForwarder	Redirecteur des résultats et des événements de journalisation.
ResultForwarder	`ITestInvocationListener` qui transfère les résultats d'invocation à une liste d'autres écouteurs.
RetryLogSaverResultForwarder	Transmetteur qui gère également la transmission de la tentative en cours.
RetryResultForwarder	Extension de `ResultForwarder` qui pousse toujours vers un numéro d'essai donné.
RuntimeRestartCollector	Collecteur qui collecte les codes temporels des redémarrages de l'environnement d'exécution (plantages du serveur système) pendant l'exécution du test, le cas échéant.
ScreenshotOnFailureCollector	Collecteur qui capture et consigne une capture d'écran lorsqu'un cas de test échoue.
ShardListener	Un objet `ITestInvocationListener` qui collecte les résultats d'un segment d'appel (également appelé "scission d'appel" à exécuter sur plusieurs ressources en parallèle) et les transmet à un autre écouteur.
ShardMainResultForwarder	`ResultForwarder` qui combine les résultats d'appels de test segmentés.
ShowmapPullerMetricCollector	Implémentation de base de `FilePullerDeviceMetricCollector` qui permet d'extraire les fichiers de la carte de l'appareil et d'en collecter les métriques.
StatsdBeforeAfterGaugeMetricPostProcessor	Un post-traitement qui traite les métriques de jauge collectées dans une approche avant/après, c'est-à-dire
StatsdEventMetricPostProcessor	Post-processeur qui transforme les métriques d'événement dans les rapports statsd en paires clé-valeur, à l'aide des formats spécifiés sur le processeur.
StatsdGenericPostProcessor	Post-traitement qui convertit les rapports proto statsd binaires en paires clé-valeur en développant le rapport sous forme de structure arborescente.
StreamProtoResultReporter	Implémentation de `ProtoResultReporter`
SubprocessResultsReporter	Met en œuvre `ITestInvocationListener` pour être spécifié en tant que result_reporter et transférer à partir du sous-processus les résultats des tests, des exécutions de test et des appels de test.
SuiteResultReporter	Collectez les résultats des tests pour une invocation de suite complète et affichez les résultats finaux.
TestRunResultListener	Paramètre "Listener" permettant de lire l'état final de l'exécution du test
TestTimeoutEnforcer	Les écouteurs permettent de vérifier la durée d'exécution d'un scénario de test donné et d'échouer en cas de dépassement du délai avant expiration.
TextResultReporter	Un outil de création de rapports sur les résultats des tests qui transfère les résultats à l'imprimante de résultats textuels JUnit.
TraceCmdCollector	Un `IMetricCollector` qui collecte des traces pendant le test à l'aide de trace-cmd et les consigne dans l'appel.
TradefedSandboxRunner.StubScheduledInvocationListener	Un bouchon `IScheduledInvocationListener` qui n'a aucun effet.
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 un fichier XML au format compatible avec XMLJUnitResultFormatter d'Ant.

Écouteur des résultats des tests à partir de l'appel de test.

Une invocation de test peut elle-même inclure plusieurs exécutions de test. La séquence d'appels sera donc

invocationStarted(BuildInfo)
testRunStarted
testStarted
[ÉchecTest]
testEnded
...
testRunEnded
...
testRunStarted
...
testRunEnded
[invocationFailed]
[JournalTest+]
invocationEnded
getSummary

Résumé

Méthodes publiques
`default TestSummary`	`getSummary()` Permet à InvocationListener de renvoyer un récapitulatif.
`default void`	`invocationEnded(long elapsedTime)` Indique que l'appel a pris fin, que ce soit avec succès ou en raison d'une condition d'erreur.
`default void`	`invocationFailed(FailureDescription failure)` Signale une invocation incomplète en raison d'une condition d'erreur.
`default void`	`invocationFailed(Throwable cause)` Signale une invocation incomplète en raison d'une condition d'erreur.
`default void`	`invocationInterrupted()` Appelé lors de l'arrêt du planificateur, permet à l'appel d'effectuer une action avant de s'arrêter.
`default void`	`invocationSkipped(SkipReason reason)` Signale un appel comme ignoré
`default void`	`invocationStarted(IInvocationContext context)` Indique le début de l'appel de test.
`default void`	`testModuleEnded()` Signale la fin de l'exécution d'un module.
`default void`	`testModuleStarted(IInvocationContext moduleContext)` Indique le début de l'exécution d'un module.

Méthodes publiques

getSummary

public TestSummary getSummary ()

Permet à InvocationListener de renvoyer un récapitulatif.

Renvoie
`TestSummary`	Valeur `TestSummary` résumant l'exécution, ou valeur nulle

invocationEnded

public void invocationEnded (long elapsedTime)

Indique que l'appel a pris fin, que ce soit avec succès ou en raison d'une condition d'erreur.

Appelé automatiquement par le framework TradeFederation.

Paramètres
`elapsedTime`	`long`: temps écoulé de l'appel en ms

invocationFailed

public void invocationFailed (FailureDescription failure)

Signale une invocation incomplète en raison d'une condition d'erreur.

Sera automatiquement appelée par le framework TradeFederation.

Paramètres
`failure`	`FailureDescription`: `FailureDescription` décrivant la cause de l'échec

invocationFailed

public void invocationFailed (Throwable cause)

Signale une invocation incomplète en raison d'une condition d'erreur.

Appelé automatiquement par le framework TradeFederation.

Paramètres
`cause`	`Throwable`: cause `Throwable` de l'échec

invocationInterrupted

public void invocationInterrupted ()

Appelé lors de l'arrêt du planificateur, permet à l'appel d'effectuer une action avant de s'arrêter.

invocationSkipped

public void invocationSkipped (SkipReason reason)

Signale une invocation comme ignorée

Paramètres
`reason`	`SkipReason`

appel démarré

public void invocationStarted (IInvocationContext context)

Indique le début de l'appel de test.

Appelé automatiquement par le framework TradeFederation. Les signalements doivent remplacer cette méthode pour permettre la création de rapports sur plusieurs appareils.

Paramètres
`context`	`IInvocationContext`: informations sur l'appel

testModuleEnded

public void testModuleEnded ()

Signale la fin de l'exécution d'un module.

testModuleStarted

public void testModuleStarted (IInvocationContext moduleContext)

Indique le début d'un module en cours d'exécution. Ce rappel est associé à testModuleEnded() et est facultatif dans la séquence. Il n'est utilisé que lors d'une exécution qui fait appel à des modules, à savoir des exécuteurs basés sur une suite.

Paramètres
`moduleContext`	`IInvocationContext` : `IInvocationContext` du module.