粒度可重试测试包装器

public class GranularRetriableTestWrapper
extends Object implements IRemoteTest , ITestCollector

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

包装类在IRemoteTest上工作，以在测试用例级别对 IRemoteTest 进行粒度化。一个 IRemoteTest 可以包含多个测试用例。以前，这些测试用例被视为一个整体：当 IRemoteTest 运行时，所有测试用例都会运行。一些 IRemoteTest（实现 ITestFilterReceiver 的那些）可以接受测试用例的白名单并且只运行那些测试用例。此类利用现有功能并提供更灵活的方式来运行测试套件。

  • 可以多次重试单个测试用例（在同一次 IRemoteTest 运行中）以降低非测试错误失败率。
  • 重试的测试用例是从以前的运行失败中动态收集的。

笔记：

  • 运行测试用例子集的先决条件是测试类型应实现ITestFilterReceiver接口。
  • X 是自定义的最大重试次数。

概括

嵌套类

class GranularRetriableTestWrapper.StartEndCollector

捕捉缺失的运行开始和结束的类助手。

公共构造函数

GranularRetriableTestWrapper ( IRemoteTest test, ITestInvocationListener mainListener, TestFailureListener failureListener, moduleLevelListeners, int maxRunLimit) GranularRetriableTestWrapper ( IRemoteTest test, ITestInvocationListener mainListener, TestFailureListener failureListener, moduleLevelListeners, int maxRunLimit)
GranularRetriableTestWrapper ( IRemoteTest test, ModuleDefinition module, ITestInvocationListener mainListener, TestFailureListener failureListener, moduleLevelListeners, int maxRunLimit) GranularRetriableTestWrapper ( IRemoteTest test, ModuleDefinition module, ITestInvocationListener mainListener, TestFailureListener failureListener, moduleLevelListeners, int maxRunLimit)

公共方法

final int getExpectedTestsCount ()

计算IRemoteTest中的测试用例数。

final getFinalTestRunResults ()

从每个IRemoteTest运行中获取合并的 TestRunResults。

final getPassedTests ()
ModuleListener getResultListener ()

返回包含所有结果的侦听器。

int getRetryCount ()
void run ( TestInformation testInfo, ITestInvocationListener listener)

安排一系列IRemoteTest#run(TestInformation, ITestInvocationListener) 。

void setCollectTestsOnly (boolean shouldCollectTest)

启用或禁用测试收集模式

void setInvocationContext ( IInvocationContext moduleInvocationContext)

将IInvocationContext设置为GranularRetriableTestWrapper属性。

void setLogSaver ( ILogSaver logSaver)

将模块的ILogSaver设置为GranularRetriableTestWrapper属性。

void setMarkTestsSkipped (boolean skipTestCases)

将ModuleDefinition RunStrategy 设置为GranularRetriableTestWrapper属性。

void setMetricCollectors ( runMetricCollectors) setMetricCollectors ( runMetricCollectors)

将ModuleDefinition的 runMetricCollector 设置为GranularRetriableTestWrapper属性。

void setModuleConfig ( IConfiguration moduleConfiguration)

将ModuleDefinition的 ModuleConfig 设置为GranularRetriableTestWrapper属性。

void setModuleId (String moduleId)

将ModuleDefinition名称设置为GranularRetriableTestWrapper属性。

void setRetryDecision ( IRetryDecision decision)

设置要使用的IRetryDecision 。

公共构造函数

粒度可重试测试包装器

public GranularRetriableTestWrapper (IRemoteTest test, 
                ITestInvocationListener mainListener, 
                TestFailureListener failureListener, 
                 moduleLevelListeners, 
                int maxRunLimit)

参数
test IRemoteTest

mainListener ITestInvocationListener

failureListener TestFailureListener

moduleLevelListeners

maxRunLimit int

粒度可重试测试包装器

public GranularRetriableTestWrapper (IRemoteTest test, 
                ModuleDefinition module, 
                ITestInvocationListener mainListener, 
                TestFailureListener failureListener, 
                 moduleLevelListeners, 
                int maxRunLimit)

参数
test IRemoteTest

module ModuleDefinition

mainListener ITestInvocationListener

failureListener TestFailureListener

moduleLevelListeners

maxRunLimit int

公共方法

getExpectedTestsCount

public final int getExpectedTestsCount ()

计算IRemoteTest中的测试用例数。该值区分多次重新安排的相同测试用例。

退货
int

获取最终测试运行结果

public final  getFinalTestRunResults ()

从每个IRemoteTest运行中获取合并的 TestRunResults。

退货

获得通过测试

public final  getPassedTests ()

退货

获取结果监听器

public ModuleListener getResultListener ()

返回包含所有结果的侦听器。

退货
ModuleListener

获取重试次数

public int getRetryCount ()

退货
int

跑步

public void run (TestInformation testInfo, 
                ITestInvocationListener listener)

安排一系列IRemoteTest#run(TestInformation, ITestInvocationListener) 。

参数
testInfo TestInformation ：包含运行测试的有用信息的TestInformation对象。

listener ITestInvocationListener ：ResultForwarder 侦听器，其中包含每次运行的新 moduleListener。

投掷
DeviceNotAvailableException

setCollectTestsOnly

public void setCollectTestsOnly (boolean shouldCollectTest)

启用或禁用测试收集模式

设置调用上下文

public void setInvocationContext (IInvocationContext moduleInvocationContext)

将IInvocationContext设置为GranularRetriableTestWrapper属性。

参数
moduleInvocationContext IInvocationContext ：包装器在必要时使用 InvocationContext 来初始化 MetricCollector。

设置日志保存器

public void setLogSaver (ILogSaver logSaver)

将模块的ILogSaver设置为GranularRetriableTestWrapper属性。

参数
logSaver ILogSaver ：每次测试运行的监听器都应该保存日志。

setMarkTestsSkipped

public void setMarkTestsSkipped (boolean skipTestCases)

将ModuleDefinition RunStrategy 设置为GranularRetriableTestWrapper属性。

参数
skipTestCases boolean : 是否应该跳过测试用例。

setMetricCollectors

public void setMetricCollectors ( runMetricCollectors)

将ModuleDefinition的 runMetricCollector 设置为GranularRetriableTestWrapper属性。

参数
runMetricCollectors ：模块的 MetricCollector 列表。

设置模块配置

public void setModuleConfig (IConfiguration moduleConfiguration)

将ModuleDefinition的 ModuleConfig 设置为GranularRetriableTestWrapper属性。

参数
moduleConfiguration IConfiguration ：提供模块指标。

设置模块Id

public void setModuleId (String moduleId)

将ModuleDefinition名称设置为GranularRetriableTestWrapper属性。

参数
moduleId String ：模块定义的名称。

设置重试决定

public void setRetryDecision (IRetryDecision decision)

设置要使用的IRetryDecision 。

参数
decision IRetryDecision