自 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.

ResultAggregator

public class ResultAggregator
extends CollectingTestListener

java.lang.Object
↳	com.android.tradefed.result.CollectingTestListener
	↳	com.android.tradefed.retry.ResultAggregator

一种特殊的转发器，可根据所采取的重试策略在需要时汇总结果。

摘要

公共构造函数
`ResultAggregator(List<ITestInvocationListener> listeners, RetryStrategy strategy)`

公共方法
`void`	`cleanEventsFiles()`
`final void`	`forwardAggregatedInvocationLogs()` 将所有调用级日志转发给不支持精细结果的结果报告程序。
`void`	`invocationEnded(long elapsedTime)` 报告调用已终止，无论是成功终止还是因某些错误情况而终止。
`void`	`invocationFailed(FailureDescription failure)`
`void`	`invocationFailed(Throwable cause)` 报告因某些错误情况而导致的不完整调用。
`void`	`invocationSkipped(SkipReason reason)` 报告调用已跳过
`void`	`invocationStarted(IInvocationContext context)` 报告测试调用的开始。
`void`	`logAssociation(String dataName, LogFile logFile)` 在某些情况下，日志必须与测试用例紧密关联，但无法在直接 `testLogSaved(String,LogDataType,InputStreamSource,LogFile)` 回调中实现此目的。
`void`	`setLogSaver(ILogSaver logSaver)`
`void`	`setUpdatedReporting(boolean updatedReporting)` 设置新的报告。
`void`	`testAssumptionFailure(TestDescription test, String trace)` 当原子测试标记其假设的条件为 false 时调用
`void`	`testAssumptionFailure(TestDescription test, FailureDescription failure)` 当原子测试标记其假设的条件为 false 时调用
`void`	`testEnded(TestDescription test, long endTime, HashMap<String, MetricMeasurement.Metric> testMetrics)` `testEnded(TestDescription,Map)` 的替代方案，可直接指定结束时间。
`void`	`testFailed(TestDescription test, FailureDescription failure)` 报告单个测试用例的失败情况。
`void`	`testFailed(TestDescription test, String trace)` 报告单个测试用例的失败情况。
`void`	`testIgnored(TestDescription test)` 当测试不会运行时（通常是因为测试方法使用 org.junit.Ignore 注释进行了注释）调用。
`void`	`testLog(String dataName, LogDataType dataType, InputStreamSource dataStream)`
`void`	`testLogSaved(String dataName, LogDataType dataType, InputStreamSource dataStream, LogFile logFile)`
`void`	`testModuleEnded()` 报告模块运行结束。
`void`	`testModuleStarted(IInvocationContext moduleContext)` 报告模块运行的开始时间。
`void`	`testRunEnded(long elapsedTime, HashMap<String, MetricMeasurement.Metric> runMetrics)` 报告测试运行结束。
`void`	`testRunFailed(FailureDescription failure)` 报告测试运行因 `FailureDescription` 所述的失败而未能完成。
`void`	`testRunFailed(String errorMessage)` 由于出现严重错误，报告测试运行未能完成。
`void`	`testRunStarted(String name, int testCount, int attemptNumber, long startTime)` 报告测试运行的开始。
`void`	`testSkipped(TestDescription test, SkipReason reason)` 当测试因通常不预期的原因而被跳过且未执行时调用。
`void`	`testStarted(TestDescription test, long startTime)` `testStarted(TestDescription)` 的替代方案，其中还指定了测试开始时间，并与 `testEnded(TestDescription,long,Map)` 结合使用以实现精确衡量。

受保护的方法
`File[]`	`getEventsLogs()`

公共构造函数

ResultAggregator

public ResultAggregator (List<ITestInvocationListener> listeners, 
                RetryStrategy strategy)

参数
`listeners`	`List`
`strategy`	`RetryStrategy`

公共方法

cleanEventsFiles

public void cleanEventsFiles ()

forwardAggregatedInvocationLogs

public final void forwardAggregatedInvocationLogs ()

将所有调用级日志转发给不支持精细结果的结果报告程序。

invocationEnded

public void invocationEnded (long elapsedTime)

报告调用已终止，无论是成功终止还是因某些错误情况而终止。

将由 TradeFederation 框架自动调用。

参数
`elapsedTime`	`long`：调用的已用时间（以毫秒为单位）

invocationFailed

public void invocationFailed (FailureDescription failure)

参数
`failure`	`FailureDescription`

invocationFailed

public void invocationFailed (Throwable cause)

报告因某些错误情况而导致的不完整调用。

将由 TradeFederation 框架自动调用。

参数
`cause`	`Throwable`：失败的 `Throwable` 原因

invocationSkipped

public void invocationSkipped (SkipReason reason)

报告调用已跳过

参数
`reason`	`SkipReason`

invocationStarted

public void invocationStarted (IInvocationContext context)

报告测试调用的开始。

将由 TradeFederation 框架自动调用。报告者需要替换此方法才能支持多设备报告。

参数
`context`	`IInvocationContext`：有关调用的信息

logAssociation

public void logAssociation (String dataName, 
                LogFile logFile)

在某些情况下，日志必须与测试用例紧密关联，但无法在直接 testLogSaved(String,LogDataType,InputStreamSource,LogFile) 回调中实现这一点。因此，此回调允许明确提供强关联。

参数
`dataName`	`String`：数据的名称
`logFile`	`LogFile`：之前记录的 `LogFile`，应与测试用例相关联。

setLogSaver

public void setLogSaver (ILogSaver logSaver)

参数
`logSaver`	`ILogSaver`

setUpdatedReporting

public void setUpdatedReporting (boolean updatedReporting)

设置新的报告。

参数
`updatedReporting`	`boolean`

testAssumptionFailure

public void testAssumptionFailure (TestDescription test, 
                String trace)

当原子测试标记其假设的条件为 false 时调用

参数
`test`	`TestDescription`：标识测试
`trace`	`String`：失败的堆栈轨迹

testAssumptionFailure

public void testAssumptionFailure (TestDescription test, 
                FailureDescription failure)

当原子测试标记其假设的条件为 false 时调用

参数
`test`	`TestDescription`：标识测试
`failure`	`FailureDescription`：描述失败及其上下文的 `FailureDescription`。

testEnded

public void testEnded (TestDescription test, 
                long endTime, 
                HashMap<String, MetricMeasurement.Metric> testMetrics)

testEnded(TestDescription,Map) 的替代方案，可直接指定结束时间。与 testStarted(TestDescription,long) 结合使用，可实现精确衡量。

参数
`test`	`TestDescription`：标识测试
`endTime`	`long`：测试结束时间，通过 `System.currentTimeMillis()` 测量
`testMetrics`	`HashMap`：所发出指标的 `Map`

testFailed

public void testFailed (TestDescription test, 
                FailureDescription failure)

报告单个测试用例的失败。

将在 testStarted 和 testEnded 之间调用。

参数
`test`	`TestDescription`：标识测试
`failure`	`FailureDescription`：描述失败及其上下文的 `FailureDescription`。

testFailed

public void testFailed (TestDescription test, 
                String trace)

报告单个测试用例的失败。

将在 testStarted 和 testEnded 之间调用。

参数
`test`	`TestDescription`：标识测试
`trace`	`String`：失败的堆栈轨迹

testIgnored

public void testIgnored (TestDescription test)

当测试不会运行时调用，通常是因为测试方法使用 org.junit.Ignore 注释。

参数
`test`	`TestDescription`：标识测试

testLog

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

参数
`dataName`	`String`
`dataType`	`LogDataType`
`dataStream`	`InputStreamSource`

testLogSaved

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

参数
`dataName`	`String`
`dataType`	`LogDataType`
`dataStream`	`InputStreamSource`
`logFile`	`LogFile`

testModuleEnded

public void testModuleEnded ()

报告模块运行结束。

testModuleStarted

public void testModuleStarted (IInvocationContext moduleContext)

报告模块运行的开始时间。此回调与 testModuleEnded() 相关联，在序列中是可选的。仅在运行使用模块（基于套件的运行程序）时使用。

参数
`moduleContext`	`IInvocationContext`：模块的 `IInvocationContext`。

testRunEnded

public void testRunEnded (long elapsedTime, 
                HashMap<String, MetricMeasurement.Metric> runMetrics)

报告测试运行结束。FIXME：我们不能有两个具有不同类型的 Map<> 接口，因此我们必须在此处使用 HashMap。

参数
`elapsedTime`	`long`：设备报告的已用时间，以毫秒为单位
`runMetrics`	`HashMap`：在测试运行结束时通过 `Metric` 报告的键值对。

testRunFailed

public void testRunFailed (FailureDescription failure)

报告测试运行因 FailureDescription 所述的失败而未能完成。

参数
`failure`	`FailureDescription`：描述失败及其上下文的 `FailureDescription`。

testRunFailed

public void testRunFailed (String errorMessage)

由于出现严重错误，报告测试运行未能完成。

参数
`errorMessage`	`String`：`String`，用于描述运行失败的原因。

testRunStarted

public void testRunStarted (String name, 
                int testCount, 
                int attemptNumber, 
                long startTime)

报告测试运行的开始。

参数
`name`	`String`：测试运行名称
`testCount`	`int`：测试运行中的测试总数
`attemptNumber`	`int`：用于标识多次运行的同一 runName 的不同尝试的订单号。attemptNumber 从 0 开始，每次新运行时都会递增。例如，如果某个测试进行了 3 次精细重试，则在同一 runName 下，该测试总共应运行 4 次，且 attemptNumber 为 0 到 3。
`startTime`	`long`：运行开始时间，通过 `System.currentTimeMillis()` 测量

testSkipped

public void testSkipped (TestDescription test, 
                SkipReason reason)

当测试因通常不预期的原因而被跳过且未执行时调用。系统将尝试重试这些测试，以尝试获得正确的执行结果。

参数
`test`	`TestDescription`：标识测试
`reason`	`SkipReason`：`SkipReason`

testStarted

public void testStarted (TestDescription test, 
                long startTime)

testStarted(TestDescription) 的替代方案，我们还指定了测试开始时间，并与 testEnded(TestDescription,long,Map) 结合使用以实现精确衡量。

参数
`test`	`TestDescription`：标识测试
`startTime`	`long`：测试开始时间，通过 `System.currentTimeMillis()` 测量

受保护的方法

getEventsLogs

protected File[] getEventsLogs ()

返回
`File[]`