自 2025 年 3 月 27 日起，我们建议您使用 android-latest-release 而非 aosp-main 构建 AOSP 并为其做出贡献。如需了解详情，请参阅 AOSP 的变更。

此页面由 Cloud Translation API 翻译。

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 文件指定的测试作为套件运行。

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

摘要

常量
`char`	`MODULE_OPTION_SHORT_NAME`
`char`	`TEST_OPTION_SHORT_NAME`

字段
`public static final String`	`CONFIG_PATTERNS_OPTION`
`public static final String`	`EXCLUDE_FILTER_OPTION`
`public static final String`	`INCLUDE_FILTER_OPTION`
`public static final String`	`MODULE_OPTION`
`public static final String`	`TEST_ARG_OPTION`
`public static final String`	`TEST_OPTION`

公共构造函数
`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)` 默认加载策略将从 resources 和 tests 目录加载。
`void`	`reevaluateFilters()`
`boolean`	`reverseExcludeFilters()`
`void`	`setBuild(IBuildInfo buildInfo)`
`void`	`setEnableOptionalParameterizedModules(boolean enableOptionalParameter)` 设置是否启用可选的参数化模块。
`void`	`setEnableParameterizedModules(boolean enableParameter)` 设置是否启用参数化模块。
`void`	`setExcludeFilter( excludeFilters)` 为兼容性测试设置排除过滤条件
`void`	`setIncludeFilter( includeFilters)` 为兼容性测试设置 include 过滤条件
`void`	`setModuleParameter(ModuleParameters forceParameter)`
`void`	`setSkipjarLoading(boolean skipJarLoading)`

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

常量

MODULE_OPTION_SHORT_NAME

public static final char MODULE_OPTION_SHORT_NAME

常量值： 109 (0x0000006d)

TEST_OPTION_SHORT_NAME

public static final char TEST_OPTION_SHORT_NAME

常量值： 116 (0x00000074)

字段

CONFIG_PATTERNS_OPTION

public static final String CONFIG_PATTERNS_OPTION

EXCLUDE_FILTER_OPTION

public static final String EXCLUDE_FILTER_OPTION

INCLUDE_FILTER_OPTION

public static final String INCLUDE_FILTER_OPTION

MODULE_OPTION

public static final String MODULE_OPTION

TEST_ARG_OPTION

public static final String TEST_ARG_OPTION

TEST_OPTION

public static final String TEST_OPTION

公共构造函数

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

获取兼容性测试的包含过滤条件的副本

返回

getModuleLoader

public SuiteModuleLoader getModuleLoader ()

返回当前的 SuiteModuleLoader。

返回
`SuiteModuleLoader`

getRunSuiteTag

public String getRunSuiteTag ()

返回
`String`

loadTests

public  loadTests ()

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

返回

loadingStrategy

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

默认加载策略将从 resources 和 tests 目录加载。可以延期或替换。

参数
`abis`	：要针对其运行的 ABI 集。
`testsDirs`	：测试目录。
`suitePrefix`	`String`：用于过滤资源目录的前缀。
`suiteTag`	`String`：模块必须包含的套件标记。可以为 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 过滤条件

参数
`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`