此页面由 Cloud Translation API 翻译。

模块监听器

public class ModuleListener
extends CollectingTestListener

java.lang.Object 中
↳	com.android.tradefed.result.CollectingTestListener
	↳	com.android.tradefed.testtype.suite.ModuleListener

附加到每个模块的每个 IRemoteTest 的监听器，以便收集结果。

摘要

公共构造函数
`ModuleListener(ITestInvocationListener listener, IInvocationContext moduleContext)` 构造函数。

公共方法
`boolean`	`hasLastAttemptFailed()` 返回监听器的上一次重试会话是否失败。
`void`	`logAssociation(String dataName, LogFile logFile)` 在某些情况下，日志必须与测试用例密切相关，以此类推，`testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile)` 回调。
`void`	`setAttemptIsolation(CurrentInvocation.IsolationGrade isolation)` 设置是否应将尝试报告为隔离。
`void`	`setCollectTestsOnly(boolean collectTestsOnly)` 设置我们是否仅收集测试。
`void`	`setMarkTestsSkipped(boolean skip)` 是否标记所有跳过的测试用例。
`void`	`setTestMappingSources( testMappingSources)` 设置将插入到指标中的测试映射来源。
`void`	`testAssumptionFailure(TestDescription test, String trace)` 在原子测试标记它假设条件为 false 时调用
`void`	`testAssumptionFailure(TestDescription test, FailureDescription failure)` 在原子测试标记它假设条件为 false 时调用
`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`	`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`	`testRunEnded(long elapsedTime, runMetrics)` 报告测试运行结束。
`void`	`testRunFailed(FailureDescription failure)` 由于“`FailureDescription`”所述的失败情况，未能完成报告测试运行。
`void`	`testRunFailed(String errorMessage)` 由于出现严重错误，未能完成报告测试运行。
`void`	`testRunStarted(String name, int numTests, int attemptNumber)` 报告测试运行开始。
`void`	`testRunStarted(String name, int numTests, int attemptNumber, long startTime)` 报告测试运行开始。
`void`	`testSkipped(TestDescription test, SkipReason reason)` 在因通常不符合预期的原因跳过测试且未执行测试时调用。
`void`	`testStarted(TestDescription test, long startTime)` `testStarted(com.android.tradefed.result.TestDescription)` 的替代方法，其中我们还指定了测试开始，并结合 `ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,Map))` 进行准确测量。

公共构造函数

模块监听器

public ModuleListener (ITestInvocationListener listener, 
                IInvocationContext moduleContext)

构造函数。

参数
`listener`	`ITestInvocationListener`
`moduleContext`	`IInvocationContext`

公共方法

hasLastAttemptFailed

public boolean hasLastAttemptFailed ()

返回监听器的上一次重试会话是否失败。

返回
`boolean`

logAssociation

public void logAssociation (String dataName, 
                LogFile logFile)

在某些情况下，日志必须与测试用例密切相关，以此类推，testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile) 回调。因此，此回调允许提供强关联。。

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

setAttemptIsolation

public void setAttemptIsolation (CurrentInvocation.IsolationGrade isolation)

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

参数
`isolation`	`CurrentInvocation.IsolationGrade`

setCollectTestsOnly

public void setCollectTestsOnly (boolean collectTestsOnly)

设置我们是否仅收集测试。

参数
`collectTestsOnly`	`boolean`

setMarkTestsSkipped

public void setMarkTestsSkipped (boolean skip)

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

参数
`skip`	`boolean`

setTestMappingSources

public void setTestMappingSources ( testMappingSources)

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

参数
`testMappingSources`

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, 
                 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)`

测试失败

public void testFailed (TestDescription test, 
                FailureDescription failure)

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

将在 testStarted 和 testEnded 之间调用。

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

测试失败

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`

testRunEnded

public void testRunEnded (long elapsedTime, 
                 runMetrics)

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

参数
`elapsedTime`	`long`：设备报告的所用时间（以毫秒为单位）
`runMetrics`	：通过 `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 numTests, 
                int attemptNumber)

报告测试运行开始。

参数
`name`	`String`：测试运行名称
`numTests`	`int`：测试运行中的测试总数
`attemptNumber`	`int`：订单号，用于标识同一 runName 的不同尝试运行多次的命令tryNumber 从 0 开始编号，并且应该每次递增。都会发生新的运行例如测试会精细地重试 3 次，总共应该有 4 次以相同的 runName 运行，而 tryNumber 范围为 0 到 3。

testRunStarted

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

报告测试运行开始。

参数
`name`	`String`：测试运行名称
`numTests`	`int`：测试运行中的测试总数
`attemptNumber`	`int`：订单号，用于标识同一 runName 的不同尝试运行多次的命令tryNumber 从 0 开始编号，并且应在每次都会发生新的运行例如测试会精细地重试 3 次，总共应运行 4 次在同一 runName 下运行，并且 tryNumber 范围是 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(com.android.tradefed.result.TestDescription) 的替代方法，其中我们还指定了测试开始，并结合 ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,Map)) 进行准确测量。

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