自 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	设备端报告的文件的记录器。
PerfettoPullerMetricCollector	`FilePullerDeviceMetricCollector` 的基础实现，允许从设备中提取 Perfetto 文件并从中收集指标。
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`