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

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

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>`	从测试指标中新生成的一组指标。