自 2026 年起，为了与我们的主干稳定开发模型保持一致，并确保生态系统的平台稳定性，我们将在第 2 季度和第 4 季度向 AOSP 发布源代码。如需构建 AOSP 并为其贡献代码，请使用 android-latest-release。android-latest-release 清单分支将始终引用推送到 AOSP 的最新版本。如需了解详情，请参阅 AOSP 变更。

Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

FilePullerDeviceMetricCollector

public abstract class FilePullerDeviceMetricCollector
extends BaseDeviceMetricCollector

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

已知的直接子类

AtraceRunMetricCollector、BluetoothHciSnoopLogCollector、FilePullerLogCollector、PerfettoFilePullerCollector、PerfettoPullerMetricCollector、ShowmapPullerMetricCollector

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

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

摘要

字段
`protected Set<String>`	`mDirectoryKeys`
`public Map<String, String>`	`mTestCaseMetrics`

公共构造函数
`FilePullerDeviceMetricCollector()`

公共方法
`void`	`onTestEnd(DeviceMetricData testData, Map<String, MetricMeasurement.Metric> currentTestCaseMetrics)` 测试用例结束时的回调。
`void`	`onTestRunEnd(DeviceMetricData runData, Map<String, MetricMeasurement.Metric> 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)` 从设备中的指定路径拉取文件。

字段

mDirectoryKeys

protected Set<String> mDirectoryKeys

mTestCaseMetrics

public Map<String, String> mTestCaseMetrics

公共构造函数

FilePullerDeviceMetricCollector

public FilePullerDeviceMetricCollector ()

公共方法

onTestEnd

public void onTestEnd (DeviceMetricData testData, 
                Map<String, MetricMeasurement.Metric> currentTestCaseMetrics)

测试用例结束时的回调。此时应执行清理操作。

参数
`testData`	`DeviceMetricData`：用于保存测试用例数据的 `DeviceMetricData`。将与 `onTestStart(DeviceMetricData)` 期间的对象相同。
`currentTestCaseMetrics`	`Map`：传递给 `testEnded(TestDescription,Map)` 的当前指标映射。

抛出
`DeviceNotAvailableException`

onTestRunEnd

public void onTestRunEnd (DeviceMetricData runData, 
                Map<String, MetricMeasurement.Metric> currentRunMetrics)

测试运行结束时的回调。此时应执行清理操作。

参数
`runData`	`DeviceMetricData`：用于保存运行数据的 `DeviceMetricData`。将与 `onTestRunStart(DeviceMetricData)` 期间的对象相同。
`currentRunMetrics`	`Map`：传递给 `testRunEnded(long,Map)` 的当前指标映射。

抛出
`DeviceNotAvailableException`

processMetricDirectory

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

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

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

processMetricFile

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

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

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

受保护的方法

addKeys

protected void addKeys (String... keys)

向从设备拉取的图案添加了其他图案键。

参数
`keys`	`String`

retrieveFile

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

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

参数
`device`	`ITestDevice`：包含相应文件。
`remoteFilePath`	`String`：设备中的位置。
`userId`	`int`：要从中提取的用户 ID

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

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