自 2025 年 3 月 27 日起，我们建议您使用 android-latest-release 而非 aosp-main 构建 AOSP 并为其做出贡献。如需了解详情，请参阅 AOSP 的变更。

此页面由 Cloud Translation API 翻译。

FilePullerDeviceMetricCollector

public abstract class FilePullerDeviceMetricCollector
extends BaseDeviceMetricCollector

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

已知的直接子类

AtraceRunMetricCollector	从测试设备收集给定目录下的所有测试目录中的轨迹，记录测试目录，对测试目录下的轨迹文件进行后处理并汇总指标。
BluetoothHciSnoopLogCollector	用于在 DUT 上启用蓝牙 HCI 信息收集日志记录并收集每次测试的日志的收集器。
FilePullerLogCollector	设备端报告的文件的记录器。
PerfettoFilePullerCollector	一种收集器，用于从设备拉取 Perfetto 轨迹文件，可选择性地压缩这些文件，并将其添加到测试日志中。
PerfettoPullerMetricCollector	此类已弃用。请改用 `PerfettoFilePullerCollector` 和 `ERROR(/PerfettoTracePostProcessor)`。
ShowmapPullerMetricCollector	`FilePullerDeviceMetricCollector` 的基本实现，允许从设备拉取 showmap 文件并从中收集指标。

一个 BaseDeviceMetricCollector，用于监听来自设备的指标密钥，并以文件形式从设备中提取这些密钥。可延长，以便对文件进行额外处理。

摘要

字段
`protected`	`mDirectoryKeys`
`public`	`mTestCaseMetrics`

公共构造函数
`FilePullerDeviceMetricCollector()`

公共方法
`void`	`onTestEnd(DeviceMetricData testData, currentTestCaseMetrics)` 测试用例结束时的回调。
`void`	`onTestRunEnd(DeviceMetricData runData, currentRunMetrics)` 测试运行结束时的回调。
`abstract void`	`processMetricDirectory(String key, File metricDirectory, DeviceMetricData data)` 该方法的实现应允许记录目录，解析该目录以获取要放入 `DeviceMetricData` 中的指标。
`abstract void`	`processMetricFile(String key, File metricFile, DeviceMetricData data)` 该方法的实现应允许记录文件，解析文件以获取要放入 `DeviceMetricData` 中的指标。

受保护的方法
`void`	`addKeys(String... keys)` 向从设备拉取的模式添加了额外的模式键。
`File`	`retrieveFile(ITestDevice device, String remoteFilePath, int userId)` 从设备中指定路径拉取文件。

protected  mDirectoryKeys

public  mTestCaseMetrics

public FilePullerDeviceMetricCollector ()

public void onTestEnd (DeviceMetricData testData, 
                 currentTestCaseMetrics)

测试用例结束时的回调。现在应该进行清理。

参数
`testData`	`DeviceMetricData`：用于保存测试用例数据的 `DeviceMetricData`。将与 `BaseDeviceMetricCollector.onTestStart(com.android.tradefed.device.metric.DeviceMetricData)` 期间的对象相同。
`currentTestCaseMetrics`	：传递给 `ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map))` 的当前指标映射。

抛出
`DeviceNotAvailableException`

public void onTestRunEnd (DeviceMetricData runData, 
                 currentRunMetrics)

测试运行结束时的回调。现在应该进行清理。

参数
`runData`	`DeviceMetricData`：用于保存运行数据的 `DeviceMetricData`。与 `BaseDeviceMetricCollector.onTestRunStart(com.android.tradefed.device.metric.DeviceMetricData)` 期间的对象相同。
`currentRunMetrics`	：传递给 `ERROR(/#testRunEnded(long,Map))` 的当前指标映射。

抛出
`DeviceNotAvailableException`

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

该方法的实现应允许记录目录，并解析该目录以获取要放入 DeviceMetricData 中的指标。

参数
`key`	`String`：与所拉取的目录关联的选项键。
`metricDirectory`	`File`：从与选项键匹配的设备拉取的 `ERROR(/File)`。
`data`	`DeviceMetricData`：可用于存储指标的 `DeviceMetricData`。

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

该方法的实现应允许记录文件，解析文件以获取要放入 DeviceMetricData 中的指标。

参数
`key`	`String`：与所拉取的文件关联的选项键。
`metricFile`	`File`：从与选项键匹配的设备拉取的 `ERROR(/File)`。
`data`	`DeviceMetricData`：可用于存储指标的 `DeviceMetricData`。

protected void addKeys (String... keys)

向从设备拉取的模式添加了额外的模式键。

参数
`keys`	`String`

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

从设备中的指定路径拉取文件。

返回
`File`	从设备中的指定路径检索到的文件。

抛出
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`