此页面由 Cloud Translation API 翻译。

IInvocationExecution

public interface IInvocationExecution

com.android.tradefed.invoker.IInvocationExecution

已知的间接子类

DelegatedInvocationExecution、InvocationExecution、ParentSandboxInvocationExecution、RemoteInvocationExecution、SandboxedInvocationExecution

DelegatedInvocationExecution	`InvocationExecution`，用于将执行委托给另一个 Tradefed 二进制文件。
InvocationExecution	描述所有调用步骤的类：build 下载、target_prep、运行测试、清理。
ParentSandboxInvocationExecution	运行`InvocationExecution` 沙盒
RemoteInvocationExecution	驱动远程执行的 `InvocationExecution` 的实现。
SandboxedInvocationExecution	调用的特殊沙盒执行：这是我们运行此命令

描述将在调用过程中执行的操作的接口。调用 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)` 尝试将配置分片为子配置，并重新安排在哪个子配置中运行并行运行多个资源。

公共方法

cleanUpBuild

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 清理步骤。设备会清理吗。

参数
`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
	com.android.tradefed.device.DeviceNotAvailableException
`BuildError`
`DeviceNotAvailableException`
`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`：运行测试时抛出的原始异常。

抛出
	可投掷

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`：用于报告 build 下载失败的 `ITestInvocation`。

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

抛出
	com.android.tradefed.build.BuildRetrievalError
	com.android.tradefed.device.DeviceNotAvailableException
`BuildRetrievalError`
`DeviceNotAvailableException`

reportLogs

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
	com.android.tradefed.targetprep.TargetSetupError
`DeviceNotAvailableException`
`TargetSetupError`

runTest

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`