Google 致力于为黑人社区推动种族平等。查看具体举措
此页面由 Cloud Translation API 翻译。
Switch to English

SubprocessResultsReporter

public class SubprocessResultsReporter
implements ITestInvocationListener , ILogSaverListener extends Object implements ITestInvocationListener , ILogSaverListener

java.lang.Object
com.android.tradefed.result.SubprocessResultsReporter


实现ITestInvocationListener ,将其指定为result_reporter,并从子流程转发测试,测试运行,测试调用的结果。

摘要

公共建设者

SubprocessResultsReporter ()

公开方法

void close ()

TestSummary getSummary ()

允许InvocationListener返回摘要。

void invocationEnded (long elapsedTime)

报告调用已成功终止或由于某些错误情况而终止。

void invocationFailed (Throwable cause)

报告由于某些错误情况而导致的不完整调用。

void invocationStarted ( IInvocationContext context)

报告测试调用的开始。

void logAssociation (String dataName, LogFile logFile)

在某些情况下,日志必须与测试用例紧密关联,但是有机会直接通过testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile)回调是不可能的。

void printEvent (String key, Object event)

帮助程序先打印事件键,然后再打印json对象。

void setOutputTestLog (boolean outputTestLog)

设置是否输出已记录的测试。

void testAssumptionFailure ( TestDescription testId, String trace)

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

void testEnded ( TestDescription testId, long endTime, metrics) testEnded ( TestDescription testId, long endTime, metrics)

ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map))替代方法,我们可以直接指定结束时间。

void testEnded ( TestDescription testId, metrics) testEnded ( TestDescription testId, metrics)

报告单个测试用例的执行结束。

void testFailed ( TestDescription testId, String reason)

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

void testIgnored ( TestDescription testId)

在不运行测试时调用,通常是因为测试方法使用org.junit.Ignore注释。

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

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

void testModuleEnded ()

报告模块运行结束。

void testModuleStarted ( IInvocationContext moduleContext)

报告模块运行的开始。

void testRunEnded (long time, runMetrics) testRunEnded (long time, runMetrics)

报告测试运行结束。

void testRunFailed (String reason)

由于出现致命错误,报告测试运行未能完成。

void testRunStarted (String runName, int testCount, int attemptNumber)

报告测试运行的开始。

void testRunStarted (String runName, int testCount)

报告测试运行的开始。

void testRunStopped (long arg0)

报告测试运行由于用户请求而在完成之前停止。

void testStarted ( TestDescription testId, long startTime)

替代testStarted(com.android.tradefed.result.TestDescription)地方,我们还指定何时开始测试,并与ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,Map))以进行精确测量。

void testStarted ( TestDescription testId)

报告单个测试用例的开始。

公共建设者

SubprocessResultsReporter

public SubprocessResultsReporter ()

公开方法

public void close ()

getSummary

public TestSummary getSummary ()

允许InvocationListener返回摘要。

退货
TestSummary 汇总运行的TestSummary ,或者为null

调用结束

public void invocationEnded (long elapsedTime)

报告调用已成功终止或由于某些错误情况而终止。

将由TradeFederation框架自动调用。

参量
elapsedTime long :调用经过的时间(以毫秒为单位)

调用失败

public void invocationFailed (Throwable cause)

报告由于某些错误情况而导致的不完整调用。

将由TradeFederation框架自动调用。

参量
cause Throwable :失败的可Throwable原因

调用开始

public void invocationStarted ( IInvocationContext context)

报告测试调用的开始。

将由TradeFederation框架自动调用。报告者需要重写此方法以支持多个设备报告。

参量
context IInvocationContext :有关调用的信息

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 ,应该与测试用例关联。

printEvent

public void printEvent (String key, 
                Object event)

帮助程序先打印事件键,然后再打印json对象。

参量
key String

event Object

setOutputTestLog

public void setOutputTestLog (boolean outputTestLog)

设置是否输出已记录的测试。

参量
outputTestLog boolean

testAssumptionFailure

public void testAssumptionFailure ( TestDescription testId, 
                String trace)

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

参量
testId TestDescription :标识测试

trace String :失败的堆栈跟踪

testEnded

public void testEnded ( TestDescription testId, 
                long endTime, 
                 metrics)

ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map))替代方法,我们可以直接指定结束时间。与testStarted(com.android.tradefed.result.TestDescription, long)组合以进行精确测量。

参量
testId TestDescription :标识测试

endTime long :测试结束的时间,通过System.currentTimeMillis()测量

metrics :发出的指标的ERROR(/Map)

testEnded

public void testEnded ( TestDescription testId, 
                 metrics)

报告单个测试用例的执行结束。

如果未调用testFailed(TestDescription, String) ,则此测试通过。还返回在测试用例执行期间可能发出的任何键/值度量。

参量
testId TestDescription :标识测试

metrics :发出的指标的ERROR(/Map)

测试失败

public void testFailed ( TestDescription testId, 
                String reason)

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

将在testStarted和testEnded之间调用。

参量
testId TestDescription :标识测试

reason String :失败的堆栈跟踪

testIgnored

public void testIgnored ( TestDescription testId)

在测试将不运行时调用,通常是因为测试方法用org.junit.Ignore注释。

参量
testId TestDescription :标识测试

测试日志

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

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

必须在ITestInvocationListener#invocationFailed(Throwable)ITestInvocationListener#invocationEnded(long)

TradeFederation框架将自动调用此方法,并提供主机日志和设备logcat(如果适用)。

参量
dataName String :数据的String描述性名称。例如“ device_logcat”。注意dataName每次调用可能不是唯一的。即实现者必须能够处理具有相同dataName的多个调用

dataType LogDataType :数据的LogDataType

dataStream InputStreamSource :数据的InputStreamSource 。实现者应调用createInputStream开始读取数据,并确保在完成后关闭生成的InputStream。调用者应确保在testLog方法完成之前,数据源一直存在并且可访问。

testModuleEnded

public void testModuleEnded ()

报告模块运行结束。

testModuleStarted

public void testModuleStarted ( IInvocationContext moduleContext)

报告模块运行的开始。该回调与testModuleEnded()相关联,并且在序列中是可选的。它仅在使用以下模块的运行中使用:基于ITestSuite的运行器。

参量
moduleContext IInvocationContext :模块的IInvocationContext

testRunEnded

public void testRunEnded (long time, 
                 runMetrics)

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

参量
time long :设备报告的经过时间,以毫秒为单位

runMetrics :在使用Metric的测试运行结束时报告的键值对。

testRunFailed

public void testRunFailed (String reason)

由于出现致命错误,报告测试运行未能完成。

参量
reason String :描述运行失败原因的String

testRunStarted

public void testRunStarted (String runName, 
                int testCount, 
                int attemptNumber)

报告测试运行的开始。

参量
runName String :测试运行名称

testCount int :测试运行中的测试总数

attemptNumber int :订单号,标识同一runName多次运行的不同尝试。 tryNumber的索引为0,每次发生新的运行都应增加。例如,一个测试被细粒度地重试了3次,在相同的runName下应该总共进行4次运行,而tryNumber为0到3。

testRunStarted

public void testRunStarted (String runName, 
                int testCount)

报告测试运行的开始。

参量
runName String :测试运行名称

testCount int :测试运行中的测试总数

testRunStopped

public void testRunStopped (long arg0)

报告测试运行由于用户请求而在完成之前停止。

待办事项:目前未使用,请考虑删除

参量
arg0 long :设备报告的经过时间,以毫秒为单位

testStarted

public void testStarted ( TestDescription testId, 
                long startTime)

替代testStarted(com.android.tradefed.result.TestDescription)地方,我们还指定何时开始测试,并与ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,Map))以进行精确测量。

参量
testId TestDescription :标识测试

startTime long :测试开始的时间,通过System.currentTimeMillis()测量

testStarted

public void testStarted ( TestDescription testId)

报告单个测试用例的开始。较旧的界面,应尽可能使用testStarted(com.android.tradefed.result.TestDescription)

参量
testId TestDescription :标识测试