此页面由 Cloud Translation API 翻译。

设备测试用例

public class DeviceTestCase
extends MetricTestCase implements IDeviceTest, IRemoteTest, ITestAnnotationFilterReceiver, ITestCollector, ITestFilterReceiver

java.lang.Object 中
↳	junit.framework.Assert
	↳	junit.framework.TestCase
		↳	com.android.tradefed.testtype.MetricTestCase
			↳	com.android.tradefed.testtype.DeviceTestCase

提供 IRemoteTest 和 IDeviceTest 服务的辅助 JUnit 测试用例。

如果您想实现遵循 JUnit 模式（定义测试）的测试，这将非常有用。并且仍然全面支持其他 tradefed 功能，例如 Option

摘要

字段
`protected`	`mExcludeAnnotation` 要运行的测试的排除注解
`protected`	`mExcludeFilters` 要运行的测试名称的排除过滤条件
`protected`	`mIncludeAnnotation` 要运行的测试的 include 注解
`protected`	`mIncludeFilters` 要运行的测试名称的包含过滤条件

公共构造函数
`DeviceTestCase()`
`DeviceTestCase(String name)`

公共方法
`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()`
`ITestDevice`	`getDevice()` 获取被测设备。
	`getExcludeAnnotations()` 返回要排除的注解的当前 `ERROR(/Set)`。
	`getExcludeFilters()` 返回排除过滤器的当前 `ERROR(/Set)`。
	`getIncludeAnnotations()` 返回要包含的注解的当前 `ERROR(/Set)`。
	`getIncludeFilters()` 返回包含过滤器的当前 `ERROR(/Set)`。
`void`	`run(TestResult result)` 如果要运行的测试方法为 null，则替换父方法以运行所有测试方法。
`void`	`run(TestInformation testInfo, ITestInvocationListener listener)` 运行测试，并将结果报告给监听器。
`void`	`setCollectTestsOnly(boolean shouldCollectTest)` 启用或停用测试收集模式
`void`	`setDevice(ITestDevice device)` 注入被测设备。

字段

mExcludeAnnotation

protected  mExcludeAnnotation

要运行的测试的排除注解

m 排除过滤器

protected  mExcludeFilters

要运行的测试名称的排除过滤条件

mIncludeAnnotation

protected  mIncludeAnnotation

要运行的测试的 include 注解

mInclude 过滤器

protected  mIncludeFilters

要运行的测试名称的包含过滤条件

公共构造函数

设备测试用例

public DeviceTestCase ()

设备测试用例

public DeviceTestCase (String name)

参数
`name`	`String`

公共方法

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`

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)。

返回

得分

public void run (TestResult result)

如果要运行的测试方法为 null，则替换父方法以运行所有测试方法。

JUnit 框架仅支持运行 TestCase 中的所有测试，方法是将其封装在 TestSuite。遗憾的是，使用此机制，调用方无法控制其生命周期自己的测试用例，因此无法完成使用 tradefed 配置等操作框架注入选项到测试用例中。

参数
`result`	`TestResult`

得分

public void run (TestInformation testInfo, 
                ITestInvocationListener listener)

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

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

抛出
`DeviceNotAvailableException`

setCollectTestsOnly

public void setCollectTestsOnly (boolean shouldCollectTest)

启用或停用测试收集模式

setDevice

public void setDevice (ITestDevice device)

注入被测设备。

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