此页面由 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_MAPPINGS_ZIP`
`public static final String`	`TEST_SOURCES`

公共构造函数
`TestMapping()` 用于初始化空 `TestMapping` 对象的构造函数。
`TestMapping( testMappingRelativePaths, boolean ignoreTestMappingImports)` 用于创建 `TestMapping` 对象的构造函数。

公共方法
`static File`	`extractTestMappingsZip(File testMappingsZip)` 解压缩 ZIP 文件，并返回包含解压缩文件内容的目录。
	`getAllTests(File testMappingsDir)` 用于从给定目录中查找 TEST_MAPPING 文件中的所有测试的辅助程序。
`static Matcher`	`getMainlineTestModuleName(TestInfo info)` 用于获取参数化 Mainline 测试的匹配器的帮助程序。
	`getTests(IBuildInfo buildInfo, String testGroup, boolean hostOnly, keywords, ignoreKeywords)` 帮助基于设备 build 中的工件查找所有 TEST_MAPPING 文件中的所有测试。
	`getTests(IBuildInfo buildInfo, String testGroup, boolean hostOnly, keywords, ignoreKeywords, extraZipNames, matchedPatternPaths)` 用于根据给定工件在所有 TEST_MAPPING 文件中查找所有测试的帮助程序。
`void`	`listTestMappingFiles(Path testMappingDir, Path testMappingsRootDir, filePaths)` 用于列出所有测试映射文件、查找所有父目录和相关导入路径的帮助程序。

字段

MAINLINE_REGEX

public static final Pattern MAINLINE_REGEX

TEST_MAPPINGS_ZIP

public static final String TEST_MAPPINGS_ZIP

TEST_SOURCES

public static final String TEST_SOURCES

公共构造函数

TestMapping

public TestMapping ()

用于初始化空 TestMapping 对象的构造函数。

TestMapping

public TestMapping ( testMappingRelativePaths, 
                boolean ignoreTestMappingImports)

用于创建 TestMapping 对象的构造函数。

参数
`testMappingRelativePaths`	：指向 TEST_MAPPING 文件路径的 `ERROR(/List)`。
`ignoreTestMappingImports`	`boolean`：用于忽略导入的 `ERROR(/boolean)`。

公共方法

extractTestMappingsZip

public static File extractTestMappingsZip (File testMappingsZip)

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

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

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

getAllTests

public  getAllTests (File testMappingsDir)

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

参数
`testMappingsDir`	`File`：`ERROR(/File)` 是包含所有 Test Mapping 文件的目录。

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

getMainlineTestModuleName

public static Matcher getMainlineTestModuleName (TestInfo info)

帮助获取参数化 Mainline 测试的匹配器。

参数
`info`	`TestInfo`

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

抛出
`ConfigurationException`

getTests

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

用于根据设备 build 中的工件在所有 TEST_MAPPING 文件中查找所有测试的帮助程序。

参数
`buildInfo`	`IBuildInfo`：描述构建的 `IBuildInfo`。
`testGroup`	`String`：测试组的 `String`。
`hostOnly`	`boolean`：如果仅应返回在主机上运行且不需要设备的测试，则为 true；如果应返回需要设备才能运行的测试，则为 false。
`keywords`	：过滤要在测试映射套件中运行的测试时要匹配的一组 `String`。
`ignoreKeywords`	：一组要忽略的关键字 `String`。

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

getTests

public  getTests (IBuildInfo buildInfo, 
                String testGroup, 
                boolean hostOnly, 
                 keywords, 
                 ignoreKeywords, 
                 extraZipNames, 
                 matchedPatternPaths)

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

参数
`buildInfo`	`IBuildInfo`：描述构建的 `IBuildInfo`。
`testGroup`	`String`：测试组的 `String`。
`hostOnly`	`boolean`：如果仅应返回在主机上运行且不需要设备的测试，则为 true；如果应返回需要设备才能运行的测试，则为 false。
`keywords`	：过滤要在测试映射套件中运行的测试时要匹配的一组 `String`。
`ignoreKeywords`	：要忽略的一组 `String` 关键字。
`extraZipNames`	：一组 `String`，用于指定要合并的其他 test_mappings.zip 的名称。
`matchedPatternPaths`	：与文件路径匹配的 `ERROR(/Set)` 模式。

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

listTestMappingFiles

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