À 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.

ILogSaverListener

public interface ILogSaverListener
implements ITestInvocationListener

com.android.tradefed.result.ILogSaverListener

Sous-classes indirectes connues

AggregatePostProcessor, AndroidBuildResultReporter, AtraceCollector, AtraceRunMetricCollector, AveragePostProcessor, BaseDeviceMetricCollector, BasePostProcessor, BluetoothConnectionLatencyCollector, BluetoothConnectionStateCollector, BluetoothConnectionSuccessRatePostProcessor, BluetoothHciSnoopLogCollector, BugreportzOnFailureCollector, BugreportzOnTestCaseFailureCollector, ClangCodeCoverageCollector, CodeCoverageCollector, et 63 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 séries de tests, en les traitant comme des doubles.
AndroidBuildResultReporter	Rapporte les résultats des tests à l'API Android Build.
AtraceCollector	Un `IMetricCollector` qui exécute atrace pendant un test, collecte le résultat et l'enregistre dans l'appel.
AtraceRunMetricCollector	Collecte les traces de tous les répertoires de test sous le répertoire donné à partir de l'appareil de test, enregistre 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 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(DeviceMetricData)` et `onTestRunEnd(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 des é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 à tester et de collecter le journal pour chaque test.
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 extrait les mesures de couverture Clang de l'appareil et les enregistre en tant qu'artefacts de test.
CodeCoverageCollector	Un `BaseDeviceMetricCollector` qui extraira les mesures de couverture Java et native de l'appareil et les consignera en tant qu'artefacts de test.
CollectingTestListener	Un `ITestInvocationListener` qui collectera tous les résultats des tests.
ConsoleResultReporter	Outil de génération de rapports sur les résultats pour imprimer les résultats des tests dans la console.
CountTestCasesCollector	Comptez et signalez le nombre de scénarios de test pour un `IRemoteTest` donné.
CoverageMetadataCollector	Un `ILogSaverListener` qui collecte les mesures de couverture enregistrées et génère un CoverageMetadataProto pour le traitement par le service de couverture du code Android.
DebugHostLogOnFailureCollector	Collecteur qui rassemblera et enregistrera les journaux côté hôte en cas d'échec d'un scénario de test.
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.
EventsLoggerListener	Écouteur qui enregistre tous les événements qu'il reçoit dans un fichier
FileProtoResultReporter	Rapporteur 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	Enregistreur du fichier signalé côté appareil.
FormattedGeneratorReporter	Outil de création de rapports permettant 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.
GeminiDebuggingPostProcessor	Le post-processeur crée des requêtes de prompt pour déboguer les erreurs.
GranularRetriableTestWrapper.StartEndCollector	Classe d'assistance pour détecter les heures de début et de fin d'exécution manquantes.
HostStatsdMetricCollector	Un `IMetricCollector` qui collecte les métriques statsd côté hôte à l'aide des commandes de l'utilitaire statsd.
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.
InvocationProtoResultReporter	Reporters pour stocker les informations de mise en cache au niveau de l'invocation et sa liste de modules
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 envoie à 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.
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 superclasse.
LogSaverResultForwarder	Un `ResultForwarder` pour enregistrer les journaux avec l'enregistreur de fichiers global.
LogcatOnFailureCollector	Collecteur qui capture et enregistre un logcat en cas d'échec d'un cas de test ou d'une série de tests.
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 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.
ModulePerfettoCollector	Collecteur qui démarre le traçage perfetto lorsqu'un module de test commence et se termine, et lorsque l'appareil redémarre.
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.
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étrique texte/binaire 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.
ProtoResultReporter	Le générateur de rapports sur les résultats crée un fichier protobuf `TestRecord` contenant tous les résultats.
RebootReasonCollector	Collecteur qui collecte les redémarrages d'appareils pendant l'exécution du test et les signale par motif et nombre.
RemoteTestTimeOutEnforcer	Listeners 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	Indiquez 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 réessai adoptée.
ResultAndLogForwarder	Redirecteur pour les résultats et les événements de journaux.
ResultDBReporter	Reporter de résultats qui importe les résultats des tests dans ResultDB.
ResultReporter
RetryLogSaverResultForwarder	Transmetteur qui gère également la transmission de la tentative actuelle.
RuntimeRestartCollector	Collecteur qui collecte les codes temporels des redémarrages d'exécution (plantages du serveur système) pendant l'exécution du test, le cas échéant.
ScreenRecordOnFailureCollector	Collecteur qui capture et enregistre une vidéo de l'écran lorsqu'un scénario de test échoue.
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 shard 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	Un `ResultForwarder` qui combine les résultats des appels de test fragmenté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.
SimpleperfProfilePostProcessor	Post-processeur qui recherche les données de profilage simpleperf et génère un profil pprof.
StatsdBeforeAfterGaugeMetricPostProcessor	Post-processeur qui traite les métriques de type "gauge" 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.
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.
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.

Permet aux ITestInvocationListeners d'écouter le moment où les fichiers journaux sont enregistrés.

Cela permet à plusieurs ITestInvocationListener d'utiliser le même fichier journal enregistré lors de la génération de rapports et évite que chaque écouteur enregistre le fichier individuellement lorsque ITestInvocationListener.testLog(String,LogDataType,InputStreamSource) est appelé.

Les classes qui implémentent cette interface doivent savoir que testLogSaved(String,LogDataType,InputStreamSource,LogFile) sera appelé chaque fois que ITestInvocationListener.testLog(String,LogDataType,InputStreamSource) est appelé.

Cette classe transmet également l'instance ILogSaver globale afin que les ITestInvocationListener puissent enregistrer des fichiers supplémentaires au même emplacement.

Résumé

Méthodes publiques
`default void`	`logAssociation(String dataName, LogFile logFile)` Dans certains cas, le journal doit être fortement associé à des cas de test, mais il n'est pas possible de le faire sur le rappel `testLogSaved(String,LogDataType,InputStreamSource,LogFile)` direct.
`default void`	`setLogSaver(ILogSaver logSaver)` Définissez `ILogSaver` pour permettre à l'intégrateur d'enregistrer des fichiers.
`default void`	`testLogSaved(String dataName, LogDataType dataType, InputStreamSource dataStream, LogFile logFile)` Appelé lorsque le journal de test est enregistré.

Méthodes publiques

logAssociation

public void logAssociation (String dataName, 
                LogFile logFile)

Dans certains cas, le journal doit être fortement associé à des cas de test, mais il n'est pas possible de le faire sur le rappel testLogSaved(String,LogDataType,InputStreamSource,LogFile) direct. Ce rappel permet donc de fournir explicitement une association forte.

Paramètres
`dataName`	`String` : nom des données
`logFile`	`LogFile` : le `LogFile` qui a été enregistré précédemment et qui doit être associé au scénario de test.

setLogSaver

public void setLogSaver (ILogSaver logSaver)

Définissez ILogSaver pour permettre à l'intégrateur d'enregistrer des fichiers.

Paramètres
`logSaver`	`ILogSaver` : `ILogSaver`

testLogSaved

public void testLogSaved (String dataName, 
                LogDataType dataType, 
                InputStreamSource dataStream, 
                LogFile logFile)

Appelé lorsque le journal de test est enregistré.

Doit être utilisé à la place de ITestInvocationListener.testLog(String,LogDataType,InputStreamSource).

Paramètres
`dataName`	`String` : nom descriptif `String` des données, par exemple "device_logcat". Remarque : dataName n'est pas forcément unique pour chaque appel. Autrement dit, les implémenteurs doivent pouvoir gérer plusieurs appels avec le même dataName.
`dataType`	`LogDataType` : `LogDataType` des données
`dataStream`	`InputStreamSource` : `InputStreamSource` des données. Les développeurs doivent appeler createInputStream pour commencer à lire les données et s'assurer de fermer l'InputStream résultant une fois l'opération terminée.
`logFile`	`LogFile` : `LogFile` contenant les métadonnées du fichier enregistré.