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

PerfettoFilePullerCollector

public class PerfettoFilePullerCollector
extends FilePullerDeviceMetricCollector

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

一种收集器，用于从设备拉取 Perfetto 轨迹文件，可选择性地压缩这些文件，并将其添加到测试日志中。

摘要

公共构造函数
`PerfettoFilePullerCollector()`

公共方法
`void`	`processMetricDirectory(String key, File metricDirectory, DeviceMetricData runData)` 该方法的实现应允许记录目录，解析该目录以获取要放入 `DeviceMetricData` 中的指标。
`void`	`processMetricFile(String key, File metricFile, DeviceMetricData data)` 获取从设备拉取的 Perfetto 轨迹文件（可以是原始文件，也可以是压缩文件），并将其添加到测试日志中。

受保护的方法
`File`	`retrieveFile(ITestDevice device, String remoteFilePath, int userId)` 从设备中指定路径拉取文件。

公共构造函数

PerfettoFilePullerCollector

public PerfettoFilePullerCollector ()

公共方法

processMetricDirectory

public void processMetricDirectory (String key, 
                File metricDirectory, 
                DeviceMetricData runData)

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

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

processMetricFile

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

获取从设备拉取的 Perfetto 轨迹文件（可以是原始文件，也可以是压缩文件），并将其添加到测试日志中。

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

受保护的方法

retrieveFile

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

从设备中的指定路径拉取文件。如果启用了压缩 perfetto 选项，则拉取 perfetto 文件的压缩内容。

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

返回
`File`	基于 mCompressPerfetto 选项是否已设置的压缩或解压缩版 perfetto 文件。

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