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

此页面由 Cloud Translation API 翻译。

TextResultReporter

public class TextResultReporter
extends InvocationToJUnitResultForwarder implements ILogSaverListener, ITestInvocationListener

java.lang.Object
↳	com.android.tradefed.result.InvocationToJUnitResultForwarder
	↳	com.android.tradefed.result.TextResultReporter

一种测试结果报告程序，用于将结果转发给 JUnit 文本结果打印程序。

摘要

公共构造函数
`TextResultReporter()` 创建 `TextResultReporter`。

公共方法
`void`	`testAssumptionFailure(TestDescription testId, String trace)` 当原子测试标记为假的假设条件时调用
`void`	`testEnded(TestDescription testId, metrics)` 替换父级以明确输出测试指标。
`void`	`testFailed(TestDescription testId, String trace)` 替换父级以明确输出失败情况。
`void`	`testLog(String dataName, LogDataType dataType, InputStreamSource dataStream)` 提供测试调用中的关联日志或调试数据。
`void`	`testLogSaved(String dataName, LogDataType dataType, InputStreamSource dataStream, LogFile logFile)` 在保存测试日志时调用。
`void`	`testRunEnded(long elapsedTime, metrics)` 替换父级以明确输出指标。

公共构造函数

TextResultReporter

public TextResultReporter ()

创建 TextResultReporter。

公共方法

testAssumptionFailure

public void testAssumptionFailure (TestDescription testId, 
                String trace)

当原子测试标记为假的假设条件时调用

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

testEnded

public void testEnded (TestDescription testId, 
                 metrics)

替换父级以明确输出测试指标。

参数
`testId`	`TestDescription`：用于标识测试
`metrics`	：发出的指标的 `ERROR(/Map)`

testFailed

public void testFailed (TestDescription testId, 
                String trace)

替换父级以明确输出失败情况。ResultPrinter 依赖于在测试运行结束时运行程序调用“print”来执行此操作。报告单个测试用例的失败。

将在 testStarted 和 testEnded 之间调用。

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

testLog

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

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

必须在 ERROR(/ITestInvocationListener#invocationFailed(Throwable)) 或 ERROR(/ITestInvocationListener#invocationEnded(long)) 之前调用

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

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

testLogSaved

public void testLogSaved (String dataName, 
                LogDataType dataType, 
                InputStreamSource dataStream, 
                LogFile logFile)

在保存测试日志时调用。

应改为使用 ITestInvocationListener.testLog(String, LogDataType, InputStreamSource)。

参数
`dataName`	`String`：数据的 `String` 描述性名称，例如“device_logcat”。注意：每次调用时，dataName 可能不唯一。即，实现者必须能够处理具有相同 dataName 的多次调用
`dataType`	`LogDataType`：数据的 `LogDataType`
`dataStream`	`InputStreamSource`：数据的 `InputStreamSource`。实现人员应调用 createInputStream 以开始读取数据，并确保在完成后关闭生成的 InputStream。
`logFile`	`LogFile`：包含已保存文件的元数据的 `LogFile`。

testRunEnded

public void testRunEnded (long elapsedTime, 
                 metrics)

替换父级以明确输出指标。

参数
`elapsedTime`	`long`：设备报告的经过时间（以毫秒为单位）
`metrics`	：测试运行结束时报告的键值对