此页面由 Cloud Translation API 翻译。

TestFailureListener

public class TestFailureListener
extends Object implements ITestInvocationListener

java.lang.Object 中
↳	com.android.tradefed.testtype.suite.TestFailureListener

用于在测试失败时执行操作（例如屏幕截图、错误报告、收集 logcat ）的监听器。

摘要

公共构造函数
`TestFailureListener( devices, boolean bugReportOnFailure, boolean rebootOnFailure)`

公共方法
`void`	`applyModuleConfiguration(boolean bugreportOnFailure)` 允许针对特定模块捕获失败时替换捕获的调用设置配置。
`void`	`join()` 联接所有 logcat 捕获线程，以确保这些线程终止。
`void`	`setLogger(ITestLogger logger)` 设置应将日志保存到的位置。
`void`	`testFailed(TestDescription test, String trace)` 报告单个测试用例的失败情况。
`void`	`testLog(String dataName, LogDataType dataType, InputStreamSource dataStream)` 提供来自测试调用的关联日志或调试数据。
`void`	`testLogForward(String dataName, LogDataType dataType, InputStreamSource dataStream)` 将日志转发到记录器，而不要像在 #testLog 回调中那样执行该操作 TestFailureListener 是链的一部分，会导致无限循环。

public TestFailureListener ( devices, 
                boolean bugReportOnFailure, 
                boolean rebootOnFailure)

public void applyModuleConfiguration (boolean bugreportOnFailure)

允许针对特定模块捕获失败时替换捕获的调用设置配置。

参数
`bugreportOnFailure`	`boolean`：如果为 true，则会在测试失败时捕获 bug 报告。否则为 false。

public void join ()

联接所有 logcat 捕获线程，以确保这些线程终止。

public void setLogger (ITestLogger logger)

设置应将日志保存到的位置。

参数
`logger`	`ITestLogger`

public void testFailed (TestDescription test, 
                String trace)

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

将在 testStarted 和 testEnded 之间调用。

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

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

提供来自测试调用的关联日志或调试数据。

TradeFederation 框架将自动调用此方法，并提供主机日志以及设备 logcat（如果适用）。

参数
`dataName`	`String`：数据的 `String` 描述性名称。例如“device_logcat”。注意事项每次调用的 dataName 可能不唯一。例如，实施人员必须能够处理具有相同 dataName 的多个调用
`dataType`	`LogDataType`：数据的 `LogDataType`
`dataStream`	`InputStreamSource`：数据的 `InputStreamSource`。实现人员应调用 createInputStream 以开始读取数据，并确保关闭生成的 InputStream。调用方应确保数据源始终保持不变存在且可访问，直到 testLog 方法完成为止。

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

将日志转发到记录器，而不要像在 #testLog 回调中那样执行该操作 TestFailureListener 是链的一部分，会导致无限循环。