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

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 13 autres.

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.
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 transmettra 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 collectera les métriques BluetoothConnectionStateChanged et enregistrera le numéro d'état de la 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 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.
CodeCoverageCollector	Un `BaseDeviceMetricCollector` qui extrait les mesures de couverture Java et native de l'appareil et les consigne en tant qu'artefacts de test.
CountTestCasesCollector	Comptez et signalez 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.
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.
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.
GcovCodeCoverageCollector	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 kernel gcov des debugfs et de l'appareil, puis les consigne en tant qu'artefacts de test.
HostStatsdMetricCollector	Un `IMetricCollector` qui collecte des 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 consigne 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 temporelles (par exemple, le temps de changement d'utilisateur) à partir de Logcat lors d'un ou de plusieurs tests répétés à l'aide de 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.
PerfettoPullerMetricCollector	Implémentation de base de `FilePullerDeviceMetricCollector` qui permet d'extraire les fichiers perfetto de l'appareil et d'en collecter les métriques.
RebootReasonCollector	Collecteur qui collecte les redémarrages de l'appareil pendant l'exécution du test et les signale par raison et nombre.
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.
ScreenshotOnFailureCollector	Collecteur qui capture et consigne une capture d'écran lorsqu'un cas de test échoue.
ShowmapPullerMetricCollector	Implémentation de base de `FilePullerDeviceMetricCollector` qui permet d'extraire les fichiers de la carte de présentation de l'appareil et d'en collecter les métriques.
TraceCmdCollector	Un `IMetricCollector` qui collecte des traces pendant le test à l'aide de trace-cmd et les consigne dans l'appel.

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 est applicable à la capture au niveau du module et s'il doit être initialisé.
`abstract`	`getBuildInfos()` Affiche la liste des informations de compilation disponibles dans l'appel.
`abstract`	`getDevices()` Affiche la liste des appareils disponibles dans l'appel.
`abstract ITestInvocationListener`	`getInvocationListener()` Renvoie l'`ITestInvocationListener` d'origine vers laquelle nous transférons les résultats.
`abstract ITestInvocationListener`	`init(IInvocationContext context, ITestInvocationListener listener)` Initialisation du collecteur avec le contexte actuel et l'emplacement où transmettre les résultats.
`abstract void`	`onTestAssumptionFailure(DeviceMetricData testData, TestDescription test)` Appel de rappel en cas d'échec d'un cas de test en raison d'une hypothèse incorrecte.
`abstract void`	`onTestEnd(DeviceMetricData testData, currentTestCaseMetrics, TestDescription test)` Rappel lorsque le cas de test est terminé.
`abstract void`	`onTestEnd(DeviceMetricData testData, currentTestCaseMetrics)` Rappel lorsque le cas de test est terminé.
`abstract void`	`onTestFail(DeviceMetricData testData, TestDescription test)` Appel de rappel en cas d'échec d'un scénario de test.
`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 lorsque l'exécution d'un test est terminée.
`abstract void`	`onTestRunStart(DeviceMetricData runData)` Rappel lorsque l'exécution d'un test est lancée.
`default void`	`onTestRunStart(DeviceMetricData runData, int testCount)` Rappel lorsque l'exécution d'un test est lancée.
`abstract void`	`onTestStart(DeviceMetricData testData)` Rappel lorsque le cas de test est lancé.

Méthodes publiques

captureModuleLevel

public boolean captureModuleLevel ()

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

Renvoie
`boolean`

getBuildInfos

public abstract  getBuildInfos ()

Affiche la liste des informations de compilation disponibles dans l'appel.

Renvoie

getDevices

public abstract  getDevices ()

Affiche la liste des appareils disponibles dans l'appel.

Renvoie

getInvocationListener

public abstract ITestInvocationListener getInvocationListener ()

Renvoie l'ITestInvocationListener d'origine vers laquelle 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ù transmettre les résultats. Ne sera appelé qu'une seule fois par instance, et le collecteur doit mettre à jour son contexte et son écouteur internes. Init n'est jamais appelé lors d'une exécution de test, toujours avant.

Ne remplacez pas ce paramètre que si vous savez ce que vous faites.

Paramètres
`context`	`IInvocationContext`: `IInvocationContext` de l'appel 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)

Appel de rappel en cas d'échec d'un cas de test en raison d'une hypothèse incorrecte.

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

Génère
`DeviceNotAvailableException`

onTestEnd

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

Rappel lorsque le cas de test est terminé. C'est le moment de nettoyer.

Paramètres
`testData`	`DeviceMetricData`: `DeviceMetricData` contenant les données du cas de test. Il s'agit du 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 scénario de test en cours.

Génère
`DeviceNotAvailableException`

onTestEnd

public abstract void onTestEnd (DeviceMetricData testData, 
                 currentTestCaseMetrics)

Rappel lorsque le cas de test est terminé. C'est le moment de nettoyer.

Paramètres
`testData`	`DeviceMetricData`: `DeviceMetricData` contenant les données du cas de test. Il s'agit du 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)

Appel de rappel en cas d'échec d'un scénario de test.

Paramètres
`testData`	`DeviceMetricData`: `DeviceMetricData` contenant les données du cas de test.
`test`	`TestDescription`: `TestDescription` du scénario 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 lorsque l'exécution d'un test est terminée. C'est le moment de nettoyer.

Paramètres
`runData`	`DeviceMetricData`: `DeviceMetricData` contenant les données de l'exécution. Il s'agit du 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 lorsque l'exécution d'un test 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 lorsque l'exécution d'un test est lancée.

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

Génère
`DeviceNotAvailableException`

onTestStart

public abstract void onTestStart (DeviceMetricData testData)

Rappel lorsque le cas de test est lancé.

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

Génère
`DeviceNotAvailableException`