BugreportCollector

public class BugreportCollector
extends Object implements ITestInvocationListener

java.lang.Object 中
   ↳ com.android.tradefed.result.BugreportCollector

一个传递 ITestInvocationListener，用于在可配置事件时收集 bug 报告 发生，然后在每次发生后对其子级调用 ITestInvocationListener#testLog 收集错误报告

行为：（FIXME：完成此项）

  • 在每次测试用例失败时捕获
  • 在每个测试用例之后进行捕获
  • 在每个测试失败的测试用例后进行捕获
  • 截图/录像

摘要

嵌套类

enum BugreportCollector.Filter

 

enum BugreportCollector.Freq

 

enum BugreportCollector.Noun

 

class BugreportCollector.Predicate

描述何时捕获 bug 报告的完整谓词。 

enum BugreportCollector.Relation

 

interface BugreportCollector.SubPredicate

 

字段

public static final BugreportCollector.Predicate AFTER_FAILED_TESTCASES

在每个失败测试用例后触发的预定义谓词

public static final BugreportCollector.Predicate AT_START

首次调用开始时触发的预定义谓词

公共构造函数

BugreportCollector(ITestInvocationListener listener, ITestDevice testDevice)

公共方法

void addPredicate(BugreportCollector.Predicate p)
void blockUntilIdle()

阻止，直到收集器未收集任何 bug 报告为止。

TestSummary getSummary()

void invocationEnded(long elapsedTime)

void invocationFailed(Throwable cause)

void invocationStarted(IInvocationContext context)

void setAsynchronous(boolean asynchronous)

设置 bugreport 收集是否应在其他线程中收集 bug 报告 (asynchronous = true)，或屏蔽调用方，直到捕获 bug 报告为止 （asynchronous = false）。

void setDescriptiveName(String name)

设置在记录 bug 报告时使用的描述性名称。

void setDeviceWaitTime(int waitTime)

设置在我们尝试捕获设备之前，等待设备变为在线状态的时间（以秒为单位） bug 报告。

void testAssumptionFailure(TestDescription test, String trace)

void testEnded(TestDescription test, testMetrics)
void testFailed(TestDescription test, String trace)

void testIgnored(TestDescription test)
void testLog(String dataName, LogDataType dataType, InputStreamSource dataStream)

void testRunEnded(long elapsedTime, runMetrics)

void testRunFailed(String errorMessage)

void testRunStarted(String runName, int testCount)

void testRunStopped(long elapsedTime)

void testStarted(TestDescription test)

字段

之后_FAILED_TESTCASES

public static final BugreportCollector.Predicate AFTER_FAILED_TESTCASES

在每个失败测试用例后触发的预定义谓词

AT_START

public static final BugreportCollector.Predicate AT_START

首次调用开始时触发的预定义谓词

公共构造函数

BugreportCollector

public BugreportCollector (ITestInvocationListener listener, 
                ITestDevice testDevice)

参数
listener ITestInvocationListener

testDevice ITestDevice

公共方法

addPredicate

public void addPredicate (BugreportCollector.Predicate p)

参数
p BugreportCollector.Predicate

blockUntilIdle

public void blockUntilIdle ()

阻止，直到收集器未收集任何 bug 报告为止。如果收集器未主动 收集错误报告，立即返回

getSummary

public TestSummary getSummary ()

返回
TestSummary

invocationEnded

public void invocationEnded (long elapsedTime)

参数
elapsedTime long

invocationFailed

public void invocationFailed (Throwable cause)

参数
cause Throwable

invocationStarted

public void invocationStarted (IInvocationContext context)

参数
context IInvocationContext

set 异步

public void setAsynchronous (boolean asynchronous)

设置 bugreport 收集是否应在其他线程中收集 bug 报告 (asynchronous = true)，或屏蔽调用方，直到捕获 bug 报告为止 （asynchronous = false）。

参数
asynchronous boolean

setDescriptiveName

public void setDescriptiveName (String name)

设置在记录 bug 报告时使用的描述性名称。如果为 null， BugreportCollector 将回退到对 导致收集错误报告的事件。

参数
name String

setDeviceWaitTime

public void setDeviceWaitTime (int waitTime)

设置在我们尝试捕获设备之前，等待设备变为在线状态的时间（以秒为单位） bug 报告。如果值为负数，则不执行检查。任何DeviceNotAvailableException 将记录并忽略。

参数
waitTime int

testAssumptionFailure

public void testAssumptionFailure (TestDescription test, 
                String trace)

参数
test TestDescription

trace String

testEnded

public void testEnded (TestDescription test, 
                 testMetrics)

参数
test TestDescription

testMetrics

测试失败

public void testFailed (TestDescription test, 
                String trace)

参数
test TestDescription

trace String

testIgnored

public void testIgnored (TestDescription test)

参数
test TestDescription

testLog

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

参数
dataName String

dataType LogDataType

dataStream InputStreamSource

testRunEnded

public void testRunEnded (long elapsedTime, 
                 runMetrics)

参数
elapsedTime long

runMetrics

testRunFailed

public void testRunFailed (String errorMessage)

参数
errorMessage String

testRunStarted

public void testRunStarted (String runName, 
                int testCount)

参数
runName String

testCount int

testRunStopped

public void testRunStopped (long elapsedTime)

参数
elapsedTime long

testStarted

public void testStarted (TestDescription test)

参数
test TestDescription