此页面由 Cloud Translation API 翻译。

调用执行

public interface IInvocationExecution

com.android.tradefed.invoker.IInvocationExecution

已知的间接子类

DelegatedInvocationExecution , InvocationExecution , ParentSandboxInvocationExecution , RemoteInvocationExecution , SandboxedInvocationExecution

委托调用执行	`InvocationExecution`将执行委托给另一个 Tradefed 二进制文件。
调用执行	描述所有调用步骤的类：构建下载、target_prep、运行测试、清理。
ParentSandboxInvocationExecution	运行沙箱时父调用特殊操作的`InvocationExecution`版本。
远程调用执行	驱动远程执行的`InvocationExecution`的实现。
沙盒调用执行	调用的特殊沙箱执行：这是当我们在沙箱中运行命令时的 InvocationExection。

描述将作为调用的一部分执行的操作的接口。调用TestInvocation本身确保调用的顺序。

概括

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

公共方法

清理构建

public void cleanUpBuilds (IInvocationContext context, 
                IConfiguration config)

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

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

清理

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

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

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

设置

public void doSetup (TestInformation testInfo, 
                IConfiguration config, 
                ITestLogger logger)

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

参数
`testInfo`	`TestInformation` ：调用的`TestInformation` 。
`config`	`IConfiguration` ：此测试运行的`IConfiguration` 。
`logger`	`ITestLogger` ：报告设置失败日志的`ITestLogger` 。

投掷
	com.android.tradefed.targetprep.TargetSetupError
	com.android.tradefed.targetprep.BuildError
`DeviceNotAvailableException`
`BuildError`
`TargetSetupError`

拆解

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` ：测试运行时抛出的原始异常。

投掷
`Throwable`

获取构建

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。

投掷
	com.android.tradefed.build.BuildRetrievalError
`DeviceNotAvailableException`
`BuildRetrievalError`

报告日志

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

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

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

runDevicePostInvocationTearDown

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

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

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

runDevicePreInvocationSetup

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

为调用的每个设备部分调用ERROR(ITestDevice#preInvocationSetup(IBuildInfo)/com.android.tradefed.device.ITestDevice#preInvocationSetup(com.android.tradefed.build.IBuildInfo) ITestDevice#preInvocationSetup(IBuildInfo)) 。

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

投掷
	com.android.tradefed.device.DeviceNotAvailableException
`TargetSetupError`
`DeviceNotAvailableException`

运行测试

public void runTests (TestInformation info, 
                IConfiguration config, 
                ITestInvocationListener listener)

运行测试。

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

投掷
`Throwable`

分片配置

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`	如果测试被分片，则为真。否则返回`false`