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

ModuleResultsAndMetricsForwarder

public class ModuleResultsAndMetricsForwarder
extends ResultAndLogForwarder

java.lang.Object
↳	com.android.tradefed.result.ResultForwarder
	↳	com.android.tradefed.result.ResultAndLogForwarder
		↳	com.android.tradefed.result.ModuleResultsAndMetricsForwarder

ResultAndLogForwarder 的扩展，可向测试结果添加额外的模块相关指标。

摘要

公共构造函数
`ModuleResultsAndMetricsForwarder(ITestInvocationListener... listeners)`

公共方法
`void`	`setAttemptIsolation(CurrentInvocation.IsolationGrade isolation)` 设置是否应将尝试报告为隔离。
`void`	`setMarkTestsSkipped(boolean skip)` 是否将所有测试用例标记为跳过。
`void`	`setModuleId(String moduleId)`
`void`	`setTestMappingSources(List<String> testMappingSources)` 设置将插入到指标中的测试映射来源。
`void`	`testEnded(TestDescription test, HashMap<String, MetricMeasurement.Metric> testMetrics)` 报告单个测试用例的执行结束时间。
`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`	`testRunEnded(long elapsedTime, HashMap<String, MetricMeasurement.Metric> runMetrics)` 报告测试运行结束。
`void`	`testRunEnded(long elapsedTimeMillis, Map<String, String> runMetrics)`
`void`	`testRunFailed(FailureDescription failure)` 报告测试运行因 `FailureDescription` 所述的失败而未能完成。
`void`	`testRunFailed(String errorMessage)` 由于出现严重错误，报告测试运行未能完成。
`void`	`testRunStarted(String runName, int testCount, int attemptNumber)` 报告测试运行的开始。
`void`	`testRunStarted(String runName, int testCount, int attemptNumber, long startTime)` 报告测试运行的开始。
`void`	`testStarted(TestDescription test, long startTime)` `testStarted(TestDescription)` 的替代方案，其中还指定了测试开始时间，并与 `testEnded(TestDescription,long,Map)` 结合使用以实现精确衡量。
`void`	`testStarted(TestDescription test)` 报告单个测试用例的开始。

公共构造函数

ModuleResultsAndMetricsForwarder

public ModuleResultsAndMetricsForwarder (ITestInvocationListener... listeners)

参数
`listeners`	`ITestInvocationListener`

公共方法

setAttemptIsolation

public void setAttemptIsolation (CurrentInvocation.IsolationGrade isolation)

设置是否应将尝试报告为隔离。

参数
`isolation`	`CurrentInvocation.IsolationGrade`

setMarkTestsSkipped

public void setMarkTestsSkipped (boolean skip)

是否将所有测试用例标记为跳过。

参数
`skip`	`boolean`

setModuleId

public void setModuleId (String moduleId)

参数
`moduleId`	`String`

setTestMappingSources

public void setTestMappingSources (List<String> testMappingSources)

设置将插入到指标中的测试映射来源。

参数
`testMappingSources`	`List`

testEnded

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

报告单个测试用例的执行结束时间。

如果未调用 testFailed(TestDescription, FailureDescription)，则此测试通过。还会返回测试用例执行期间可能发出的任何键值指标。

参数
`test`	`TestDescription`：标识测试
`testMetrics`	`HashMap`：所发出指标的 `Map`

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`：失败的堆栈轨迹

testRunEnded

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

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

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

testRunEnded

public void testRunEnded (long elapsedTimeMillis, 
                Map<String, String> runMetrics)

参数
`elapsedTimeMillis`	`long`
`runMetrics`	`Map`

testRunFailed

public void testRunFailed (FailureDescription failure)

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

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

testRunFailed

public void testRunFailed (String errorMessage)

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

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

testRunStarted

public void testRunStarted (String runName, 
                int testCount, 
                int attemptNumber)

报告测试运行的开始。

参数
`runName`	`String`：测试运行名称
`testCount`	`int`：测试运行中的测试总数
`attemptNumber`	`int`：用于标识多次运行的同一 runName 的不同尝试的订单号。attemptNumber 的索引从 0 开始，每次新运行时都应递增。例如，如果某测试细粒度重试 3 次，则在同一 runName 下应总共有 4 次运行，且 attemptNumber 从 0 到 3。

testRunStarted

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

报告测试运行的开始。

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

testStarted

public void testStarted (TestDescription test, 
                long startTime)

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

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

testStarted

public void testStarted (TestDescription test)

报告单个测试用例的开始。旧版接口，应尽可能使用 testStarted(TestDescription)。

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