為配合主幹穩定開發模型，並確保生態系統的平台穩定性，我們將於 2026 年起，在第 2 季和第 4 季將原始碼發布至 AOSP。如要建構及貢獻 AOSP，建議使用 android-latest-release，而非 aosp-main。android-latest-release 資訊清單分支版本一律會參照推送至 AOSP 的最新版本。詳情請參閱「Android 開放原始碼計畫變更」一文。

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`