À 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 à AOSP, nous vous recommandons d'utiliser android-latest-release au lieu de aosp-main. 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.

IMetricCollector

public interface IMetricCollector
implements IDisableable, ILogSaverListener

com.android.tradefed.device.metric.IMetricCollector

Sous-classes indirectes connues

AtraceCollector, AtraceRunMetricCollector, BaseDeviceMetricCollector, BluetoothConnectionLatencyCollector, BluetoothConnectionStateCollector, BluetoothHciSnoopLogCollector, BugreportzOnFailureCollector, BugreportzOnTestCaseFailureCollector, ClangCodeCoverageCollector, CodeCoverageCollector, CountTestCasesCollector, DebugHostLogOnFailureCollector, DeviceTraceCollector, FilePullerDeviceMetricCollector, FilePullerLogCollector, et 14 autres.

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.
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))`.
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.
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.
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.
CountTestCasesCollector	Compte et signale le nombre de scénarios de test pour un `IRemoteTest` donné.
DebugHostLogOnFailureCollector	Collecteur qui collecte et enregistre 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.
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.
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.
HostStatsdMetricCollector	Un `IMetricCollector` qui collecte les métriques statsd côté hôte à l'aide des commandes de l'utilitaire statsd.
JavaCodeCoverageCollector	Un `BaseDeviceMetricCollector` qui extrait les mesures de couverture Java de l'appareil et les enregistre en tant qu'artefacts de 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.
ModuleLogcatCollector	Version du collecteur logcat, mais pour le module.
PerfettoFilePullerCollector	Un collecteur qui extrait les fichiers de trace Perfetto de l'appareil, les compresse éventuellement et les ajoute aux journaux de test.
PerfettoPullerMetricCollector	Cette classe est obsolète. Utilisez plutôt `PerfettoFilePullerCollector` et `ERROR(/PerfettoTracePostProcessor)`.
RebootReasonCollector	Collecteur qui collecte les redémarrages d'appareils pendant l'exécution du test et les signale par motif et nombre.
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.
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.
TraceCmdCollector	Un `IMetricCollector` qui collecte les traces pendant le test à l'aide de trace-cmd et les enregistre dans l'invocation.

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.

Cette interface ne peut pas être utilisée comme même si elle étend ITestInvocationListener. La vérification de la configuration le refusera. Il doit être utilisé comme "metrics_collector".

Les collecteurs ne sont pas censés conserver un état interne, car ils peuvent être réutilisés à plusieurs endroits. Si un état interne doit vraiment être utilisé, il doit être nettoyé sur init(com.android.tradefed.invoker.IInvocationContext, com.android.tradefed.result.ITestInvocationListener).

Résumé

Méthodes publiques
`default boolean`	`captureModuleLevel()` Indique si le collecteur s'applique à la capture au niveau du module et doit être initialisé.
`abstract`	`getBuildInfos()` Renvoie la liste des informations de compilation disponibles dans l'invocation.
`abstract`	`getDevices()` Renvoie la liste des appareils disponibles dans l'invocation.
`abstract ITestInvocationListener`	`getInvocationListener()` Renvoie le `ITestInvocationListener` d'origine vers lequel nous transférons les résultats.
`abstract ITestInvocationListener`	`init(IInvocationContext context, ITestInvocationListener listener)` Initialisation du collecteur avec le contexte actuel et l'emplacement où transférer les résultats.
`abstract void`	`onTestAssumptionFailure(DeviceMetricData testData, TestDescription test)` Callback lorsqu'un cas de test échoue en raison d'une hypothèse non respectée.
`abstract void`	`onTestEnd(DeviceMetricData testData, currentTestCaseMetrics, TestDescription test)` Rappel lorsqu'un cas de test est terminé.
`abstract void`	`onTestEnd(DeviceMetricData testData, currentTestCaseMetrics)` Rappel lorsqu'un cas de test est terminé.
`abstract void`	`onTestFail(DeviceMetricData testData, TestDescription test)` Callback when a test case fails.
`default void`	`onTestModuleEnded()` Permet de capturer l'événement de fin du module.
`default void`	`onTestModuleStarted()` Permet de capturer l'événement de démarrage du module.
`abstract void`	`onTestRunEnd(DeviceMetricData runData, currentRunMetrics)` Rappel lorsqu'une série de tests est terminée.
`abstract void`	`onTestRunStart(DeviceMetricData runData)` Rappel lorsqu'une série de tests est lancée.
`default void`	`onTestRunStart(DeviceMetricData runData, int testCount)` Rappel lorsqu'une série de tests est lancée.
`abstract void`	`onTestStart(DeviceMetricData testData)` Rappel lorsqu'un cas de test est lancé.

Méthodes publiques

captureModuleLevel

public boolean captureModuleLevel ()

Indique si le collecteur s'applique à la capture au niveau du module et doit être initialisé.

Renvoie
`boolean`

getBuildInfos

public abstract  getBuildInfos ()

Renvoie la liste des informations de compilation disponibles dans l'invocation.

Renvoie

getDevices

public abstract  getDevices ()

Renvoie la liste des appareils disponibles dans l'invocation.

Renvoie

getInvocationListener

public abstract ITestInvocationListener getInvocationListener ()

Renvoie le ITestInvocationListener d'origine vers lequel nous transférons les résultats.

Renvoie
`ITestInvocationListener`

init

public abstract ITestInvocationListener init (IInvocationContext context, 
                ITestInvocationListener listener)

Initialisation du collecteur avec le contexte actuel et l'emplacement où transférer les résultats. Ne sera appelé qu'une seule fois par instance, et le collecteur est censé mettre à jour son contexte et son écouteur internes. Init ne sera jamais appelé lors d'un test, mais toujours avant.

Ne remplacez pas cette valeur, sauf si vous savez ce que vous faites.

Paramètres
`context`	`IInvocationContext` : `IInvocationContext` pour l'invocation en cours.
`listener`	`ITestInvocationListener` : `ITestInvocationListener` où placer les résultats.

Renvoie
`ITestInvocationListener`	le nouvel écouteur encapsulant l'écouteur d'origine.

Génère
`DeviceNotAvailableException`

onTestAssumptionFailure

public abstract void onTestAssumptionFailure (DeviceMetricData testData, 
                TestDescription test)

Callback lorsqu'un cas de test échoue en raison d'une hypothèse non respectée.

Paramètres
`testData`	`DeviceMetricData` : `DeviceMetricData` contenant les données du cas de test.
`test`	`TestDescription` : `TestDescription` du cas de test en cours.

Génère
`DeviceNotAvailableException`

onTestEnd

public abstract void onTestEnd (DeviceMetricData testData, 
                 currentTestCaseMetrics, 
                TestDescription test)

Rappel lorsqu'un cas de test est terminé. C'est le moment de faire le ménage.

Paramètres
`testData`	`DeviceMetricData` : `DeviceMetricData` contenant les données du cas de test. Sera le même objet que lors de `onTestStart(com.android.tradefed.device.metric.DeviceMetricData)`.
`currentTestCaseMetrics`	: carte actuelle des métriques transmises à `ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map))`.
`test`	`TestDescription` : `TestDescription` du cas de test en cours.

Génère
`DeviceNotAvailableException`

onTestEnd

public abstract void onTestEnd (DeviceMetricData testData, 
                 currentTestCaseMetrics)

Rappel lorsqu'un cas de test est terminé. C'est le moment de faire le ménage.

Paramètres
`testData`	`DeviceMetricData` : `DeviceMetricData` contenant les données du cas de test. Sera le même objet que lors de `onTestStart(com.android.tradefed.device.metric.DeviceMetricData)`.
`currentTestCaseMetrics`	: carte actuelle des métriques transmises à `ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map))`.

Génère
`DeviceNotAvailableException`

onTestFail

public abstract void onTestFail (DeviceMetricData testData, 
                TestDescription test)

Rappel lorsqu'un scénario de test échoue.

Paramètres
`testData`	`DeviceMetricData` : `DeviceMetricData` contenant les données du cas de test.
`test`	`TestDescription` : `TestDescription` du cas de test en cours.

Génère
`DeviceNotAvailableException`

onTestModuleEnded

public void onTestModuleEnded ()

Permet de capturer l'événement de fin du module.

Génère
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

onTestModuleStarted

public void onTestModuleStarted ()

Permet de capturer l'événement de démarrage du module.

Génère
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

onTestRunEnd

public abstract void onTestRunEnd (DeviceMetricData runData, 
                 currentRunMetrics)

Rappel lorsqu'une série de tests est terminée. C'est le moment de faire le ménage.

Paramètres
`runData`	`DeviceMetricData` : `DeviceMetricData` contenant les données de l'exécution. Sera le même objet que lors de `onTestRunStart(com.android.tradefed.device.metric.DeviceMetricData)`.
`currentRunMetrics`	: carte actuelle des métriques transmises à `ERROR(/#testRunEnded(long,Map))`.

Génère
`DeviceNotAvailableException`

onTestRunStart

public abstract void onTestRunStart (DeviceMetricData runData)

Rappel lorsqu'une série de tests est lancée.

Paramètres
`runData`	`DeviceMetricData` : `DeviceMetricData` contenant les données de l'exécution.

Génère
`DeviceNotAvailableException`

onTestRunStart

public void onTestRunStart (DeviceMetricData runData, 
                int testCount)

Rappel lorsqu'une série de tests est lancée.

Paramètres
`runData`	`DeviceMetricData` : `DeviceMetricData` contenant les données de l'exécution.
`testCount`	`int` : nombre de cas de test dans cette exécution de test.

Génère
`DeviceNotAvailableException`

onTestStart

public abstract void onTestStart (DeviceMetricData testData)

Rappel lorsqu'un cas de test est lancé.

Paramètres
`testData`	`DeviceMetricData` : `DeviceMetricData` contenant les données du cas de test.

Génère
`DeviceNotAvailableException`