自 2025 年 3 月 27 日起，我们建议您使用 android-latest-release 而非 aosp-main 构建 AOSP 并为其做出贡献。如需了解详情，请参阅 AOSP 的变更。

此页面由 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`