TestMapping

public class TestMapping
extends Object

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

用于加载 TEST_MAPPING 文件的类。

摘要

嵌套类

class TestMapping.NoTestRuntimeException

 

字段

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) 是包含所有测试映射文件的目录。
返回
指定目录及其子目录中的测试的 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：用于描述 build 的 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：用于描述 build 的 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)。