此页面由 Cloud Translation API 翻译。

HostTest

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

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

已知的直接子类

JarHostTest

JarHostTest 用于主机端 JUnit 测试的测试运行程序。

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

摘要

字段
`public static final String`	`SET_OPTION_DESC`
`public static final String`	`SET_OPTION_NAME`

公共构造函数
`HostTest()`

公共方法
`void`	`addAllExcludeAnnotation( notAnnotations)` 添加了注解的 `ERROR(/Set)`，以便在标记测试时排除该注解。
`void`	`addAllExcludeFilters( filters)` 添加要排除的测试的 `ERROR(/Set)`。
`void`	`addAllIncludeAnnotation( annotations)` 添加注解的 `ERROR(/Set)`，如果标记有测试，则要包含的注解。
`void`	`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()` 删除当前跟踪的所有 include 注解。
`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)` 供设备运行程序使用的辅助程序，用于按照与 HostTest 相同的方式从 set-option 设置选项。
`void`	`setTestInformation(TestInformation testInfo)`
	`split(Integer shardCount, TestInformation testInfo)` 我们按测试类或方法按个体拆分。

受保护的方法
`HostTest`	`createHostTest(Class<?> classObj)` 用于在分片时创建 HostTest 实例的帮助程序。
`IBuildInfo`	`getBuild()` 获取 HostTest 收到的 build 信息。
`ClassLoader`	`getClassLoader()` 返回默认的类加载器。
`final`	`getClasses()`
`File`	`getJarFile(String jarName, TestInformation testInfo)` 针对不同的用例检查工件通常位于的多个位置，找到我们的罐子
`boolean`	`hasJUnit4Annotation(Class<?> classObj)` 帮助确定我们是否正在处理带有 Junit4 注解的 Test 类。
`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

公共构造函数

HostTest

public HostTest ()

公共方法

addAllExcludeAnnotation

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`

addExcludeAnnotation

public void addExcludeAnnotation (String notAnnotation)

添加一个注解，如果标记有测试，则要排除该注解。

参数
`notAnnotation`	`String`

addExcludeFilter

public void addExcludeFilter (String filter)

添加要排除的测试的过滤条件。

参数
`filter`	`String`

addIncludeAnnotation

public void addIncludeAnnotation (String annotation)

添加一个注解，如果标记有测试，则要包含该注解。

参数
`annotation`	`String`

addIncludeFilter

public void addIncludeFilter (String filter)

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

参数
`filter`	`String`

clearExcludeAnnotations

public void clearExcludeAnnotations ()

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

ClearExcludeFilters

public void clearExcludeFilters ()

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

clearIncludeAnnotations

public void clearIncludeAnnotations ()

删除当前跟踪的所有 include 注解。

clearIncludeFilters

public void clearIncludeFilters ()

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

countTestCases

public int countTestCases ()

返回测试中所有类的测试用例数量

返回
`int`

getAbi

public IAbi getAbi ()

返回
`IAbi`

getClassNames

public  getClassNames ()

返回

getDevice

public ITestDevice getDevice ()

获取被测设备。

返回
`ITestDevice`	`ITestDevice`

getExcludeAnnotations

public  getExcludeAnnotations ()

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

返回

getExcludeFilters

public  getExcludeFilters ()

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

返回

getIncludeAnnotations

public  getIncludeAnnotations ()

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

返回

getIncludeFilters

public  getIncludeFilters ()

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

返回

getRuntimeHint

public long getRuntimeHint ()

在毫秒。该时间用于对分片执行进行负载均衡

返回
`long`

得分

public void run (TestInformation testInfo, 
                ITestInvocationListener listener)

运行测试，并将结果报告给监听器。

参数
`testInfo`	`TestInformation`：包含要运行的有用信息的 `TestInformation` 对象测试。
`listener`	`ITestInvocationListener`：测试结果的 `ITestInvocationListener`

抛出
`DeviceNotAvailableException`

SetAbi

public void setAbi (IAbi abi)

参数
`abi`	`IAbi`

setBuild

public void setBuild (IBuildInfo buildInfo)

参数
`buildInfo`	`IBuildInfo`

setCollectTestsOnly

public void setCollectTestsOnly (boolean shouldCollectTest)

启用或停用测试收集模式

setConfiguration

public void setConfiguration (IConfiguration configuration)

注入正在使用的 IConfiguration。

参数
`configuration`	`IConfiguration`

setDevice

public void setDevice (ITestDevice device)

注入被测设备。

参数
`device`	`ITestDevice`：要使用的 `ITestDevice`

setOptionToLoadedObject

public static void setOptionToLoadedObject (Object testObj, 
                 keyValueOptions)

供设备运行程序使用的辅助程序，用于按照与 HostTest 相同的方式从 set-option 设置选项。

参数
`testObj`	`Object`：将接收选项的对象。
`keyValueOptions`	：格式设置为 HostTest set-option 的选项列表。

setTestInformation

public void setTestInformation (TestInformation testInfo)

参数
`testInfo`	`TestInformation`

分割

public  split (Integer shardCount, 
                TestInformation testInfo)

我们按测试类或方法按个体拆分。

参数
`shardCount`	`Integer`：尝试的分片数。
`testInfo`	`TestInformation`：父级 `TestInformation`

返回
	要单独执行的子测试集合，或者`null`如果测试目前不可分片

受保护的方法

createHostTest

protected HostTest createHostTest (Class<?> classObj)

用于在分片时创建 HostTest 实例的帮助程序。替换以返回任何子项 HostTest。

参数
`classObj`	`Class`

返回
`HostTest`

getBuild

protected IBuildInfo getBuild ()

获取 HostTest 收到的 build 信息。

返回
`IBuildInfo`	`IBuildInfo`

getClassLoader

protected ClassLoader getClassLoader ()

返回默认的类加载器。

返回
`ClassLoader`

getClasses

protected final  getClasses ()

返回

getJarFile

protected File getJarFile (String jarName, 
                TestInformation testInfo)

针对不同的用例检查工件通常位于的多个位置，找到我们的罐子

参数
`jarName`	`String`
`testInfo`	`TestInformation`

返回
`File`

hasJUnit4Annotation

protected boolean hasJUnit4Annotation (Class<?> classObj)

帮助确定我们是否正在处理带有 Junit4 注解的 Test 类。

参数
`classObj`	`Class`

返回
`boolean`

loadObject

protected Object loadObject (Class<?> classObj)

加载类对象并设置测试信息（设备、版本）。

参数
`classObj`	`Class`

返回
`Object`

setClassName

protected void setClassName (String className)

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

参数
`className`	`String`

shouldTestRun

protected boolean shouldTestRun (AnnotatedElement annotatedElement)

检查带有注解的元素是否通过了过滤器。公开用于单元测试。

返回
`boolean`	如果不应运行测试，则为 false。