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

FilePullerDeviceMetricCollector

public abstract class FilePullerDeviceMetricCollector
extends BaseDeviceMetricCollector

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

Sous-classes directes connues

AtraceRunMetricCollector, BluetoothHciSnoopLogCollector, FilePullerLogCollector, PerfettoFilePullerCollector, PerfettoPullerMetricCollector, ShowmapPullerMetricCollector

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.
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.
FilePullerLogCollector	Journaliseur du fichier signalé par le côté de l'appareil.
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)`.
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.

Un BaseDeviceMetricCollector qui écoute la clé de métriques provenant de l'appareil et les extrait sous forme de fichier depuis l'appareil. Peut être étendu pour le traitement supplémentaire du fichier.

Résumé

Champs
`protected`	`mDirectoryKeys`
`public`	`mTestCaseMetrics`

Constructeurs publics
`FilePullerDeviceMetricCollector()`

Méthodes publiques
`void`	`onTestEnd(DeviceMetricData testData, currentTestCaseMetrics)` Rappel lorsqu'un cas de test est terminé.
`void`	`onTestRunEnd(DeviceMetricData runData, currentRunMetrics)` Rappel lorsqu'une série de tests est terminée.
`abstract void`	`processMetricDirectory(String key, File metricDirectory, DeviceMetricData data)` L'implémentation de la méthode doit permettre de consigner le répertoire et de l'analyser pour que les métriques soient placées dans `DeviceMetricData`.
`abstract void`	`processMetricFile(String key, File metricFile, DeviceMetricData data)` L'implémentation de la méthode doit permettre de consigner le fichier, de l'analyser pour que les métriques soient placées dans `DeviceMetricData`.

Méthodes protégées
`void`	`addKeys(String... keys)` Ajoute des clés de modèle supplémentaires à l'extraction depuis l'appareil.
`File`	`retrieveFile(ITestDevice device, String remoteFilePath, int userId)` Extrayez le fichier du chemin d'accès spécifié sur l'appareil.

Champs

mDirectoryKeys

protected  mDirectoryKeys

mTestCaseMetrics

public  mTestCaseMetrics

Constructeurs publics

FilePullerDeviceMetricCollector

public FilePullerDeviceMetricCollector ()

Méthodes publiques

onTestEnd

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

onTestRunEnd

public 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 `BaseDeviceMetricCollector.onTestRunStart(com.android.tradefed.device.metric.DeviceMetricData)`.
`currentRunMetrics`	: carte actuelle des métriques transmises à `ERROR(/#testRunEnded(long,Map))`.

Génère
`DeviceNotAvailableException`

processMetricDirectory

public abstract void processMetricDirectory (String key, 
                File metricDirectory, 
                DeviceMetricData data)

L'implémentation de la méthode doit permettre de consigner le répertoire et de l'analyser pour que les métriques soient placées dans DeviceMetricData.

Paramètres
`key`	`String` : clé d'option associée au répertoire extrait.
`metricDirectory`	`File` : `ERROR(/File)` extrait de l'appareil correspondant à la clé d'option.
`data`	`DeviceMetricData` : `DeviceMetricData` où les métriques peuvent être stockées.

processMetricFile

public abstract void processMetricFile (String key, 
                File metricFile, 
                DeviceMetricData data)

L'implémentation de la méthode doit permettre de consigner le fichier et de l'analyser pour que les métriques soient placées dans DeviceMetricData.

Paramètres
`key`	`String` : clé d'option associée au fichier extrait.
`metricFile`	`File` : `ERROR(/File)` extrait de l'appareil correspondant à la clé d'option.
`data`	`DeviceMetricData` : `DeviceMetricData` où les métriques peuvent être stockées.

Méthodes protégées

addKeys

protected void addKeys (String... keys)

Ajoute des clés de modèle supplémentaires à l'extraction depuis l'appareil.

Paramètres
`keys`	`String`

retrieveFile

protected File retrieveFile (ITestDevice device, 
                String remoteFilePath, 
                int userId)

Extrayez le fichier du chemin d'accès spécifié sur l'appareil.

Paramètres
`device`	`ITestDevice` : qui possède le fichier.
`remoteFilePath`	`String` : emplacement dans l'appareil.
`userId`	`int` : ID utilisateur à partir duquel extraire les données

Renvoie
`File`	Fichier récupéré à partir du chemin d'accès indiqué sur l'appareil.

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