自 2025 年 3 月 27 日起，我们建议您使用 android-latest-release 而非 aosp-main 构建 AOSP 并为其做出贡献。如需了解详情，请参阅 AOSP 的变更。

此页面由 Cloud Translation API 翻译。

SandboxedInvocationExecution

public class SandboxedInvocationExecution
extends InvocationExecution

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

调用的特殊沙盒执行：这是在沙盒内运行命令时的 InvocationExection。该 build 应该已在上下文中提供。

摘要

公共构造函数
`SandboxedInvocationExecution()`

公共方法
`void`	`cleanUpBuilds(IInvocationContext context, IConfiguration config)` 执行 build_provider 清理步骤。
`boolean`	`fetchBuild(TestInformation testInfo, IConfiguration config, IRescheduler rescheduler, ITestInvocationListener listener)` 执行调用的 build_provider 步骤。
`void`	`runDevicePostInvocationTearDown(IInvocationContext context, IConfiguration config, Throwable exception)` 针对调用的每个设备部分调用 `ITestDevice#postInvocationTearDown(Throwable)`。
`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))`。

受保护的方法
	`getPreparersToRun(IConfiguration config, String deviceName)` 检索要在此设备上运行的准备程序的列表。
`void`	`logHostAdb(IConfiguration config, ITestLogger logger)` 从 $TMPDIR/adb.$UID.log 收集日志。

公共构造函数

SandboxedInvocationExecution

public SandboxedInvocationExecution ()

公共方法

cleanUpBuilds

public void cleanUpBuilds (IInvocationContext context, 
                IConfiguration config)

执行 build_provider 清理步骤。与 build 提取相关。

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

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`	如果成功下载 build，则为 true；否则为 false。

抛出
`BuildRetrievalError`
`DeviceNotAvailableException`

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`。

抛出
`DeviceNotAvailableException`
`TargetSetupError`

受保护的方法

getPreparersToRun

protected  getPreparersToRun (IConfiguration config, 
                String deviceName)

检索要在此设备上运行的准备程序的列表。

在沙盒类中被替换，以限制实验准备程序在沙盒子级中运行

参数
`config`	`IConfiguration`
`deviceName`	`String`

返回

logHostAdb

protected void logHostAdb (IConfiguration config, 
                ITestLogger logger)

从 $TMPDIR/adb.$UID.log 收集日志。

参数
`config`	`IConfiguration`
`logger`	`ITestLogger`