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

此页面由 Cloud Translation API 翻译。

TestFailureListener

public class TestFailureListener
extends Object implements ITestInvocationListener

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

监听器，用于在有请求时，在测试失败时执行屏幕截图、bug 报告、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 是链的一部分，则会导致无限循环。