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

BaseDeviceMetricCollector

public class BaseDeviceMetricCollector
extends Object implements IMetricCollector

java.lang.Object
↳	com.android.tradefed.device.metric.BaseDeviceMetricCollector

Sous-classes directes connues

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

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

Sous-classes indirectes connues

FilePullerLogCollector

FilePullerLogCollector Enregistreur du fichier signalé côté appareil.

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

Résumé

Champs
`public static final String`	`TEST_CASE_EXCLUDE_GROUP_OPTION`
`public static final String`	`TEST_CASE_INCLUDE_GROUP_OPTION`

Constructeurs publics
`BaseDeviceMetricCollector()`

Méthodes publiques
`final`	`getBuildInfos()` Affiche la liste des informations de compilation disponibles dans l'appel.
`final`	`getDevices()` Affiche la liste des appareils disponibles dans l'appel.
`File`	`getFileFromTestArtifacts(String fileName)` Récupérez le fichier à partir des artefacts de test ou des artefacts de module, puis mettez-le en cache dans une carte pour les appels suivants.
`final ITestInvocationListener`	`getInvocationListener()` Renvoie l'`ITestInvocationListener` d'origine vers laquelle nous transférons les résultats.
`final`	`getRealDevices()` Renvoie tous les appareils autres que les bouchons de la liste `getDevices()`.
`String`	`getRunName()` Renvoie le nom de l'exécution de test `mRunName` qui déclenche le collecteur.
`ITestInvocationListener`	`init(IInvocationContext context, ITestInvocationListener listener)` Initialisation du collecteur avec le contexte actuel et l'emplacement où transmettre les résultats.
`final void`	`invocationEnded(long elapsedTime)`
`final void`	`invocationFailed(FailureDescription failure)`
`final void`	`invocationFailed(Throwable cause)`
`final void`	`invocationStarted(IInvocationContext context)` Écouteurs d'appel pour le transfert
`final boolean`	`isDisabled()` Renvoie la valeur "True" si l'objet entier est désactivé (ignorez la configuration et le démontage).
`final void`	`logAssociation(String dataName, LogFile logFile)` Ne pas utiliser dans l'implémentation du collecteur de métriques.
`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.
`void`	`onTestEnd(DeviceMetricData testData, currentTestCaseMetrics, TestDescription test)` Rappel lorsque le cas de test est terminé.
`void`	`onTestEnd(DeviceMetricData testData, currentTestCaseMetrics)` Rappel lorsque le cas de test est terminé.
`void`	`onTestFail(DeviceMetricData testData, TestDescription test)` Appel de rappel en cas d'échec d'un scénario de test.
`void`	`onTestRunEnd(DeviceMetricData runData, currentRunMetrics)` Rappel lorsque l'exécution d'un test est terminée.
`void`	`onTestRunFailed(DeviceMetricData testData, FailureDescription failure)`
`void`	`onTestRunStart(DeviceMetricData runData)` Rappel lorsque l'exécution d'un test est lancée.
`void`	`onTestStart(DeviceMetricData testData)` Rappel lorsque le cas de test est lancé.
`final void`	`setDisable(boolean isDisabled)` Définit si l'objet doit être désactivé.
`final void`	`setLogSaver(ILogSaver logSaver)` Ne pas utiliser dans l'implémentation du collecteur de métriques.
`final void`	`testAssumptionFailure(TestDescription test, String trace)`
`final void`	`testAssumptionFailure(TestDescription test, FailureDescription failure)`
`final void`	`testEnded(TestDescription test, long endTime, testMetrics)`
`final void`	`testEnded(TestDescription test, testMetrics)`
`final void`	`testFailed(TestDescription test, FailureDescription failure)`
`final void`	`testFailed(TestDescription test, String trace)`
`final void`	`testIgnored(TestDescription test)`
`final void`	`testLog(String dataName, LogDataType dataType, InputStreamSource dataStream)`
`final void`	`testLogSaved(String dataName, LogDataType dataType, InputStreamSource dataStream, LogFile logFile)` Ne pas utiliser dans l'implémentation du collecteur de métriques.
`final void`	`testModuleEnded()`
`final void`	`testModuleStarted(IInvocationContext moduleContext)`
`final void`	`testRunEnded(long elapsedTime, runMetrics)`
`final void`	`testRunFailed(FailureDescription failure)`
`final void`	`testRunFailed(String errorMessage)`
`final void`	`testRunStarted(String runName, int testCount, int attemptNumber)`
`final void`	`testRunStarted(String runName, int testCount)` Rappels d'exécution des tests
`final void`	`testRunStarted(String runName, int testCount, int attemptNumber, long startTime)`
`final void`	`testRunStopped(long elapsedTime)`
`final void`	`testStarted(TestDescription test, long startTime)`
`final void`	`testStarted(TestDescription test)` Rappels des scénarios de test

Champs

TEST_CASE_EXCLUDE_GROUP_OPTION

public static final String TEST_CASE_EXCLUDE_GROUP_OPTION

TEST_CASE_INCLUDE_GROUP_OPTION

public static final String TEST_CASE_INCLUDE_GROUP_OPTION

Constructeurs publics

BaseDeviceMetricCollector

public BaseDeviceMetricCollector ()

Méthodes publiques

getBuildInfos

public final  getBuildInfos ()

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

Renvoie

getDevices

public final  getDevices ()

Affiche la liste des appareils disponibles dans l'appel.

Renvoie

getFileFromTestArtifacts

public File getFileFromTestArtifacts (String fileName)

Récupérez le fichier à partir des artefacts de test ou des artefacts de module, puis mettez-le en cache dans une carte pour les appels suivants.

Paramètres
`fileName`	`String`: nom du fichier à rechercher dans les artefacts.

Renvoie
`File`	Fichier de l'artefact de test ou de l'artefact de module. Renvoie la valeur "null" si le fichier est introuvable.

getInvocationListener

public final ITestInvocationListener getInvocationListener ()

Renvoie l'ITestInvocationListener d'origine vers laquelle nous transférons les résultats.

Renvoie
`ITestInvocationListener`

getRealDevices

public final  getRealDevices ()

Renvoie tous les appareils autres que les bouchons de la liste getDevices().

Renvoie

getRunName

public String getRunName ()

Renvoie le nom de l'exécution de test mRunName qui déclenche le collecteur.

Renvoie
`String`	mRunName, nom de l'exécution de test actuelle.

init

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

invocationEnded

public final void invocationEnded (long elapsedTime)

Paramètres
`elapsedTime`	`long`

invocationFailed

public final void invocationFailed (FailureDescription failure)

Paramètres
`failure`	`FailureDescription`

invocationFailed

public final void invocationFailed (Throwable cause)

Paramètres
`cause`	`Throwable`

invocationStarted

public final void invocationStarted (IInvocationContext context)

Écouteurs d'appel pour le transfert

Paramètres
`context`	`IInvocationContext`

isDisabled

public final boolean isDisabled ()

Renvoie la valeur "True" si l'objet entier est désactivé (ignorez la configuration et le démontage). Sinon, cette valeur est "false".

Renvoie
`boolean`

logAssociation

public final void logAssociation (String dataName, 
                LogFile logFile)

Ne pas utiliser dans l'implémentation du collecteur de métriques. Il s'agit d'un transfert pur.

Paramètres
`dataName`	`String`
`logFile`	`LogFile`

onTestAssumptionFailure

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

onTestEnd

public 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)`.

onTestFail

public 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 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)`.

onTestRunFailed

public void onTestRunFailed (DeviceMetricData testData, 
                FailureDescription failure)

Paramètres
`testData`	`DeviceMetricData`
`failure`	`FailureDescription`

onTestRunStart

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

setDisable

public final void setDisable (boolean isDisabled)

Définit si l'objet doit être désactivé. "Désactivé" signifie que les étapes de configuration et de démontage doivent être ignorées. Peut être utilisé pour désactiver un objet par défaut dans le constructeur par défaut.

Paramètres
`isDisabled`	`boolean`: état dans lequel l'objet doit être placé.

setLogSaver

public final void setLogSaver (ILogSaver logSaver)

Ne pas utiliser dans l'implémentation du collecteur de métriques. Il s'agit d'un transfert pur.

Paramètres
`logSaver`	`ILogSaver`

testAssumptionFailure

public final void testAssumptionFailure (TestDescription test, 
                String trace)

Paramètres
`test`	`TestDescription`
`trace`	`String`

testAssumptionFailure

public final void testAssumptionFailure (TestDescription test, 
                FailureDescription failure)

Paramètres
`test`	`TestDescription`
`failure`	`FailureDescription`

testEnded

public final void testEnded (TestDescription test, 
                long endTime, 
                 testMetrics)

Paramètres
`test`	`TestDescription`
`endTime`	`long`
`testMetrics`

testEnded

public final void testEnded (TestDescription test, 
                 testMetrics)

Paramètres
`test`	`TestDescription`
`testMetrics`

testFailed

public final void testFailed (TestDescription test, 
                FailureDescription failure)

Paramètres
`test`	`TestDescription`
`failure`	`FailureDescription`

testFailed

public final void testFailed (TestDescription test, 
                String trace)

Paramètres
`test`	`TestDescription`
`trace`	`String`

testIgnored

public final void testIgnored (TestDescription test)

Paramètres
`test`	`TestDescription`

testLog

public final void testLog (String dataName, 
                LogDataType dataType, 
                InputStreamSource dataStream)

Paramètres
`dataName`	`String`
`dataType`	`LogDataType`
`dataStream`	`InputStreamSource`

testLogSaved

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

Ne pas utiliser dans l'implémentation du collecteur de métriques. Il s'agit d'un transfert pur.

Paramètres
`dataName`	`String`
`dataType`	`LogDataType`
`dataStream`	`InputStreamSource`
`logFile`	`LogFile`

testModuleEnded

public final void testModuleEnded ()

testModuleStarted

public final void testModuleStarted (IInvocationContext moduleContext)

Paramètres
`moduleContext`	`IInvocationContext`

testRunEnded

public final void testRunEnded (long elapsedTime, 
                 runMetrics)

Paramètres
`elapsedTime`	`long`
`runMetrics`

testRunFailed

public final void testRunFailed (FailureDescription failure)

Paramètres
`failure`	`FailureDescription`

testRunFailed

public final void testRunFailed (String errorMessage)

Paramètres
`errorMessage`	`String`

testRunStarted

public final void testRunStarted (String runName, 
                int testCount, 
                int attemptNumber)

Paramètres
`runName`	`String`
`testCount`	`int`
`attemptNumber`	`int`

testRunStarted

public final void testRunStarted (String runName, 
                int testCount)

Rappels d'exécution des tests

Paramètres
`runName`	`String`
`testCount`	`int`

testRunStarted

public final void testRunStarted (String runName, 
                int testCount, 
                int attemptNumber, 
                long startTime)

Paramètres
`runName`	`String`
`testCount`	`int`
`attemptNumber`	`int`
`startTime`	`long`

testRunStopped

public final void testRunStopped (long elapsedTime)

Paramètres
`elapsedTime`	`long`

testStarted

public final void testStarted (TestDescription test, 
                long startTime)

Paramètres
`test`	`TestDescription`
`startTime`	`long`

testStarted

public final void testStarted (TestDescription test)

Rappels des scénarios de test

Paramètres
`test`	`TestDescription`