Ab 2026 werden wir den Quellcode im 2. und 4. Quartal in AOSP veröffentlichen, um unser trunk-stable-Entwicklungsmodell zu unterstützen und die Plattformstabilität für das Ökosystem zu gewährleisten. Für die Entwicklung und das Beitragen zu AOSP empfehlen wir die Verwendung von android-latest-release anstelle von aosp-main. Der Manifestzweig android-latest-release verweist immer auf das neueste Release, das an AOSP übertragen wurde. Weitere Informationen finden Sie unter Änderungen an AOSP.

FilePullerDeviceMetricCollector

public abstract class FilePullerDeviceMetricCollector
extends BaseDeviceMetricCollector

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

Bekannte direkte Unterklassen

AtraceRunMetricCollector, BluetoothHciSnoopLogCollector, FilePullerLogCollector, PerfettoFilePullerCollector, PerfettoPullerMetricCollector, ShowmapPullerMetricCollector

AtraceRunMetricCollector	Sammelt die Traces aus allen Testverzeichnissen unter dem angegebenen Verzeichnis vom Testgerät, protokolliert das Testverzeichnis und verarbeitet die Trace-Dateien im Testverzeichnis nach und aggregiert die Messwerte.
BluetoothHciSnoopLogCollector	Collector zum Aktivieren der Bluetooth HCI-Snoop-Protokollierung auf dem DUT und zum Erfassen des Protokolls für jeden Test.
FilePullerLogCollector	Logger der vom Gerät gemeldeten Datei.
PerfettoFilePullerCollector	Ein Collector, der Perfetto-Tracedateien vom Gerät abruft, sie optional komprimiert und den Testlogs hinzufügt.
PerfettoPullerMetricCollector	Diese Klasse wurde eingestellt. Verwenden Sie stattdessen `PerfettoFilePullerCollector` und `ERROR(/PerfettoTracePostProcessor)`.
ShowmapPullerMetricCollector	Basisimplementierung von `FilePullerDeviceMetricCollector`, mit der die Showmap-Dateien vom Gerät abgerufen und die Messwerte daraus erfasst werden können.

Ein BaseDeviceMetricCollector, das auf den Messwertschlüssel vom Gerät wartet und ihn als Datei vom Gerät abruft. Kann für die zusätzliche Verarbeitung der Datei erweitert werden.

Zusammenfassung

Felder
`protected`	`mDirectoryKeys`
`public`	`mTestCaseMetrics`

Öffentliche Konstruktoren
`FilePullerDeviceMetricCollector()`

Öffentliche Methoden
`void`	`onTestEnd(DeviceMetricData testData, currentTestCaseMetrics)` Callback, wenn ein Testlauf beendet wird.
`void`	`onTestRunEnd(DeviceMetricData runData, currentRunMetrics)` Callback, wenn ein Testlauf beendet wird.
`abstract void`	`processMetricDirectory(String key, File metricDirectory, DeviceMetricData data)` Bei der Implementierung der Methode sollte das Verzeichnis protokolliert und nach Messwerten durchsucht werden, die in `DeviceMetricData` eingefügt werden sollen.
`abstract void`	`processMetricFile(String key, File metricFile, DeviceMetricData data)` Bei der Implementierung der Methode sollte die Datei protokolliert und nach Messwerten durchsucht werden, die in `DeviceMetricData` eingefügt werden.

Geschützte Methoden
`void`	`addKeys(String... keys)` Fügt dem Pull vom Gerät zusätzliche Musterschlüssel hinzu.
`File`	`retrieveFile(ITestDevice device, String remoteFilePath, int userId)` Rufen Sie die Datei über den angegebenen Pfad auf dem Gerät ab.

Felder

mDirectoryKeys

protected  mDirectoryKeys

mTestCaseMetrics

public  mTestCaseMetrics

Öffentliche Konstruktoren

FilePullerDeviceMetricCollector

public FilePullerDeviceMetricCollector ()

Öffentliche Methoden

onTestEnd

public void onTestEnd (DeviceMetricData testData, 
                 currentTestCaseMetrics)

Callback, wenn ein Testlauf beendet wird. Jetzt ist es an der Zeit, aufzuräumen.

Parameter
`testData`	`DeviceMetricData`: Der `DeviceMetricData`, der die Daten für den Testlauf enthält. Ist dasselbe Objekt wie während `BaseDeviceMetricCollector.onTestStart(com.android.tradefed.device.metric.DeviceMetricData)`.
`currentTestCaseMetrics`	: Die aktuelle Zuordnung von Messwerten, die an `ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map))` übergeben werden.

Ausgabe
`DeviceNotAvailableException`

onTestRunEnd

public void onTestRunEnd (DeviceMetricData runData, 
                 currentRunMetrics)

Callback, wenn ein Testlauf beendet wird. Jetzt ist es an der Zeit, aufzuräumen.

Parameter
`runData`	`DeviceMetricData`: Der `DeviceMetricData` mit den Daten für den Lauf. Ist dasselbe Objekt wie während `BaseDeviceMetricCollector.onTestRunStart(com.android.tradefed.device.metric.DeviceMetricData)`.
`currentRunMetrics`	: Die aktuelle Zuordnung von Messwerten, die an `ERROR(/#testRunEnded(long,Map))` übergeben werden.

Ausgabe
`DeviceNotAvailableException`

processMetricDirectory

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

Bei der Implementierung der Methode sollte das Verzeichnis protokolliert und nach Messwerten durchsucht werden, die in DeviceMetricData eingefügt werden sollen.

Parameter
`key`	`String`: Der Optionsschlüssel, der dem abgerufenen Verzeichnis zugeordnet ist.
`metricDirectory`	`File`: Die `ERROR(/File)`, die vom Gerät abgerufen wird, das dem Optionsschlüssel entspricht.
`data`	`DeviceMetricData`: Das `DeviceMetricData`, in dem Messwerte gespeichert werden können.

processMetricFile

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

Bei der Implementierung der Methode sollte die Datei protokolliert und nach Messwerten durchsucht werden, die in DeviceMetricData eingefügt werden.

Parameter
`key`	`String`: Der Optionsschlüssel, der der abgerufenen Datei zugeordnet ist.
`metricFile`	`File`: Die `ERROR(/File)`, die vom Gerät abgerufen wird, das dem Optionsschlüssel entspricht.
`data`	`DeviceMetricData`: Der `DeviceMetricData`, in dem Messwerte gespeichert werden können.

Geschützte Methoden

addKeys

protected void addKeys (String... keys)

Fügt dem Pull vom Gerät zusätzliche Musterschlüssel hinzu.

Parameter
`keys`	`String`

retrieveFile

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

Rufen Sie die Datei über den angegebenen Pfad auf dem Gerät ab.

Parameter
`device`	`ITestDevice`: Das Gerät, auf dem sich die Datei befindet.
`remoteFilePath`	`String`: Speicherort auf dem Gerät.
`userId`	`int`: die Nutzer-ID, aus der die Daten abgerufen werden sollen

Returns
`File`	Die Datei wurde vom angegebenen Pfad auf dem Gerät abgerufen.

Ausgabe
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`