自 2025 年 3 月 27 日起，我們建議您使用 android-latest-release 而非 aosp-main 建構及貢獻 AOSP。詳情請參閱「Android 開放原始碼計畫變更」。

本頁面由 Cloud Translation API 翻譯而成。

PerfettoPullerMetricCollector

public class PerfettoPullerMetricCollector
extends FilePullerDeviceMetricCollector

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

FilePullerDeviceMetricCollector 的基本實作項目，可從裝置中提取 Perfetto 檔案，並收集相關指標。也可用於將原始追蹤記錄檔轉換為 Perfetto 指標檔案。

摘要

公用建構函式
`PerfettoPullerMetricCollector()`

公用方法
`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)` 從裝置中指定的路徑拉取檔案。

public PerfettoPullerMetricCollector ()

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

方法的實作方式應允許記錄目錄，並剖析該目錄，以便將指標放入 DeviceMetricData。

參數
`key`	`String`：與已拉取的目錄相關聯的選項鍵。
`metricDirectory`	`File`：從裝置中擷取的 `ERROR(/File)`，與選項鍵相符。
`runData`	`DeviceMetricData`：可儲存指標的 `DeviceMetricData`。

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

處理其他指標的 Perfetto 追蹤記錄檔，然後將其新增至最終指標。如果已啟用壓縮功能，請解壓縮 Perfetto 檔案以便處理。

參數
`key`	`String`：與從裝置提取的檔案相關聯的選項鍵。
`metricFile`	`File`：從裝置中擷取的 `ERROR(/File)`，與選項鍵相符。
`data`	`DeviceMetricData`：指標儲存位置。

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

從裝置中指定的路徑提取檔案。如果啟用壓縮 Perfetto 選項，請提取 Perfetto 檔案的壓縮內容。

傳回
`File`	根據是否已設定 mCompressPerfetto 選項，壓縮或解壓縮的 Perfeto 檔案。

擲回
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`