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

本頁面由 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	Collector 可在 DUT 上啟用藍牙 HCI 窺探記錄，並收集各項測試的記錄。
FilePullerLogCollector	記錄裝置端回報的檔案。
PerfettoFilePullerCollector	收集器會從裝置中提取 perfetto 追蹤記錄檔案，並視需要壓縮檔案，然後將檔案新增至測試記錄。
PerfettoPullerMetricCollector	這個類別已淘汰。請改用 `PerfettoFilePullerCollector` 和 `ERROR(/PerfettoTracePostProcessor)`。
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`