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

IMetricCollector

public interface IMetricCollector
implements ILogSaverListener , IDisableable

com.android.tradefed.device.metric.IMetricCollector

Sous-classes indirectes connues

AtraceCollector , AtraceRunMetricCollector , BaseDeviceMetricCollector , BluetoothConnectionLatencyCollector , BluetoothConnectionStateCollector , BluetoothHciSnoopLogCollector , BugreportzOnFailureCollector , BugreportzOnTestCaseFailureCollector , ClangCodeCoverageCollector , CountTestCasesCollector , DebugHostLogOnFailureCollector , DeviceTraceCollector , FilePullerDeviceMetricCollector , FilePullerLogCollector , GcovCodeCoverageCollector , and 12 others.

AtraceCollector	Un `IMetricCollector` qui exécute atrace pendant un test et collecte le résultat et le consigne dans l'invocation.
AtraceRunMetricCollectorAtraceRunMetricCollector	Collecte les traces de tous les répertoires 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 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 connexion pour chaque profil.
BluetoothHciSnoopLogCollector	Collecteur pour activer la journalisation de surveillance Bluetooth HCI sur le DUT et pour collecter le journal pour chaque test.
Rapport de bugzOnFailureCollector	Collectez un rapport de boguez lorsqu'un scénario de test échoue.
Rapport de boguezOnTestCaseFailureCollector	Collectez un rapport de boguez lorsqu'un cas de test dans une exécution échoue.
ClangCodeCoverageCollector	Un `BaseDeviceMetricCollector` qui extrait les mesures de couverture Clang de l'appareil et les enregistre en tant qu'artefacts de test.
CountTestCasesCollector	Comptez et signalez le nombre de cas de test pour un `IRemoteTest` donné.
DebugHostLogOnFailureCollector	Collecteur qui rassemblera et consignera les journaux côté hôte en cas d'échec d'un scénario de test.
DeviceTraceCollector	Collecteur qui démarrera la trace perfetto au démarrage d'une exécution de test et consignera le fichier de trace à la fin.
FilePullerDeviceMetricCollector	Un `BaseDeviceMetricCollector` qui écoute la clé de mesures provenant de l'appareil et les extrait sous forme de fichier à partir de l'appareil.
FilePullerLogCollector	Enregistreur du fichier signalé par le côté 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 des débogages et de l'appareil, puis les enregistre finalement en tant qu'artefacts de test.
HostStatsdMetricCollectorHostStatsdMetricCollector	Un `IMetricCollector` qui collecte les métriques statsd du 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 enregistre 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 commutation de l'utilisateur) à partir de logcat pendant un ou plusieurs tests répétés en utilisant des modèles regex donnés pour analyser les signaux de début et de fin d'un événement à partir de 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 le redémarrage de l'appareil pendant l'exécution du test et les signale par raison et nombre.
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'écranOnFailureCollector	Collecteur qui capture et enregistre une capture d'écran lorsqu'un cas de test échoue.
AffichercartePullerMetricCollector	Implémentation de base de `FilePullerDeviceMetricCollector` qui permet d'extraire les fichiers showmap de l'appareil et d'en collecter les métriques.
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 du rapport des résultats des tests afin de collecter les métriques correspondantes.

Cette interface ne peut pas être utilisée comme même il étend ITestInvocationListener . La vérification de la configuration le rejettera. 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 ou non à la capture au niveau du module et doit être init.
`abstract`	`getBuildInfos ()` Renvoie la liste des informations de construction disponibles dans l'invocation.
`abstract`	`getDevices ()` Renvoie la liste des périphériques disponibles dans l'invocation.
`abstract ITestInvocationListener`	`getInvocationListener ()` Renvoie le `ITestInvocationListener` d'origine où nous transférons les résultats.
`abstract ITestInvocationListener`	`init ( IInvocationContext context, ITestInvocationListener listener)` Initialisation du collecteur avec le contexte actuel et où transférer les résultats.
`abstract void`	`onTestAssumptionFailure ( DeviceMetricData testData, TestDescription test)` Rappel lorsqu'un cas de test échoue avec un échec d'hypothèse.
`abstract void`	`onTestEnd ( DeviceMetricData testData, currentTestCaseMetrics, TestDescription test)` `onTestEnd ( DeviceMetricData testData, currentTestCaseMetrics, TestDescription test)` Rappel lorsqu'un scénario de test est terminé.
`abstract void`	`onTestEnd ( DeviceMetricData testData, currentTestCaseMetrics)` `onTestEnd ( DeviceMetricData testData, currentTestCaseMetrics)` Rappel lorsqu'un scénario de test est terminé.
`abstract void`	`onTestFail ( DeviceMetricData testData, TestDescription test)` Rappel lorsqu'un scénario de test échoue.
`default void`	`onTestModuleEnded ()` Permet de capturer l'événement de fin de module.
`default void`	`onTestModuleStarted ()` Permet de capturer l'événement de démarrage du module.
`abstract void`	`onTestRunEnd ( DeviceMetricData runData, currentRunMetrics)` `onTestRunEnd ( DeviceMetricData runData, currentRunMetrics)` Rappel lorsqu'un test est terminé.
`abstract void`	`onTestRunStart ( DeviceMetricData runData)` Rappel lorsqu'une exécution de test est lancée.
`default void`	`onTestRunStart ( DeviceMetricData runData, int testCount)` Rappel lorsqu'une exécution de test est lancée.
`abstract void`	`onTestStart ( DeviceMetricData testData)` Rappel lorsqu'un scénario de test est lancé.

Méthodes publiques

captureModuleLevelcaptureModuleLevel

public boolean captureModuleLevel ()

Indique si le collecteur est applicable ou non à la capture au niveau du module et doit être init.

Retour
`boolean`

getBuildInfos

public abstract  getBuildInfos ()

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

Retour

getDevices

public abstract  getDevices ()

Renvoie la liste des périphériques disponibles dans l'invocation.

Retour

getInvocationListener

public abstract ITestInvocationListener getInvocationListener ()

Renvoie le ITestInvocationListener d'origine où nous transférons les résultats.

Retour
`ITestInvocationListener`

initialiser

public abstract ITestInvocationListener init (IInvocationContext context, 
                ITestInvocationListener listener)

Initialisation du collecteur avec le contexte actuel et où transférer les résultats. Ne sera appelé qu'une seule fois par instance, et le collecteur doit mettre à jour son contexte interne et son écouteur. Init ne sera jamais appelé lors d'une exécution de test toujours avant.

N'annulez pas à moins que vous ne sachiez ce que vous faites.

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

Retour
`ITestInvocationListener`	le nouvel écouteur enveloppant celui d'origine.

Lance
`DeviceNotAvailableException`

onTestAssumptionFailure

public abstract void onTestAssumptionFailure (DeviceMetricData testData, 
                TestDescription test)

Rappel lorsqu'un cas de test échoue avec un échec d'hypothèse.

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

Lance
`DeviceNotAvailableException`

onTestEnd

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

Rappel lorsqu'un scénario de test est terminé. Ce devrait être le moment du nettoyage.

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

Lance
`DeviceNotAvailableException`

onTestEnd

public abstract void onTestEnd (DeviceMetricData testData, 
                 currentTestCaseMetrics)

Rappel lorsqu'un scénario de test est terminé. Ce devrait être le moment du nettoyage.

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

Lance
`DeviceNotAvailableException`

onTestFail

public abstract void onTestFail (DeviceMetricData testData, 
                TestDescription test)

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

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

Lance
`DeviceNotAvailableException`

onTestModuleEnded

public void onTestModuleEnded ()

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

Lance
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

onTestModuleStarted

public void onTestModuleStarted ()

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

Lance
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

onTestRunEnd

public abstract void onTestRunEnd (DeviceMetricData runData, 
                 currentRunMetrics)

Rappel lorsqu'un test est terminé. Ce devrait être le moment du nettoyage.

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

Lance
`DeviceNotAvailableException`

onTestRunStart

public abstract void onTestRunStart (DeviceMetricData runData)

Rappel lorsqu'une exécution de test est lancée.

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

Lance
`DeviceNotAvailableException`

onTestRunStart

public void onTestRunStart (DeviceMetricData runData, 
                int testCount)

Rappel lorsqu'une exécution de test est lancée.

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

Lance
`DeviceNotAvailableException`

onTestStart

public abstract void onTestStart (DeviceMetricData testData)

Rappel lorsqu'un scénario de test est démarré.

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

Lance
`DeviceNotAvailableException`