BaseTestSuite

public class BaseTestSuite
extends ITestSuite

java.lang.Object
↳	com.android.tradefed.testtype.suite.ITestSuite
	↳	com.android.tradefed.testtype.suite.BaseTestSuite

已知的直接子类 AtestRunner、TestMappingSuiteRunner AtestRunner ITestSuite 的实现  TestMappingSuiteRunner 实现 BaseTestSuite 以运行由选项 include-filter 指定的测试，或运行 build 中的 TEST_MAPPING 文件（作为套件）。

---

用于使用新套件系统运行兼容性测试套件的测试。

摘要

常量
String	CONFIG_PATTERNS_OPTION
String	EXCLUDE_FILTER_OPTION
String	INCLUDE_FILTER_OPTION
String	MODULE_OPTION
char	MODULE_OPTION_SHORT_NAME
String	TEST_ARG_OPTION
String	TEST_OPTION
char	TEST_OPTION_SHORT_NAME

公共构造函数
BaseTestSuite()

公共方法
void	addConfigPatterns( patterns) 添加配置模式
void	addModuleArgs( moduleArgs) 添加模块实参
void	cleanUpSuiteSetup() 有机会清理在套件设置期间需要但运行测试不需要的所有内容。
void	clearExcludeFilter()
void	clearIncludeFilter()
SuiteModuleLoader	createModuleLoader( includeFiltersFormatted, excludeFiltersFormatted, testArgs, moduleArgs) 创建负责加载 IConfiguration 并为其分配一些选项的 SuiteModuleLoader。
	getExcludeFilter() 获取兼容性测试的排除项过滤条件的副本
	getIncludeFilter() 获取兼容性测试的包含项过滤条件的副本
SuiteModuleLoader	getModuleLoader() 返回当前 SuiteModuleLoader。
String	getRunSuiteTag()
	loadTests() 用于加载将要运行的测试配置的抽象方法。
	loadingStrategy( abis, testsDirs, String suitePrefix, String suiteTag) 默认加载策略将从资源和测试目录加载。
void	reevaluateFilters()
boolean	reverseExcludeFilters()
void	setBuild(IBuildInfo buildInfo)
void	setEnableOptionalParameterizedModules(boolean enableOptionalParameter) 设置是否启用可选的参数化模块。
void	setEnableParameterizedModules(boolean enableParameter) 设置是否启用参数化模块。
void	setExcludeFilter( excludeFilters) 为兼容性测试设置排除过滤器
void	setIncludeFilter( includeFilters) 为兼容性测试设置 include-filters
void	setModuleParameter(ModuleParameters forceParameter)
void	setSkipjarLoading(boolean skipJarLoading)

受保护的方法
	getFoldableStates(ITestDevice device)
void	setupFilters(File testsDir) 根据是否指定了模块名称来设置包含/排除过滤条件。
boolean	shouldModuleRun(ModuleDefinition module)

常量

CONFIG_PATTERNS_OPTION

public static final String CONFIG_PATTERNS_OPTION

常量值： "config-patterns"

EXCLUDE_FILTER_OPTION

public static final String EXCLUDE_FILTER_OPTION

常量值： "exclude-filter"

INCLUDE_FILTER_OPTION

public static final String INCLUDE_FILTER_OPTION

常量值： “include-filter”

MODULE_OPTION

public static final String MODULE_OPTION

常量值： "module"

MODULE_OPTION_SHORT_NAME

public static final char MODULE_OPTION_SHORT_NAME

常量值： 109 (0x0000006d)

TEST_ARG_OPTION

public static final String TEST_ARG_OPTION

常量值： "test-arg"

TEST_OPTION

public static final String TEST_OPTION

常量值： “test”

TEST_OPTION_SHORT_NAME

public static final char TEST_OPTION_SHORT_NAME

常量值： 116 (0x00000074)

公共构造函数

BaseTestSuite

public BaseTestSuite ()

公共方法

addConfigPatterns

public void addConfigPatterns ( patterns)

添加配置模式

参数
patterns

addModuleArgs

public void addModuleArgs ( moduleArgs)

添加了模块实参

参数
moduleArgs

cleanUpSuiteSetup

public void cleanUpSuiteSetup ()

有机会清理在套件设置期间需要但运行测试不需要的所有内容。

clearExcludeFilter

public void clearExcludeFilter ()

clearIncludeFilter

public void clearIncludeFilter ()

createModuleLoader

public SuiteModuleLoader createModuleLoader ( includeFiltersFormatted, 
                 excludeFiltersFormatted, 
                 testArgs, 
                 moduleArgs)

创建负责加载 IConfiguration 并为其分配部分选项的 SuiteModuleLoader。

参数
includeFiltersFormatted	：格式化和解析后的包含过滤条件。
excludeFiltersFormatted	：已设置格式并已解析的排除过滤条件。
testArgs	：测试 (IRemoteTest) 实参的列表。
moduleArgs	：模块实参的列表。

返回
SuiteModuleLoader	已创建的 SuiteModuleLoader。

getExcludeFilter

public  getExcludeFilter ()

获取兼容性测试的排除项过滤条件的副本

返回

getIncludeFilter

public  getIncludeFilter ()

获取兼容性测试的 include-filters 的副本

返回

getModuleLoader

public SuiteModuleLoader getModuleLoader ()

返回当前的 SuiteModuleLoader。

返回
SuiteModuleLoader

getRunSuiteTag

public String getRunSuiteTag ()

返回
String

loadTests

public  loadTests ()

用于加载将要运行的测试配置的抽象方法。每项测试都由一个 IConfiguration 和一个唯一名称定义，测试结果将通过该名称进行报告。

返回

loadingStrategy

public  loadingStrategy ( abis, 
                 testsDirs, 
                String suitePrefix, 
                String suiteTag)

默认加载策略将从资源和测试目录加载。可以延长或更换。

参数
abis	：要运行的 ABI 集。
testsDirs	：测试目录。
suitePrefix	String：用于过滤资源目录的前缀。
suiteTag	String：模块应具有的 suite 标记才能被纳入。可以为 null。

返回
	测试套件的已加载配置列表。

reevaluateFilters

public void reevaluateFilters ()

reverseExcludeFilters

public boolean reverseExcludeFilters ()

返回
boolean

setBuild

public void setBuild (IBuildInfo buildInfo)

参数
buildInfo	IBuildInfo

setEnableOptionalParameterizedModules

public void setEnableOptionalParameterizedModules (boolean enableOptionalParameter)

设置是否启用可选的参数化模块。

参数
enableOptionalParameter	boolean

setEnableParameterizedModules

public void setEnableParameterizedModules (boolean enableParameter)

设置是否启用参数化模块。

参数
enableParameter	boolean

setExcludeFilter

public void setExcludeFilter ( excludeFilters)

为兼容性测试设置排除过滤器

参数
excludeFilters

setIncludeFilter

public void setIncludeFilter ( includeFilters)

为兼容性测试设置了 include-filter

参数
includeFilters

setModuleParameter

public void setModuleParameter (ModuleParameters forceParameter)

参数
forceParameter	ModuleParameters

setSkipjarLoading

public void setSkipjarLoading (boolean skipJarLoading)

参数
skipJarLoading	boolean

受保护的方法

getFoldableStates

protected  getFoldableStates (ITestDevice device)

参数
device	ITestDevice

返回

抛出
DeviceNotAvailableException

setupFilters

protected void setupFilters (File testsDir)

根据是否提供了模块名称来设置包含/排除过滤条件。

参数
testsDir	File

抛出
	如果找不到任何文件。

shouldModuleRun

protected boolean shouldModuleRun (ModuleDefinition module)

参数
module	ModuleDefinition

返回
boolean