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

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

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`