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) 当原子测试标记其假设的条件为 false 时调用
void	testEnded(TestDescription testId, HashMap<String, MetricMeasurement.Metric> 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, HashMap<String, MetricMeasurement.Metric> metrics) 替换父级以明确输出指标。

公共构造函数

TextResultReporter

public TextResultReporter ()

创建 TextResultReporter。

公共方法

testAssumptionFailure

public void testAssumptionFailure (TestDescription testId, 
                String trace)

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

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

testEnded

public void testEnded (TestDescription testId, 
                HashMap<String, MetricMeasurement.Metric> metrics)

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

参数
testId	TestDescription：标识测试
metrics	HashMap：所发出指标的 Map

testFailed

public void testFailed (TestDescription testId, 
                String trace)

替换父级以明确输出失败信息。ResultPrinter 依赖于 runner 在测试运行结束时调用“print”来完成此操作。报告单个测试用例的失败。

将在 testStarted 和 testEnded 之间调用。

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

testLog

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

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

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

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

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

testRunEnded

public void testRunEnded (long elapsedTime, 
                HashMap<String, MetricMeasurement.Metric> metrics)

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

参数
elapsedTime	long：设备报告的已用时间，以毫秒为单位
metrics	HashMap：在测试运行结束时通过 Metric 报告的键值对。