调用执行

public class InvocationExecution
extends Object implements IInvocationExecution

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

已知的直接子类

DelegatedInvocationExecution ， ParentSandboxInvocationExecution ， RemoteInvocationExecution ， SandboxedInvocationExecution

委托调用执行	`InvocationExecution` ，将执行委托给另一个Tradefed二进制文件。
ParentSandboxInvocationExecution	运行沙箱时用于父调用特殊操作的`InvocationExecution`版本。
远程调用执行	驱动远程执行的`InvocationExecution`实现。
沙盒调用执行	调用的特殊沙箱执行：这是当我们在运行命令的沙箱中时的InvocationExection。

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

概要

领域
`public static final String`	`ADB_VERSION_KEY`
`public static final String`	`JAVA_CLASSPATH_KEY`
`public static final String`	`JAVA_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 (TestInformation testInfo, IConfiguration config, ITestLogger listener)` 执行target_preparer和multi_target_preparer setUp步骤。
`void`	`doTeardown (TestInformation testInfo, IConfiguration config, ITestLogger logger, Throwable exception)` 执行target_preparer和multi_target_preparer拆卸步骤。
`boolean`	`fetchBuild (TestInformation testInfo, IConfiguration config, IRescheduler rescheduler, ITestInvocationListener listener)` 执行调用的build_provider步骤。
`void`	`reportLogs (ITestDevice device, ITestLogger listener, TestInvocation.Stage stage)` 在调用的不同阶段报告一些设备日志。
`final void`	`runDevicePostInvocationTearDown (IInvocationContext context, IConfiguration config, Throwable exception)` 为调用的每个设备部分调用`ITestDevice#postInvocationTearDown(Throwable)` 。
`final void`	`runDevicePreInvocationSetup (IInvocationContext context, IConfiguration config, ITestLogger logger)` 为调用的每个设备部分调用`ITestDevice#preInvocationSetup(IBuildInfo)` 。
`void`	`runTests (TestInformation info, IConfiguration config, ITestInvocationListener listener)` 运行测试。
`boolean`	`shardConfig ( IConfiguration config, TestInformation testInfo, IRescheduler rescheduler, ITestLogger logger)` 尝试将配置分片为子配置，以将其重新安排为在多个资源上并行运行。

受保护的方法
`IShardHelper`	`createShardHelper ()` 创建一个返回`IShardHelper`以使用`IShardHelper` 。
`void`	`customizeDevicePreInvocation ( IConfiguration config, IInvocationContext context)` 在preInvocationSetup之前，有机会自定义一些设备。
`String`	`getAdbVersion ()` 返回用于调用的adb版本。
`void`	`setTestTag (IBuildInfo info, IConfiguration config)` 处理在构建信息上设置测试标签的问题。

领域

ADB_VERSION_KEY

public static final String ADB_VERSION_KEY

JAVA_CLASSPATH_KEY

public static final String JAVA_CLASSPATH_KEY

JAVA_VERSION_KEY

public static final String JAVA_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 (TestInformation testInfo, 
                IConfiguration config, 
                ITestLogger listener)

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

参量
`testInfo`	`TestInformation` ：调用的`TestInformation` 。
`config`	`IConfiguration` ：此测试运行的`IConfiguration` 。
`listener`	`ITestLogger` ： `ITestLogger`报告安装失败日志。

投掷
`BuildError`
`DeviceNotAvailableException`
`TargetSetupError`

doTeardown

public void doTeardown (TestInformation testInfo, 
                IConfiguration config, 
                ITestLogger logger, 
                Throwable exception)

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

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

fetchBuild

public boolean fetchBuild (TestInformation testInfo, 
                IConfiguration config, 
                IRescheduler rescheduler, 
                ITestInvocationListener listener)

执行调用的build_provider步骤。

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

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

投掷
`BuildRetrievalError`
`DeviceNotAvailableException`

reportLogs

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

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

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

runDevicePostInvocationTearDown

public final void runDevicePostInvocationTearDown (IInvocationContext context, 
                IConfiguration config, 
                Throwable exception)

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

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

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 (TestInformation info, 
                IConfiguration config, 
                ITestInvocationListener listener)

运行测试。

参量
`info`	`TestInformation` ：用于运行测试的`TestInformation` 。
`config`	`IConfiguration` ：要运行的`IConfiguration`
`listener`	`ITestInvocationListener` ：测试结果的`ITestInvocationListener`

shardConfig

public boolean shardConfig (IConfiguration config, 
                TestInformation testInfo, 
                IRescheduler rescheduler, 
                ITestLogger logger)

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

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

参量
`config`	`IConfiguration` ：当前的`IConfiguration` 。
`testInfo`	`TestInformation` ：保存测试信息的`TestInformation` 。
`rescheduler`	`IRescheduler` ： `IRescheduler` 。
`logger`	`ITestLogger` ： `ITestLogger`用于在分片期间记录文件。

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

受保护的方法

createShardHelper

protected IShardHelper createShardHelper ()

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

退货
`IShardHelper`

customDevicePreInvocation

protected void customizeDevicePreInvocation (IConfiguration config, 
                IInvocationContext context)

在preInvocationSetup之前，有机会自定义一些设备。

参量
`config`	`IConfiguration` ：调用的配置。
`context`	`IInvocationContext` ：当前调用上下文。

getAdbVersion

protected String getAdbVersion ()

返回用于调用的adb版本。

退货
`String`

setTestTag

protected void setTestTag (IBuildInfo info, 
                IConfiguration config)

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

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