ArtRunTest

public class ArtRunTest
extends Object implements IAbiReceiver, IConfigurationReceiver, IRemoteTest, ITestCollector, ITestFilterReceiver

java.lang.Object
↳	com.android.tradefed.testtype.ArtRunTest

---

用于运行 ART 运行测试的测试运行程序。

摘要

嵌套类
class	ArtRunTest.AdbShellCommandException 用于报告在执行 ADB SHELL 命令期间发生的错误的异常类。

字段
public static final String	CHECKER_PAR_FILENAME

公共构造函数
ArtRunTest()

公共方法
void	addAllExcludeFilters( filters) 添加了要排除的测试的过滤条件的 ERROR(/Set)。
void	addAllIncludeFilters( filters) 添加要包含的测试的过滤条件的 ERROR(/Set)。
void	addExcludeFilter(String filter) 添加了用于过滤要排除的测试的过滤条件。
void	addIncludeFilter(String filter) 添加了用于过滤要包含的测试的过滤条件。
void	clearExcludeFilters() 删除当前跟踪的所有排除过滤条件。
void	clearIncludeFilters() 删除当前跟踪的所有包含过滤器。
IAbi	getAbi()
	getExcludeFilters() 返回排除过滤条件的当前 ERROR(/Set)。
	getIncludeFilters() 返回包含过滤条件的当前 ERROR(/Set)。
void	run(TestInformation testInfo, ITestInvocationListener listener) 运行测试并向监听器报告结果。
void	setAbi(IAbi abi)
void	setCollectTestsOnly(boolean shouldCollectTest) 启用或停用测试收集模式
void	setConfiguration(IConfiguration configuration) 注入正在使用的 IConfiguration。

受保护的方法
	checkExitCode(Integer exitCode) 检查测试命令返回的退出代码。
	checkTestOutput(TestInformation testInfo, String actualOutputText, String outputShortName, String outputPrettyName) 检查测试命令生成的输出。
File	createTestLocalTempDirectory(TestInformation testInfo) 在测试的依赖项文件夹中创建一个本地临时目录，以收集从被测设备拉取的测试输出。
	executeCheckerTest(TestInformation testInfo, ITestInvocationListener listener) 执行检查器测试并检查其输出。
void	extractSourcesFromJar(File tmpCheckerLocalDir, File jar) 将 src 目录从给定 jar 文件解压缩到给定目录。
File	getCheckerBinaryPath(TestInformation testInfo) 找到 Checker 二进制文件（Python 归档文件）。
	runChecker(String[] checkerCommandLine) 运行检查器命令并检查其结果。

字段

CHECKER_PAR_FILENAME

public static final String CHECKER_PAR_FILENAME

公共构造函数

ArtRunTest

public ArtRunTest ()

公共方法

addAllExcludeFilters

public void addAllExcludeFilters ( filters)

添加了要排除的测试的过滤条件的 ERROR(/Set)。

参数
filters

addAllIncludeFilters

public void addAllIncludeFilters ( filters)

添加了要包含的测试的过滤条件的 ERROR(/Set)。

参数
filters

addExcludeFilter

public void addExcludeFilter (String filter)

添加要排除的测试的过滤条件。

参数
filter	String

addIncludeFilter

public void addIncludeFilter (String filter)

添加要包含的测试的过滤器。

参数
filter	String

clearExcludeFilters

public void clearExcludeFilters ()

删除当前跟踪的所有排除过滤器。

clearIncludeFilters

public void clearIncludeFilters ()

删除当前跟踪的所有包含过滤条件。

getAbi

public IAbi getAbi ()

返回
IAbi

getExcludeFilters

public  getExcludeFilters ()

返回排除过滤条件的当前 ERROR(/Set)。

返回

getIncludeFilters

public  getIncludeFilters ()

返回包含过滤器的当前 ERROR(/Set)。

返回

得分

public void run (TestInformation testInfo, 
                ITestInvocationListener listener)

运行测试并向监听器报告结果。

参数
testInfo	TestInformation：包含运行测试的实用信息的 TestInformation 对象。
listener	ITestInvocationListener：测试结果的 ITestInvocationListener

抛出
DeviceNotAvailableException

setAbi

public void setAbi (IAbi abi)

参数
abi	IAbi

setCollectTestsOnly

public void setCollectTestsOnly (boolean shouldCollectTest)

启用或停用测试收集模式

setConfiguration

public void setConfiguration (IConfiguration configuration)

注入正在使用的 IConfiguration。

参数
configuration	IConfiguration

受保护的方法

checkExitCode

protected  checkExitCode (Integer exitCode)

检查测试命令返回的退出代码。

参数
exitCode	Integer：测试命令返回的退出代码

返回
	可选的错误消息，如果测试退出代码表示成功，则为空

checkTestOutput

protected  checkTestOutput (TestInformation testInfo, 
                String actualOutputText, 
                String outputShortName, 
                String outputPrettyName)

检查测试命令生成的输出。

用于检查测试的标准输出和标准错误。

参数
testInfo	TestInformation：与已执行测试关联的 TestInformation 对象
actualOutputText	String：测试生成的输出
outputShortName	String：输出渠道的短名称
outputPrettyName	String：输出渠道的更美观名称，用于错误消息中

返回
	可选的错误消息，如果所检查的输出有效，则为空

createTestLocalTempDirectory

protected File createTestLocalTempDirectory (TestInformation testInfo)

在测试的依赖项文件夹中创建一个本地临时目录，以收集从被测设备中提取的测试输出。

参数
testInfo	TestInformation：与已执行测试关联的 TestInformation 对象

返回
File	指向创建的临时目录的 ERROR(/File) 对象。

抛出
	如果临时目录创建失败。

executeCheckerTest

protected  executeCheckerTest (TestInformation testInfo, 
                ITestInvocationListener listener)

执行 Checker 测试并检查其输出。

检查工具测试是一些 ART 运行测试中包含的额外测试，以注解形式编写在测试源文件的注释中，用于验证 ART 的编译器。

参数
testInfo	TestInformation：与已执行测试关联的 TestInformation 对象
listener	ITestInvocationListener：与已执行测试关联的 ITestInvocationListener 对象

返回
	可选的错误消息，如果检查工具测试成功，则为空

抛出
ArtRunTest.AdbShellCommandException
DeviceNotAvailableException

extractSourcesFromJar

protected void extractSourcesFromJar (File tmpCheckerLocalDir, 
                File jar)

将给定 jar 文件中的 src 目录提取到给定目录。

参数
tmpCheckerLocalDir	File
jar	File

getCheckerBinaryPath

protected File getCheckerBinaryPath (TestInformation testInfo)

找到 Checker 二进制文件（Python 归档）。

参数
testInfo	TestInformation

返回
File

runChecker

protected  runChecker (String[] checkerCommandLine)

运行 Checker 命令并检查其结果。

参数
checkerCommandLine	String：要执行的检查器命令行

返回
	可选的错误消息，如果 Checker 调用成功，则为空