主机测试

public class HostTest
extends Object implements IDeviceTest , ITestFilterReceiver , ITestAnnotationFilterReceiver , IRemoteTest , ITestCollector , IBuildReceiver , IAbiReceiver , IShardableTest , IRuntimeHintProvider , IConfigurationReceiver

java.lang.Object
com.android.tradefed.testtype.HostTest


基于 JUnit 主机的测试的测试运行器。如果要运行的测试实现了IDeviceTest则此运行器将传递对设备的引用。

概括

领域

public static final String SET_OPTION_DESC

public static final String SET_OPTION_NAME

公共构造函数

HostTest ()

公共方法

void addAllExcludeAnnotation ( notAnnotations) addAllExcludeAnnotation ( notAnnotations)

添加一个ERROR(/Set)注释以排除是否测试是否用它标记。

void addAllExcludeFilters ( filters) addAllExcludeFilters ( filters)

添加要排除的测试的过滤器的ERROR(/Set)

void addAllIncludeAnnotation ( annotations) addAllIncludeAnnotation ( annotations)

添加一个ERROR(/Set)注释以包含是否测试是否用它标记。

void addAllIncludeFilters ( filters) addAllIncludeFilters ( filters)

添加要包含哪些测试的过滤器的ERROR(/Set)

void addExcludeAnnotation (String notAnnotation)

添加注释以排除是否测试是否用它标记。

void addExcludeFilter (String filter)

添加要排除哪些测试的过滤器。

void addIncludeAnnotation (String annotation)

添加一个注释以包含如果一个测试是否用它标记。

void addIncludeFilter (String filter)

添加要包含哪些测试的过滤器。

void clearExcludeAnnotations ()

删除当前跟踪的所有排除注释。

void clearExcludeFilters ()

删除当前跟踪的所有排除过滤器。

void clearIncludeAnnotations ()

删除当前跟踪的所有包含注释。

void clearIncludeFilters ()

删除当前跟踪的所有包含过滤器。

int countTestCases ()

返回测试的所有类部分的测试用例数

IAbi getAbi ()

getClassNames ()
ITestDevice getDevice ()

获取待测设备。

getExcludeAnnotations ()

返回要排除的注释的当前ERROR(/Set)

getExcludeFilters ()

返回排除过滤器的当前ERROR(/Set)

getIncludeAnnotations ()

返回要包含的注释的当前ERROR(/Set)

getIncludeFilters ()

返回包含过滤器的当前ERROR(/Set)

long getRuntimeHint ()

以毫秒为单位返回测试的预期运行时间。

void run ( TestInformation testInfo, ITestInvocationListener listener)

运行测试,并将结果报告给侦听器。

void setAbi ( IAbi abi)

void setBuild ( IBuildInfo buildInfo)

void setCollectTestsOnly (boolean shouldCollectTest)

启用或禁用测试收集模式

void setConfiguration ( IConfiguration configuration)

注入正在使用的IConfiguration

void setDevice ( ITestDevice device)

注入被测设备。

static void setOptionToLoadedObject (Object testObj, keyValueOptions) setOptionToLoadedObject (Object testObj, keyValueOptions)

Device Runners 的帮助程序,用于以与 HostTest 相同的方式从 set-option 设置选项。

void setTestInformation ( TestInformation testInfo)
split (Integer shardCount, TestInformation testInfo)

我们按测试类或方法按个人划分。

受保护的方法

HostTest createHostTest (Class<?> classObj)

分片时创建 HostTest 实例的助手。

IBuildInfo getBuild ()

获取 HostTest 收到的构建信息。

ClassLoader getClassLoader ()

返回默认的类加载器。

final getClasses ()
File getJarFile (String jarName, TestInformation testInfo)

检查工件通常位于不同用例的几个位置以找到我们的 jar。

boolean hasJUnit4Annotation (Class<?> classObj)

帮助确定我们是否正在处理带有 Junit4 注释的测试类。

Object loadObject (Class<?> classObj)

加载类对象并设置测试信息(设备、构建)。

void setClassName (String className)

清除然后设置要运行的类名。

boolean shouldTestRun (AnnotatedElement annotatedElement)

检查具有注释的元素是否通过过滤器。

领域

SET_OPTION_DESC

public static final String SET_OPTION_DESC

SET_OPTION_NAME

public static final String SET_OPTION_NAME

公共构造函数

主机测试

public HostTest ()

公共方法

添加所有排除注释

public void addAllExcludeAnnotation ( notAnnotations)

添加一个ERROR(/Set)注释以排除是否测试是否用它标记。

参数
notAnnotations

添加所有排除过滤器

public void addAllExcludeFilters ( filters)

添加要排除的测试的过滤器的ERROR(/Set)

参数
filters

addAllIncludeAnnotation

public void addAllIncludeAnnotation ( annotations)

添加一个ERROR(/Set)注释以包含是否测试是否用它标记。

参数
annotations

添加所有包含过滤器

public void addAllIncludeFilters ( filters)

添加要包含哪些测试的过滤器的ERROR(/Set)

参数
filters

添加排除注解

public void addExcludeAnnotation (String notAnnotation)

添加注释以排除是否测试是否用它标记。

参数
notAnnotation String

添加排除过滤器

public void addExcludeFilter (String filter)

添加要排除哪些测试的过滤器。

参数
filter String

添加包含注解

public void addIncludeAnnotation (String annotation)

添加一个注释以包含如果一个测试是否用它标记。

参数
annotation String

添加包含过滤器

public void addIncludeFilter (String filter)

添加要包含哪些测试的过滤器。

参数
filter String

清除排除注解

public void clearExcludeAnnotations ()

删除当前跟踪的所有排除注释。

清除排除过滤器

public void clearExcludeFilters ()

删除当前跟踪的所有排除过滤器。

clearIncludeAnnotations

public void clearIncludeAnnotations ()

删除当前跟踪的所有包含注释。

清除包含过滤器

public void clearIncludeFilters ()

删除当前跟踪的所有包含过滤器。

计数测试用例

public int countTestCases ()

返回测试的所有类部分的测试用例数

退货
int

得到阿比

public IAbi getAbi ()

退货
IAbi

获取类名

public  getClassNames ()

退货

获取设备

public ITestDevice getDevice ()

获取待测设备。

退货
ITestDevice ITestDevice

getExcludeAnnotations

public  getExcludeAnnotations ()

返回要排除的注释的当前ERROR(/Set)

退货

获取排除过滤器

public  getExcludeFilters ()

返回排除过滤器的当前ERROR(/Set)

退货

getIncludeAnnotations

public  getIncludeAnnotations ()

返回要包含的注释的当前ERROR(/Set)

退货

getIncludeFilters

public  getIncludeFilters ()

返回包含过滤器的当前ERROR(/Set)

退货

获取运行时提示

public long getRuntimeHint ()

以毫秒为单位返回测试的预期运行时间。该时间用于负载平衡分片执行

退货
long

跑步

public void run (TestInformation testInfo, 
                ITestInvocationListener listener)

运行测试,并将结果报告给侦听器。

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

listener ITestInvocationListener : 测试结果的ITestInvocationListener

投掷
DeviceNotAvailableException

设置Abi

public void setAbi (IAbi abi)

参数
abi IAbi

设置构建

public void setBuild (IBuildInfo buildInfo)

参数
buildInfo IBuildInfo

setCollectTestsOnly

public void setCollectTestsOnly (boolean shouldCollectTest)

启用或禁用测试收集模式

设置配置

public void setConfiguration (IConfiguration configuration)

注入正在使用的IConfiguration

参数
configuration IConfiguration

设置设备

public void setDevice (ITestDevice device)

注入被测设备。

参数
device ITestDevice :要使用的ITestDevice

setOptionToLoadedObject

public static void setOptionToLoadedObject (Object testObj, 
                 keyValueOptions)

Device Runners 的帮助程序,用于以与 HostTest 相同的方式从 set-option 设置选项。

参数
testObj Object :将接收选项的对象。

keyValueOptions :格式为 HostTest set-option 要求的选项列表。

设置测试信息

public void setTestInformation (TestInformation testInfo)

参数
testInfo TestInformation

分裂

public  split (Integer shardCount, 
                TestInformation testInfo)

我们按测试类或方法按个人划分。

参数
shardCount Integer :尝试的分片数。

testInfo TestInformation :父TestInformation

退货
要单独执行的子测试的集合,如果测试当前不可分片则为null

受保护的方法

创建主机测试

protected HostTest createHostTest (Class<?> classObj)

分片时创建 HostTest 实例的助手。重写以从 HostTest 返回任何子项。

参数
classObj Class

退货
HostTest

获取构建

protected IBuildInfo getBuild ()

获取 HostTest 收到的构建信息。

退货
IBuildInfo IBuildInfo

获取类加载器

protected ClassLoader getClassLoader ()

返回默认的类加载器。

退货
ClassLoader

获取类

protected final  getClasses ()

退货

获取JarFile

protected File getJarFile (String jarName, 
                TestInformation testInfo)

检查工件通常位于不同用例的几个位置以找到我们的 jar。

参数
jarName String

testInfo TestInformation

退货
File

hasJUnit4注解

protected boolean hasJUnit4Annotation (Class<?> classObj)

帮助确定我们是否正在处理带有 Junit4 注释的测试类。

参数
classObj Class

退货
boolean

加载对象

protected Object loadObject (Class<?> classObj)

加载类对象并设置测试信息(设备、构建)。

参数
classObj Class

退货
Object

设置类名

protected void setClassName (String className)

清除然后设置要运行的类名。

参数
className String

应该测试运行

protected boolean shouldTestRun (AnnotatedElement annotatedElement)

检查具有注释的元素是否通过过滤器。公开进行单元测试。

退货
boolean如果不应运行测试,则为 false。