自 2026 年起，为了与我们的主干稳定开发模型保持一致，并确保生态系统的平台稳定性，我们将在第 2 季度和第 4 季度将源代码发布到 AOSP。对于构建 AOSP 和向 AOSP 贡献代码，我们建议使用 android-latest-release 而不是 aosp-main。android-latest-release 清单分支将始终引用推送到 AOSP 的最新版本。如需了解详情，请参阅 AOSP 变更。

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`