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

此页面由 Cloud Translation API 翻译。

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( testMappingSources)` 设置将插入到指标中的测试映射来源。
`void`	`testEnded(TestDescription test, long endTime, testMetrics)` `ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map))` 的替代方案，可直接指定结束时间。
`void`	`testEnded(TestDescription test, testMetrics)` 报告单个测试用例的执行结束时间。
`void`	`testFailed(TestDescription test, FailureDescription failure)` 报告单个测试用例的失败。
`void`	`testFailed(TestDescription test, String trace)` 报告单个测试用例的失败。
`void`	`testRunEnded(long elapsedTimeMillis, 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(com.android.tradefed.result.TestDescription)` 的替代方案，其中还指定了测试开始时间，并与 `ERROR(/#testEnded(com.android.tradefed.result.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 ( testMappingSources)

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

参数
`testMappingSources`

testEnded

public void testEnded (TestDescription test, 
                long endTime, 
                 testMetrics)

ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map)) 的替代方案，可直接指定结束时间。与 testStarted(com.android.tradefed.result.TestDescription, long) 结合使用，可实现精确测量。

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

testEnded

public void testEnded (TestDescription test, 
                 testMetrics)

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

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

参数
`test`	`TestDescription`：用于标识测试
`testMetrics`	：所发出指标的 `ERROR(/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 elapsedTimeMillis, 
                 runMetrics)

报告测试运行结束。

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

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(com.android.tradefed.result.TestDescription) 的替代方案，其中还指定了测试的开始时间，并与 ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,Map)) 结合使用以实现精确衡量。

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

testStarted

public void testStarted (TestDescription test)

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

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