自 2026 年起，为了与我们的主干稳定开发模型保持一致，并确保生态系统的平台稳定性，我们将在第 2 季度和第 4 季度向 AOSP 发布源代码。如需构建 AOSP 并为其贡献代码，请使用 android-latest-release。android-latest-release 清单分支将始终引用推送到 AOSP 的最新版本。如需了解详情，请参阅 AOSP 变更。

Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

SuiteModuleLoader

public class SuiteModuleLoader
extends Object

java.lang.Object
↳	com.android.tradefed.testtype.suite.SuiteModuleLoader

从代码库中检索兼容性测试模块定义。待办事项：在加载模块时添加了套件的扩展。

摘要

嵌套类
`class`	`SuiteModuleLoader.ConfigFilter` 一个 `FilenameFilter`，用于查找目录中的所有配置文件。

常量
`String`	`CONFIG_EXT`

公共构造函数
`SuiteModuleLoader(Map<String, LinkedHashSet<SuiteTestFilter>> includeFilters, Map<String, LinkedHashSet<SuiteTestFilter>> excludeFilters, List<String> testArgs, List<String> moduleArgs)` SuiteModuleLoader 的构造函数。

公共方法
`static void`	`addFilters(Set<String> stringFilters, Map<String, LinkedHashSet<SuiteTestFilter>> filters, Set<IAbi> abis, Set<DeviceFoldableState> foldableStates)` 一种实用方法，可用于解析和创建具有选项过滤条件的结构。
`void`	`addFiltersToTest(IRemoteTest test, IAbi abi, String moduleId, Map<String, LinkedHashSet<SuiteTestFilter>> includeFilters, Map<String, LinkedHashSet<SuiteTestFilter>> excludeFilters)` 将过滤条件传递给 `IRemoteTest`。
`static Set<File>`	`getModuleNamesMatching(File directory, String suitePrefix, String pattern)`
`LinkedHashMap<String, IConfiguration>`	`loadConfigsFromDirectory(List<File> testsDirs, Set<IAbi> abis, String suitePrefix, String suiteTag, List<String> patterns)` 配置的主要加载，查看文件夹
`LinkedHashMap<String, IConfiguration>`	`loadConfigsFromJars(Set<IAbi> abis, String suitePrefix, String suiteTag)` 配置的主要加载，查看类路径上的资源。
`LinkedHashMap<String, IConfiguration>`	`loadConfigsFromSpecifiedPaths(List<File> listConfigFiles, Set<IAbi> abis, String suiteTag)` 配置的主要加载，查看指定的文件
`LinkedHashMap<String, IConfiguration>`	`loadTfConfigsFromSpecifiedPaths(List<String> configs, Set<IAbi> abis, String suiteTag)` 配置的主要加载，查看类路径上的指定资源。
`final void`	`setExcludedModuleParameters(Set<ModuleParameters> excludedParams)` 设置不应考虑的 `ModuleParameters` 集。
`final void`	`setFoldableStates(Set<DeviceFoldableState> foldableStates)` 设置应运行的 `DeviceFoldableState` 集。
`final void`	`setIgnoreNonPreloadedMainlineModule(boolean ignore)` 设置是否忽略安装未预加载的模块。
`final void`	`setInvocationContext(IInvocationContext context)`
`final void`	`setLoadConfigsWithIncludeFilters(boolean allowed)` 设置是否根据给定的包含过滤条件加载测试配置。
`final void`	`setMainlineParameterizedModules(boolean allowed)` 设置是否允许使用参数化 Mainline 模块。
`final void`	`setModuleParameter(ModuleParameters param)` 设置应运行的唯一 `ModuleParameters` 类型。
`final void`	`setOptimizeMainlineTest(boolean allowed)` 设置是否优化 Mainline 测试。
`final void`	`setOptionalParameterizedModules(boolean allowed)` 设置是否允许使用可选的参数化模块。
`final void`	`setParameterizedModules(boolean allowed)` 设置是否允许使用参数化模块。
`final void`	`setUseIncludeFilterOrder(boolean useIncludeFilterOrder)` 设置是否按 include 过滤条件中指定的顺序组织测试作业。

常量

CONFIG_EXT

public static final String CONFIG_EXT

常量值： ".config"

公共构造函数

SuiteModuleLoader

public SuiteModuleLoader (Map<String, LinkedHashSet<SuiteTestFilter>> includeFilters, 
                Map<String, LinkedHashSet<SuiteTestFilter>> excludeFilters, 
                List<String> testArgs, 
                List<String> moduleArgs)

SuiteModuleLoader 的构造函数。

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

公共方法

addFilters

public static void addFilters (Set<String> stringFilters, 
                Map<String, LinkedHashSet<SuiteTestFilter>> filters, 
                Set<IAbi> abis, 
                Set<DeviceFoldableState> foldableStates)

一种实用方法，可用于解析和创建具有选项过滤条件的结构。

参数
`stringFilters`	`Set`：原始选项过滤条件格式。
`filters`	`Map`：从字符串格式解析的过滤条件。
`abis`	`Set`：过滤时要考虑的 ABI。
`foldableStates`	`Set`

addFiltersToTest

public void addFiltersToTest (IRemoteTest test, 
                IAbi abi, 
                String moduleId, 
                Map<String, LinkedHashSet<SuiteTestFilter>> includeFilters, 
                Map<String, LinkedHashSet<SuiteTestFilter>> excludeFilters)

将过滤条件传递给 IRemoteTest。如果 IRemoteTest 未实现 ITestFileFilterReceiver，则默认行为是忽略。可以替换此值以创建限制性更强的行为。

参数
`test`	`IRemoteTest`：正在考虑的 `IRemoteTest`。
`abi`	`IAbi`：我们目前正在处理的 ABI。
`moduleId`	`String`：模块的 ID（通常为 ABI + 模块名称）。
`includeFilters`	`Map`：格式化和解析后的包含过滤条件。
`excludeFilters`	`Map`：已设置格式并已解析的排除过滤条件。

getModuleNamesMatching

public static Set<File> getModuleNamesMatching (File directory, 
                String suitePrefix, 
                String pattern)

参数
`directory`	`File`
`suitePrefix`	`String`
`pattern`	`String`

返回
`Set<File>`	名称包含指定模式的模块的 `Set`。

loadConfigsFromDirectory

public LinkedHashMap<String, IConfiguration> loadConfigsFromDirectory (List<File> testsDirs, 
                Set<IAbi> abis, 
                String suitePrefix, 
                String suiteTag, 
                List<String> patterns)

配置的主要加载，查看文件夹

参数
`testsDirs`	`List`
`abis`	`Set`
`suitePrefix`	`String`
`suiteTag`	`String`
`patterns`	`List`

返回
`LinkedHashMap<String, IConfiguration>`

loadConfigsFromJars

public LinkedHashMap<String, IConfiguration> loadConfigsFromJars (Set<IAbi> abis, 
                String suitePrefix, 
                String suiteTag)

配置的主要加载，查看类路径上的资源。（示例的 TF 配置）。

参数
`abis`	`Set`
`suitePrefix`	`String`
`suiteTag`	`String`

返回
`LinkedHashMap<String, IConfiguration>`

loadConfigsFromSpecifiedPaths

public LinkedHashMap<String, IConfiguration> loadConfigsFromSpecifiedPaths (List<File> listConfigFiles, 
                Set<IAbi> abis, 
                String suiteTag)

配置的主要加载，查看指定的文件

参数
`listConfigFiles`	`List`
`abis`	`Set`
`suiteTag`	`String`

返回
`LinkedHashMap<String, IConfiguration>`

loadTfConfigsFromSpecifiedPaths

public LinkedHashMap<String, IConfiguration> loadTfConfigsFromSpecifiedPaths (List<String> configs, 
                Set<IAbi> abis, 
                String suiteTag)

配置的主要加载，查看类路径上的指定资源。

参数
`configs`	`List`
`abis`	`Set`
`suiteTag`	`String`

返回
`LinkedHashMap<String, IConfiguration>`

setExcludedModuleParameters

public final void setExcludedModuleParameters (Set<ModuleParameters> excludedParams)

设置不应考虑的 ModuleParameters 集。

参数
`excludedParams`	`Set`

setFoldableStates

public final void setFoldableStates (Set<DeviceFoldableState> foldableStates)

设置应运行的 DeviceFoldableState 集。

参数
`foldableStates`	`Set`

setIgnoreNonPreloadedMainlineModule

public final void setIgnoreNonPreloadedMainlineModule (boolean ignore)

设置是否忽略安装未预加载的模块。

参数
`ignore`	`boolean`

setInvocationContext

public final void setInvocationContext (IInvocationContext context)

参数
`context`	`IInvocationContext`

setLoadConfigsWithIncludeFilters

public final void setLoadConfigsWithIncludeFilters (boolean allowed)

设置是否根据给定的包含过滤器加载测试配置。

参数
`allowed`	`boolean`

setMainlineParameterizedModules

public final void setMainlineParameterizedModules (boolean allowed)

设置是否允许使用参数化 Mainline 模块。

参数
`allowed`	`boolean`

setModuleParameter

public final void setModuleParameter (ModuleParameters param)

设置应运行的唯一 ModuleParameters 类型。

参数
`param`	`ModuleParameters`

setOptimizeMainlineTest

public final void setOptimizeMainlineTest (boolean allowed)

设置是否优化 Mainline 测试。

参数
`allowed`	`boolean`

setOptionalParameterizedModules

public final void setOptionalParameterizedModules (boolean allowed)

设置是否允许使用可选的参数化模块。

参数
`allowed`	`boolean`

setParameterizedModules

public final void setParameterizedModules (boolean allowed)

设置是否允许使用参数化模块。

参数
`allowed`	`boolean`

setUseIncludeFilterOrder

public final void setUseIncludeFilterOrder (boolean useIncludeFilterOrder)

设置是否按 include 过滤条件中指定的顺序来组织测试作业。

参数
`useIncludeFilterOrder`	`boolean`

SuiteModuleLoader

摘要

嵌套类

常量

公共构造函数

公共方法

常量

CONFIG_EXT

公共构造函数

SuiteModuleLoader

公共方法

addFilters

addFiltersToTest

getModuleNamesMatching

loadConfigsFromDirectory

loadConfigsFromJars

loadConfigsFromSpecifiedPaths

loadTfConfigsFromSpecifiedPaths

setExcludedModuleParameters

setFoldableStates

setIgnoreNonPreloadedMainlineModule

setInvocationContext

setLoadConfigsWithIncludeFilters

setMainlineParameterizedModules

setModuleParameter

setOptimizeMainlineTest

setOptionalParameterizedModules

setParameterizedModules

setUseIncludeFilterOrder