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

此页面由 Cloud Translation API 翻译。

TestMapping

public class TestMapping
extends Object

java.lang.Object
↳	com.android.tradefed.util.testmapping.TestMapping

用于加载 TEST_MAPPING 文件的类。

摘要

字段
`public static final Pattern`	`MAINLINE_REGEX`
`public static final String`	`TEST_SOURCES`

公共构造函数
`TestMapping(Path path, Path testMappingsDir)` 用于根据 TEST_MAPPING 文件的路径创建 `TestMapping` 对象的构造函数。

公共方法
`static File`	`extractTestMappingsZip(File testMappingsZip)` 解压缩 ZIP 文件，并返回包含解压缩文件内容的目录。
`static`	`getAllTests(File testMappingsDir)` 用于从给定目录中查找 TEST_MAPPING 文件中的所有测试的帮助程序。
`static Matcher`	`getMainlineTestModuleName(TestInfo info)` 用于获取参数化 Mainline 测试的匹配器的帮助程序。
	`getTests(String testGroup, disabledTests, boolean hostOnly, keywords)` 用于获取给定组在 TEST_MAPPING 文件中设置的所有测试的帮助程序。
`static`	`getTests(IBuildInfo buildInfo, String testGroup, boolean hostOnly, keywords)` 用于查找所有 TEST_MAPPING 文件中的所有测试的帮助程序。
`static void`	`listTestMappingFiles(Path testMappingDir, Path testMappingsRootDir, filePaths)` 用于列出所有测试映射文件、查找所有父目录和相关导入路径的帮助程序。
`static void`	`setIgnoreTestMappingImports(boolean ignoreTestMappingImports)` 在 TestMapping 中设置 mIgnoreTestMappingImports。
`static void`	`setTestMappingPaths( relativePaths)` 在 TEST_MAPPINGS_ZIP 中设置 TEST_MAPPING 路径，以限制加载 TEST_MAPPING。

public static final Pattern MAINLINE_REGEX

public static final String TEST_SOURCES

public TestMapping (Path path, 
                Path testMappingsDir)

用于根据 TEST_MAPPING 文件的路径创建 TestMapping 对象的构造函数。

参数
`path`	`Path`：TEST_MAPPING 文件的 `ERROR(/Path)`。
`testMappingsDir`	`Path`：指向 build 的所有 TEST_MAPPING 文件所在文件夹的 `ERROR(/Path)`。

public static File extractTestMappingsZip (File testMappingsZip)

解压缩 ZIP 文件，并返回包含解压缩文件内容的目录。

参数
`testMappingsZip`	`File`：要提取的测试映射 ZIP 文件的 `ERROR(/File)`。

返回
`File`	指向测试映射 ZIP 文件的临时目录的 `ERROR(/File)`。

public static  getAllTests (File testMappingsDir)

用于从指定目录中的 TEST_MAPPING 文件中查找所有测试的帮助程序。

参数
`testMappingsDir`	`File`：`ERROR(/File)` 是包含所有测试映射文件的目录。

返回
	指定目录及其子目录中的测试的 `Map<String, Set<TestInfo>>`。

public static Matcher getMainlineTestModuleName (TestInfo info)

用于获取参数化 Mainline 测试的匹配器的帮助程序。

参数
`info`	`TestInfo`

返回
`Matcher`	用于参数化 Mainline 测试的 `ERROR(/Matcher)`。

抛出
`ConfigurationException`

public  getTests (String testGroup, 
                 disabledTests, 
                boolean hostOnly, 
                 keywords)

用于获取给定组在 TEST_MAPPING 文件中设置的所有测试的帮助程序。

参数
`testGroup`	`String`：测试组的 `String`。
`disabledTests`	：一组 `String`，用于表示已停用的测试的名称。
`hostOnly`	`boolean`：如果仅应返回在主机上运行且不需要设备的测试，则为 true；如果应返回需要设备才能运行的测试，则为 false。
`keywords`	：过滤要在测试映射套件中运行的测试时要匹配的一组 `String`。

返回
	测试信息的 `Set<TestInfo>`。

public static  getTests (IBuildInfo buildInfo, 
                String testGroup, 
                boolean hostOnly, 
                 keywords)

用于查找所有 TEST_MAPPING 文件中的所有测试的帮助程序。当套件运行需要针对给定组（例如提交前）运行 TEST_MAPPING 文件中的所有测试时，就需要执行此操作。

参数
`buildInfo`	`IBuildInfo`：用于描述 build 的 `IBuildInfo`。
`testGroup`	`String`：测试组的 `String`。
`hostOnly`	`boolean`：如果仅应返回在主机上运行且不需要设备的测试，则为 true；如果应返回需要设备才能运行的测试，则为 false。
`keywords`

返回
	在 build 工件 test_mappings.zip 中设置的测试的 `Set<TestInfo>`。

public static void listTestMappingFiles (Path testMappingDir, 
                Path testMappingsRootDir, 
                 filePaths)

用于列出所有测试映射文件、查找所有父目录和相关导入路径的帮助程序。

参数
`testMappingDir`	`Path`：TEST_MAPPING 文件父目录的 `ERROR(/Path)`。
`testMappingsRootDir`	`Path`：指向 build 的所有 TEST_MAPPING 文件所在文件夹的 `ERROR(/Path)`。
`filePaths`	：用于存储所有 TEST_MAPPING 路径的 `ERROR(/Set)`。

public static void setIgnoreTestMappingImports (boolean ignoreTestMappingImports)

在 TestMapping 中设置 mIgnoreTestMappingImports。

参数
`ignoreTestMappingImports`	`boolean`：一个布尔值，表示是否要忽略测试映射中的导入。

public static void setTestMappingPaths ( relativePaths)

在 TEST_MAPPINGS_ZIP 中设置 TEST_MAPPING 路径，以限制加载 TEST_MAPPING。

参数
`relativePaths`	：相对于 TEST_MAPPINGS_ZIP 的 TEST_MAPPING 路径的 `List<String>`。