调用执行

public class InvocationExecution
extends Object implements IInvocationExecution

java.lang.Object
↳	com.android.tradefed.invoker.InvocationExecution

已知的直接子类

ParentSandboxInvocationExecution ， RemoteInvocationExecution ， SandboxedInvocationExecution

ParentSandboxInvocationExecution	运行沙箱时用于父调用特殊操作的`InvocationExecution`版本。
远程调用执行	驱动远程执行的`InvocationExecution`实现。
沙盒调用执行	调用的特殊沙箱执行：这是当我们在运行命令的沙箱中时的InvocationExection。

描述所有调用步骤的类：构建下载，target_prep，运行测试，清理。可以扩展以覆盖某些步骤的默认行为。步骤的顺序由TestInvocation驱动。

摘要

领域
`public static final String`	`ADB_VERSION_KEY`

公共建设者
`InvocationExecution ()`

公开方法
`void`	`cleanUpBuilds ( IInvocationContext context, IConfiguration config)` 执行build_provider清理步骤。
`void`	`doCleanUp ( IInvocationContext context, IConfiguration config, Throwable exception)` 执行target_preparer和multi_target_preparer cleanUp步骤。
`void`	`doSetup ( IInvocationContext context, IConfiguration config, ITestInvocationListener listener)` 执行target_preparer和multi_target_preparer setUp步骤。
`void`	`doTeardown ( IInvocationContext context, IConfiguration config, ITestLogger logger, Throwable exception)` 执行target_preparer和multi_target_preparer拆卸步骤。
`boolean`	`fetchBuild ( IInvocationContext context, IConfiguration config, IRescheduler rescheduler, ITestInvocationListener listener)` 执行调用的build_provider步骤。
`void`	`reportLogs ( ITestDevice device, ITestInvocationListener listener, TestInvocation.Stage stage)` 在调用的不同阶段报告一些设备日志。
`boolean`	`resetBuildAndReschedule (Throwable exception, ITestInvocationListener listener, IConfiguration config, IInvocationContext context)` 报告调用失败。
`final void`	`runDevicePostInvocationTearDown ( IInvocationContext context, IConfiguration config)` 为调用的每个设备部分调用`ITestDevice#postInvocationTearDown()` 。
`final void`	`runDevicePreInvocationSetup ( IInvocationContext context, IConfiguration config, ITestLogger logger)` 为调用的每个设备部分调用`ITestDevice#preInvocationSetup(IBuildInfo)` 。
`void`	`runTests ( IInvocationContext context, IConfiguration config, ITestInvocationListener listener)` 运行测试。
`boolean`	`shardConfig ( IConfiguration config, IInvocationContext context, IRescheduler rescheduler)` 尝试将配置分片为子配置，以将其重新安排为在多个资源上并行运行。

受保护的方法
`IShardHelper`	`createShardHelper ()` 创建一个返回`IShardHelper`以使用`IShardHelper` 。
`String`	`getAdbVersion ()` 返回用于调用的adb版本。
`void`	`setTestTag ( IBuildInfo info, IConfiguration config)` 处理在构建信息上设置测试标签的问题。

领域

ADB_VERSION_KEY

public static final String ADB_VERSION_KEY

公共建设者

调用执行

public InvocationExecution ()

公开方法

cleanUpBuilds

public void cleanUpBuilds ( IInvocationContext context, 
                IConfiguration config)

执行build_provider清理步骤。与构建获取相关联。

参量
`context`	`IInvocationContext` ：调用的`IInvocationContext` 。
`config`	`IConfiguration` ：此测试运行的`IConfiguration` 。

doCleanUp

public void doCleanUp ( IInvocationContext context, 
                IConfiguration config, 
                Throwable exception)

执行target_preparer和multi_target_preparer cleanUp步骤。设备是否清理干净。

参量
`context`	`IInvocationContext` ：调用的`IInvocationContext` 。
`config`	`IConfiguration` ：此测试运行的`IConfiguration` 。
`exception`	`Throwable` ：测试运行时抛出的原始异常。

doSetup

public void doSetup ( IInvocationContext context, 
                IConfiguration config, 
                ITestInvocationListener listener)

执行target_preparer和multi_target_preparer setUp步骤。是否运行测试所需的所有设备设置。

参量
`context`	`IInvocationContext` ：调用的`IInvocationContext` 。
`config`	`IConfiguration` ：此测试运行的`IConfiguration` 。
`listener`	`ITestInvocationListener` ： `ITestInvocation`报告安装失败。

投掷
`BuildError`
`DeviceNotAvailableException`
`TargetSetupError`

doTeardown

public void doTeardown ( IInvocationContext context, 
                IConfiguration config, 
                ITestLogger logger, 
                Throwable exception)

执行target_preparer和multi_target_preparer拆卸步骤。设备是否与设置相关联地拆除。

参量
`context`	`IInvocationContext` ：调用的`IInvocationContext` 。
`config`	`IConfiguration` ：此测试运行的`IConfiguration` 。
`logger`	`ITestLogger` ： `ITestLogger`报告日志。
`exception`	`Throwable` ：测试运行时抛出的原始异常。

fetchBuild

public boolean fetchBuild ( IInvocationContext context, 
                IConfiguration config, 
                IRescheduler rescheduler, 
                ITestInvocationListener listener)

执行调用的build_provider步骤。

参量
`context`	`IInvocationContext` ：调用的`IInvocationContext` 。
`config`	`IConfiguration` ：此测试运行的`IConfiguration` 。
`rescheduler`	`IRescheduler` ： `IRescheduler` ，用于重新安排部分调用以在另一个资源上执行
`listener`	`ITestInvocationListener` ： `ITestInvocation`报告构建下载失败。

退货
`boolean`	如果我们成功下载了构建，则为true，否则为false。

投掷
`BuildRetrievalError`
`DeviceNotAvailableException`

reportLogs

public void reportLogs ( ITestDevice device, 
                ITestInvocationListener listener, 
                TestInvocation.Stage stage)

在调用的不同阶段报告一些设备日志。例如：logcat。

参量
`device`	`ITestDevice` ：用于报告日志的设备。
`listener`	`ITestInvocationListener` ：日志的记录器。
`stage`	`TestInvocation.Stage` ：我们所处的调用阶段。

resetBuildAndReschedule

public boolean resetBuildAndReschedule (Throwable exception, 
                ITestInvocationListener listener, 
                IConfiguration config, 
                IInvocationContext context)

报告调用失败。

参量
`exception`	`Throwable` ：应报告的异常。
`listener`	`ITestInvocationListener` ：调用侦听器。
`config`	`IConfiguration` ：当前正在运行的配置。
`context`	`IInvocationContext` ：调用的`IInvocationContext` 。

退货
`boolean`	如果应重新安排配置，则为True，否则为False。

runDevicePostInvocationTearDown

public final void runDevicePostInvocationTearDown ( IInvocationContext context, 
                IConfiguration config)

为调用的每个设备部分调用ITestDevice#postInvocationTearDown() 。

参量
`context`	`IInvocationContext` ：调用的`IInvocationContext` 。
`config`	`IConfiguration` ：此测试运行的`IConfiguration` 。

runDevicePreInvocationSetup

public final void runDevicePreInvocationSetup ( IInvocationContext context, 
                IConfiguration config, 
                ITestLogger logger)

为调用的每个设备部分调用ITestDevice#preInvocationSetup(IBuildInfo) 。

参量
`context`	`IInvocationContext` ：调用的`IInvocationContext` 。
`config`	`IConfiguration` ：此测试运行的`IConfiguration` 。
`logger`	`ITestLogger` ： `ITestLogger`报告日志。

投掷
`DeviceNotAvailableException`
`TargetSetupError`

运行测试

public void runTests ( IInvocationContext context, 
                IConfiguration config, 
                ITestInvocationListener listener)

运行测试。

参量
`context`	`IInvocationContext` ：要在`IInvocationContext`上运行测试的`IInvocationContext`
`config`	`IConfiguration` ：要运行的`IConfiguration`
`listener`	`ITestInvocationListener` ：测试结果的`ITestInvocationListener`

shardConfig

public boolean shardConfig ( IConfiguration config, 
                IInvocationContext context, 
                IRescheduler rescheduler)

尝试将配置分片为子配置，以将其重新安排为在多个资源上并行运行。

如果分片计数大于1，它将通过设置分片索引并重新计划它们，简单地为每个分片创建配置。如果未设置分片计数，它将回IShardHelper#shardConfig 。

参量
`config`	`IConfiguration` ：当前的`IConfiguration` 。
`context`	`IInvocationContext` ：保存测试信息的`IInvocationContext` 。
`rescheduler`	`IRescheduler` ： `IRescheduler`

退货
`boolean`	如果测试已分片，则为true。否则返回`false`

受保护的方法

createShardHelper

protected IShardHelper createShardHelper ()

创建一个返回IShardHelper以使用IShardHelper 。

退货
`IShardHelper`

getAdbVersion

protected String getAdbVersion ()

返回用于调用的adb版本。

退货
`String`

setTestTag

protected void setTestTag ( IBuildInfo info, 
                IConfiguration config)

处理在构建信息上设置测试标签的问题。

参量
`info`	`IBuildInfo`
`config`	`IConfiguration`