自 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	收集器，可在 DUT 上啟用藍牙 HCI 窺探記錄，並收集每項測試的記錄。
FilePullerLogCollector	裝置端回報的檔案記錄器。
PerfettoPullerMetricCollector	`FilePullerDeviceMetricCollector` 的基本實作項目，可從裝置中提取 Perfetto 檔案，並收集相關指標。
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`