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

Google 會運用 AI 技術將內容翻譯成你偏好的語言，但可能會出錯。

IPostProcessor

public interface IPostProcessor
implements IDisableable, ILogSaverListener, ITestInvocationListener

com.android.tradefed.postprocessor.IPostProcessor

已知間接子類別

AggregatePostProcessor、AveragePostProcessor、BasePostProcessor、BluetoothConnectionSuccessRatePostProcessor、GeminiDebuggingPostProcessor、MetricFilePostProcessor、PerfettoGenericPostProcessor、PerfettoTracePostProcessor、SimpleperfProfilePostProcessor、StatsdBeforeAfterGaugeMetricPostProcessor、StatsdEventMetricPostProcessor、StatsdGenericPostProcessor

AggregatePostProcessor	指標匯總工具，可提供多次疊代測試執行期間收集的數值指標的最小值、最大值、平均值、變異數、標準差、總計、計數，以及 (選用) 百分位數，並將這些指標視為雙精度浮點數。
AveragePostProcessor	實作後處理器，計算指標清單的平均值。
BasePostProcessor	所有實作項目都應擴充的基礎 `IPostProcessor`。
BluetoothConnectionSuccessRatePostProcessor	實作後處理器，計算藍牙設定檔的成功率使用「metric-key-match」指定包含藍牙連線狀態的指標 (以數字陣列表示)，例如 [0, 1, 2, 3, 0, 1, 2, 3]。
GeminiDebuggingPostProcessor	後續處理器會建立提示查詢，以偵錯錯誤。
MetricFilePostProcessor	用於上傳在測試和執行層級收集的指標記錄檔。
PerfettoGenericPostProcessor	後續處理器：遞迴展開具有字串值的 proto 訊息和欄位，直到遇到具有數值的欄位為止，將文字/二進位指標 perfetto proto 檔案處理為鍵/值組合。
PerfettoTracePostProcessor	後處理器：從測試記錄中擷取 perfetto 追蹤記錄檔案，並對這些檔案執行追蹤記錄處理器，以產生 perfetto 指標 proto。
SimpleperfProfilePostProcessor	後續處理器，可找出 simpleperf 分析資料並產生 pprof 設定檔。
StatsdBeforeAfterGaugeMetricPostProcessor	後續處理器，會以「前後」方法處理收集到的計量表指標，也就是：
StatsdEventMetricPostProcessor	後置處理器：使用處理器上指定的格式化工具，將 statsd 報表中的事件指標處理為鍵/值組合。
StatsdGenericPostProcessor	後續處理器：將二進位 proto statsd 報表處理為鍵/值組合，方法是將報表展開為樹狀結構。

後續處理器是 Trade Federation 物件，用於在測試後和結果回報前處理指標和記錄。這樣一來，所有 result_reporter 物件都能接收到後續處理的資料，不必只在一個 result_reporter 內進行後續處理，也不會發生傳遞新資料的問題。

摘要

公用方法
`abstract ITestInvocationListener`	`init(ITestInvocationListener listener)` 後處理器的初始化步驟。
`abstract Map<String, MetricMeasurement.Metric.Builder>`	`processAllTestMetricsAndLogs(ListMultimap<String, MetricMeasurement.Metric> allTestMetrics, Map<TestDescription, Map<String, LogFile>> allTestLogs)` 實作這個方法，匯總所有測試的指標和記錄。
`abstract Map<String, MetricMeasurement.Metric.Builder>`	`processRunMetricsAndLogs(HashMap<String, MetricMeasurement.Metric> rawMetrics, Map<String, LogFile> runLogs)` 實作這個方法，即可從現有指標和記錄產生一組新指標。
`abstract Map<String, MetricMeasurement.Metric.Builder>`	`processTestMetricsAndLogs(TestDescription testDescription, HashMap<String, MetricMeasurement.Metric> testMetrics, Map<String, LogFile> testLogs)` 導入這個方法，即可後續處理各項測試的指標和記錄。

公用方法

init

public abstract ITestInvocationListener init (ITestInvocationListener listener)

後處理器的初始化步驟。確保在任何測試回呼之前呼叫。

參數
`listener`	`ITestInvocationListener`

傳回
`ITestInvocationListener`

processAllTestMetricsAndLogs

public abstract Map<String, MetricMeasurement.Metric.Builder> processAllTestMetricsAndLogs (ListMultimap<String, MetricMeasurement.Metric> allTestMetrics, 
                Map<TestDescription, Map<String, LogFile>> allTestLogs)

導入這個方法，即可匯總所有測試的指標和記錄。這個方法產生的指標會回報為執行指標。只應傳回新產生的指標，且鍵名不得重複 (不得與現有鍵發生衝突)。

參數
`allTestMetrics`	`ListMultimap`：HashMultimap，用於儲存每個測試的指標，並依指標名稱分組。
`allTestLogs`	`Map`：地圖，用於儲存每個測試的記錄檔地圖，並以資料名稱做為鍵，使用每個測試的 `TestDescription` 做為鍵。

傳回
`Map<String, MetricMeasurement.Metric.Builder>`	所有測試指標中新產生的指標集。

processRunMetricsAndLogs

public abstract Map<String, MetricMeasurement.Metric.Builder> processRunMetricsAndLogs (HashMap<String, MetricMeasurement.Metric> rawMetrics, 
                Map<String, LogFile> runLogs)

請實作這個方法，從現有指標和記錄產生一組新指標。系統只會傳回新產生的指標，且金鑰名稱不得重複 (不得與現有金鑰發生衝突)。

參數
`rawMetrics`	`HashMap`：可供執行作業使用的原始指標集。
`runLogs`	`Map`：測試執行的記錄檔集。

傳回
`Map<String, MetricMeasurement.Metric.Builder>`	從執行指標產生的一組新指標。

processTestMetricsAndLogs

public abstract Map<String, MetricMeasurement.Metric.Builder> processTestMetricsAndLogs (TestDescription testDescription, 
                HashMap<String, MetricMeasurement.Metric> testMetrics, 
                Map<String, LogFile> testLogs)

導入這個方法，即可後續處理各項測試的指標和記錄。系統只會傳回新產生的指標，且金鑰名稱不得重複 (不得與現有金鑰發生衝突)。

參數
`testDescription`	`TestDescription`：描述測試的 TestDescription 物件。
`testMetrics`	`HashMap`：測試中的指標集。
`testLogs`	`Map`：測試期間記錄的一組檔案。

傳回
`Map<String, MetricMeasurement.Metric.Builder>`	從測試指標新產生的一組指標。