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

Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

BasePostProcessor

public abstract class BasePostProcessor
extends Object implements IPostProcessor

java.lang.Object
↳	com.android.tradefed.postprocessor.BasePostProcessor

已知的直接子類別

AggregatePostProcessor、AveragePostProcessor、MetricFilePostProcessor

AggregatePostProcessor	指標匯總工具，可針對在多次迭代測試執行期間收集到的數值指標，提供最小值、最大值、平均值、變異數、標準差、總數、計數，以及選用的百分位數，並將這些值視為雙精度浮點值。
AveragePostProcessor	實作後置處理器，計算指標清單的平均值。
MetricFilePostProcessor	用於上傳在測試和執行層級收集的指標記錄檔案。

每個實作項目都應擴充的基本 IPostProcessor。請確認會在最終結果回報器之前呼叫後置處理方法。

摘要

公用建構函式
`BasePostProcessor()`

公用方法
`final ITestInvocationListener`	`init(ITestInvocationListener listener)` 後置處理器的初始化步驟。
`final void`	`invocationEnded(long elapsedTime)`
`final void`	`invocationFailed(FailureDescription failure)`
`final void`	`invocationFailed(Throwable cause)`
`final void`	`invocationStarted(IInvocationContext context)` 用於轉送的叫用事件監聽器
`final boolean`	`isDisabled()` 如果整個物件已停用 (略過設定和拆解)，則傳回 True。
`final void`	`logAssociation(String dataName, LogFile logFile)` 更新記錄至測試的關聯。
	`processAllTestMetricsAndLogs(ListMultimap<String, MetricMeasurement.Metric> allTestMetrics, allTestLogs)` 實作此方法，匯總所有測試的指標和記錄。
`abstract`	`processRunMetricsAndLogs( rawMetrics, runLogs)` 實作此方法，即可從現有指標和記錄產生一組新指標。
	`processTestMetricsAndLogs(TestDescription testDescription, testMetrics, testLogs)` 實作此方法，以便從每項測試中後處理指標和記錄。
`final void`	`setLogSaver(ILogSaver logSaver)`
`final void`	`testAssumptionFailure(TestDescription test, String trace)`
`final void`	`testAssumptionFailure(TestDescription test, FailureDescription failure)`
`final void`	`testEnded(TestDescription test, long endTime, testMetrics)`
`final void`	`testEnded(TestDescription test, testMetrics)`
`final void`	`testFailed(TestDescription test, FailureDescription failure)`
`final void`	`testFailed(TestDescription test, String trace)`
`final void`	`testIgnored(TestDescription test)`
`final void`	`testLog(String dataName, LogDataType dataType, InputStreamSource dataStream)` 使用這個方法，從 PostProcessor 實作記錄檔案。
`final void`	`testLogSaved(String dataName, LogDataType dataType, InputStreamSource dataStream, LogFile logFile)`
`final void`	`testModuleEnded()`
`final void`	`testModuleStarted(IInvocationContext moduleContext)`
`final void`	`testRunEnded(long elapsedTime, runMetrics)`
`final void`	`testRunFailed(FailureDescription failure)`
`final void`	`testRunFailed(String errorMessage)`
`final void`	`testRunStarted(String runName, int testCount, int attemptNumber)`
`final void`	`testRunStarted(String runName, int testCount)` 測試執行回呼
`final void`	`testRunStopped(long elapsedTime)`
`final void`	`testStarted(TestDescription test, long startTime)`
`final void`	`testStarted(TestDescription test)` 測試案例回呼

受保護的方法
`MetricMeasurement.DataType`	`getMetricType()` 如有需要，請覆寫此方法來變更指標類型。
`String`	`getRunName()`

公用建構函式

BasePostProcessor

public BasePostProcessor ()

公用方法

init

public final ITestInvocationListener init (ITestInvocationListener listener)

後置處理器的初始化步驟。請務必在任何測試回呼之前呼叫。

參數
`listener`	`ITestInvocationListener`

傳回
`ITestInvocationListener`

invocationEnded

public final void invocationEnded (long elapsedTime)

參數
`elapsedTime`	`long`

invocationFailed

public final void invocationFailed (FailureDescription failure)

參數
`failure`	`FailureDescription`

invocationFailed

public final void invocationFailed (Throwable cause)

參數
`cause`	`Throwable`

invocationStarted

public final void invocationStarted (IInvocationContext context)

用於轉送的叫用事件監聽器

參數
`context`	`IInvocationContext`

isDisabled

public final boolean isDisabled ()

如果整個物件已停用 (略過設定和拆卸)，則傳回 True。否則為 False。

傳回
`boolean`

logAssociation

public final void logAssociation (String dataName, 
                LogFile logFile)

更新記錄與測試的關聯。如果在測試期間呼叫此方法，則記錄屬於測試；否則，則是執行記錄。

參數
`dataName`	`String`
`logFile`	`LogFile`

processAllTestMetricsAndLogs

public  processAllTestMetricsAndLogs (ListMultimap<String, MetricMeasurement.Metric> allTestMetrics, 
                 allTestLogs)

實作此方法，匯總所有測試的指標和記錄。這個方法產生的指標會以執行指標的形式回報。請只傳回新產生的指標，並附上專屬的鍵名稱 (不得與現有鍵重複)。

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

傳回
	從所有測試指標產生的全新指標組合。

processRunMetricsAndLogs

public abstract  processRunMetricsAndLogs ( rawMetrics, 
                 runLogs)

實作此方法，即可從現有指標和記錄產生一組新指標。請只傳回新產生的指標，並附上專屬的鍵名稱 (不得與現有鍵重複)。

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

傳回
	從執行指標新產生的指標組合。

processTestMetricsAndLogs

public  processTestMetricsAndLogs (TestDescription testDescription, 
                 testMetrics, 
                 testLogs)

實作此方法，以便從每項測試中後處理指標和記錄。請只傳回新產生的指標，並附上專屬的鍵名稱 (不得與現有鍵重複)。

參數
`testDescription`	`TestDescription`：描述測試的 TestDescription 物件。
`testMetrics`	：測試的一系列指標。
`testLogs`	：測試期間記錄的檔案集合。

傳回
	從測試指標新產生的指標組合。

setLogSaver

public final void setLogSaver (ILogSaver logSaver)

參數
`logSaver`	`ILogSaver`

testAssumptionFailure

public final void testAssumptionFailure (TestDescription test, 
                String trace)

參數
`test`	`TestDescription`
`trace`	`String`

testAssumptionFailure

public final void testAssumptionFailure (TestDescription test, 
                FailureDescription failure)

參數
`test`	`TestDescription`
`failure`	`FailureDescription`

testEnded

public final void testEnded (TestDescription test, 
                long endTime, 
                 testMetrics)

參數
`test`	`TestDescription`
`endTime`	`long`
`testMetrics`

testEnded

public final void testEnded (TestDescription test, 
                 testMetrics)

參數
`test`	`TestDescription`
`testMetrics`

testFailed

public final void testFailed (TestDescription test, 
                FailureDescription failure)

參數
`test`	`TestDescription`
`failure`	`FailureDescription`

testFailed

public final void testFailed (TestDescription test, 
                String trace)

參數
`test`	`TestDescription`
`trace`	`String`

testIgnored

public final void testIgnored (TestDescription test)

參數
`test`	`TestDescription`

testLog

public final void testLog (String dataName, 
                LogDataType dataType, 
                InputStreamSource dataStream)

請使用這個方法，從 PostProcessor 實作記錄檔案。

參數
`dataName`	`String`
`dataType`	`LogDataType`
`dataStream`	`InputStreamSource`

testLogSaved

public final void testLogSaved (String dataName, 
                LogDataType dataType, 
                InputStreamSource dataStream, 
                LogFile logFile)

參數
`dataName`	`String`
`dataType`	`LogDataType`
`dataStream`	`InputStreamSource`
`logFile`	`LogFile`

testModuleEnded

public final void testModuleEnded ()

testModuleStarted

public final void testModuleStarted (IInvocationContext moduleContext)

參數
`moduleContext`	`IInvocationContext`

testRunEnded

public final void testRunEnded (long elapsedTime, 
                 runMetrics)

參數
`elapsedTime`	`long`
`runMetrics`

testRunFailed

public final void testRunFailed (FailureDescription failure)

參數
`failure`	`FailureDescription`

testRunFailed

public final void testRunFailed (String errorMessage)

參數
`errorMessage`	`String`

testRunStarted

public final void testRunStarted (String runName, 
                int testCount, 
                int attemptNumber)

參數
`runName`	`String`
`testCount`	`int`
`attemptNumber`	`int`

testRunStarted

public final void testRunStarted (String runName, 
                int testCount)

測試執行回呼

參數
`runName`	`String`
`testCount`	`int`

testRunStopped

public final void testRunStopped (long elapsedTime)

參數
`elapsedTime`	`long`

testStarted

public final void testStarted (TestDescription test, 
                long startTime)

參數
`test`	`TestDescription`
`startTime`	`long`

testStarted

public final void testStarted (TestDescription test)

測試案例回呼

參數
`test`	`TestDescription`

受保護的方法

getMetricType

protected MetricMeasurement.DataType getMetricType ()

如有需要，請覆寫此方法來變更指標類型。預設指標設為已處理的類型。

傳回
`MetricMeasurement.DataType`

getRunName

protected String getRunName ()

傳回
`String`