此页面由 Cloud Translation API 翻译。

ExecutableBaseTest

public abstract class ExecutableBaseTest
extends Object implements IAbiReceiver, IConfigurationReceiver, IDiscoverDependencies, IRemoteTest, IRuntimeHintProvider, IShardableTest, ITestCollector, ITestFilterReceiver

java.lang.Object 中
↳	com.android.tradefed.testtype.binary.ExecutableBaseTest

已知的直接子类

ExecutableHostTest、ExecutableTargetTest

ExecutableHostTest	主机上运行的可执行文件的测试运行程序。
ExecutableTargetTest	在目标上运行的可执行文件的测试运行程序。

已知的间接子类

KUnitModuleTest、KernelTargetTest

KUnitModuleTest	用于在设备上运行 KUnit 测试模块的测试运行程序。
KernelTargetTest	在目标上运行且解析内核测试结果的可执行文件的测试运行程序。

可执行类型的测试的基类。例如：二进制文件、Shell 脚本。

摘要

字段
`public static final String`	`NO_BINARY_ERROR`

公共构造函数
`ExecutableBaseTest()`

公共方法
`void`	`addAllExcludeFilters( filters)` 添加要排除的测试的 `ERROR(/Set)`。
`void`	`addAllIncludeFilters( filters)` 添加要包含的测试的过滤器的 `ERROR(/Set)`。
`void`	`addExcludeFilter(String filter)` 添加要排除的测试的过滤条件。
`void`	`addIncludeFilter(String filter)` 添加要包含的测试的过滤器。
`void`	`clearExcludeFilters()` 删除当前跟踪的所有排除过滤器。
`void`	`clearIncludeFilters()` 删除当前跟踪的所有包含过滤器。
`abstract String`	`findBinary(String binary)` 搜索二进制文件以便能够运行它。
`IAbi`	`getAbi()`
`boolean`	`getCollectTestsOnly()`
	`getExcludeFilters()` 返回排除过滤器的当前 `ERROR(/Set)`。
	`getIncludeFilters()` 返回包含过滤器的当前 `ERROR(/Set)`。
`final long`	`getRuntimeHint()` 在毫秒。
	`reportDependencies()`
`void`	`run(TestInformation testInfo, ITestInvocationListener listener)` 运行测试，并将结果报告给监听器。
`abstract void`	`runBinary(String binaryPath, ITestInvocationListener listener, TestDescription description)` 实际上，在指定路径下运行该二进制文件。
`final void`	`setAbi(IAbi abi)`
`final void`	`setCollectTestsOnly(boolean shouldCollectTest)` 启用或停用测试收集模式
`void`	`setConfiguration(IConfiguration configuration)` 注入正在使用的 `IConfiguration`。
`final`	`split(int shardHint)` `split()` 的替代版本，该版本也提供尝试的 shardCount 运行状态。

受保护的方法
`boolean`	`doesRunBinaryGenerateTestResults()`
`IConfiguration`	`getConfiguration()` 返回测试配置。
`TestDescription[]`	`getFilterDescriptions( testCommands)`
`String`	`getModuleId(IInvocationContext context)`
`long`	`getTimeoutPerBinaryMs()`

字段

NO_BINARY_ERROR 错误

public static final String NO_BINARY_ERROR

公共构造函数

ExecutableBaseTest

public ExecutableBaseTest ()

公共方法

添加全部排除过滤器

public void addAllExcludeFilters ( filters)

添加要排除的测试的 ERROR(/Set)。

参数
`filters`

添加全部包含过滤器

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 ()

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

findBinary

public abstract String findBinary (String binary)

搜索二进制文件以便能够运行它。

参数
`binary`	`String`：二进制文件的路径或简称。

返回
`String`	二进制文件的路径；如果未找到，则返回 null。

抛出
`DeviceNotAvailableException`

getAbi

public IAbi getAbi ()

返回
`IAbi`

getCollectTestsOnly

public boolean getCollectTestsOnly ()

返回
`boolean`

getExcludeFilters

public  getExcludeFilters ()

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

返回

getIncludeFilters

public  getIncludeFilters ()

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

返回

getRuntimeHint

public final long getRuntimeHint ()

在毫秒。该时间用于对分片执行进行负载均衡

返回
`long`

reportDependencies（报告依赖项）

public  reportDependencies ()

返回

得分

public void run (TestInformation testInfo, 
                ITestInvocationListener listener)

运行测试，并将结果报告给监听器。

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

抛出
`DeviceNotAvailableException`

runBinary

public abstract void runBinary (String binaryPath, 
                ITestInvocationListener listener, 
                TestDescription description)

实际上，在指定路径下运行该二进制文件。

参数
`binaryPath`	`String`：二进制文件的路径。
`listener`	`ITestInvocationListener`：报告结果的位置的监听器。
`description`	`TestDescription`：正在进行的测试。

抛出
`DeviceNotAvailableException`

SetAbi

public final void setAbi (IAbi abi)

参数
`abi`	`IAbi`

setCollectTestsOnly

public final void setCollectTestsOnly (boolean shouldCollectTest)

启用或停用测试收集模式

setConfiguration

public void setConfiguration (IConfiguration configuration)

注入正在使用的 IConfiguration。

参数
`configuration`	`IConfiguration`

分割

public final  split (int shardHint)

split() 的替代版本，该版本也提供尝试的 shardCount 运行状态。这对于某些有时无法随意决定的测试运行程序非常有用。

参数
`shardHint`	`int`：尝试的分片数。

返回
	要单独执行的子测试集合，或者`null`如果测试目前不可分片

受保护的方法

doRunBinaryGenerateTestResults

protected boolean doesRunBinaryGenerateTestResults ()

返回
`boolean`

getConfiguration

protected IConfiguration getConfiguration ()

返回测试配置。

返回
`IConfiguration`	IConfiguration

getFilterDescriptions

protected TestDescription[] getFilterDescriptions ( testCommands)

参数
`testCommands`

返回
`TestDescription[]`

获取模块 ID

protected String getModuleId (IInvocationContext context)

参数
`context`	`IInvocationContext`

返回
`String`

getTimeoutPerBinaryMs

protected long getTimeoutPerBinaryMs ()

返回
`long`	为每个二进制文件应用的执行超时设置。