À 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 ILogSaverListener, IDisableable

com.android.tradefed.device.metric.IMetricCollector

Sous-classes indirectes connues

BaseDeviceMetricCollector, BugreportzOnFailureCollector, ClangCodeCoverageCollector, CountTestCasesCollector, DebugHostLogOnFailureCollector, FilePullerDeviceMetricCollector, FilePullerLogCollector, GcovCodeCoverageCollector, JavaCodeCoverageCollector, LogcatOnFailureCollector, ScreenshotOnFailureCollector

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))`.
BugreportzOnFailureCollector	Collectez un bugreportz lorsqu'un scénario de test échoue.
ClangCodeCoverageCollector	Un `BaseDeviceMetricCollector` qui extrait les mesures de couverture Clang de l'appareil et les consigne en tant qu'artefacts de test.
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.
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.
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.
ScreenshotOnFailureCollector	Collecteur qui capture et consigne une capture d'écran lorsqu'un cas de test échoue.

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
`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 scénario de test en raison d'une hypothèse incorrecte.
`abstract void`	`onTestEnd(DeviceMetricData testData, currentTestCaseMetrics)` Rappel lorsque le cas de test est terminé.
`abstract void`	`onTestEnd(DeviceMetricData testData, currentTestCaseMetrics, TestDescription test)` 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.
`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.
`abstract void`	`onTestStart(DeviceMetricData testData)` Rappel lorsque le cas de test est lancé.

Méthodes publiques

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.

onTestAssumptionFailure

public abstract void onTestAssumptionFailure (DeviceMetricData testData, 
                TestDescription test)

Appel de rappel en cas d'échec d'un scénario 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.

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 à `ITestLifeCycleReceiver.testEnded(com.android.tradefed.result.TestDescription, Map)`.

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 à `ITestLifeCycleReceiver.testEnded(com.android.tradefed.result.TestDescription, Map)`.
`test`	`TestDescription`: `TestDescription` du scénario de test en cours.

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.

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 à `ITestLifeCycleReceiver.testRunEnded(long, Map)`.

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.

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.