Starting March 27, 2025, we recommend using android-latest-release instead of aosp-main to build and contribute to AOSP. For more information, see Changes to AOSP.

SandboxedInvocationExecution

public class SandboxedInvocationExecution
extends InvocationExecution

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

Special sandbox execution of the invocation: This is the InvocationExection for when we are inside the sandbox running the command. The build should already be available in the context.

Summary

Public constructors
`SandboxedInvocationExecution()`

Public methods
`void`	`cleanUpBuilds(IInvocationContext context, IConfiguration config)` Execute the build_provider clean up step.
`boolean`	`fetchBuild(TestInformation testInfo, IConfiguration config, IRescheduler rescheduler, ITestInvocationListener listener)` Execute the build_provider step of the invocation.

Protected methods
	`getLabPreparersToRun(IConfiguration config, String deviceName)` Retrieve a list of lab preparers to run on this device.
	`getTargetPreparersToRun(IConfiguration config, String deviceName)` Retrieve a list of target preparers to run on this device.
`void`	`logHostAdb(IConfiguration config, ITestLogger logger)` Collect the logs from $TMPDIR/adb.$UID.log.

Public constructors

SandboxedInvocationExecution

public SandboxedInvocationExecution ()

Public methods

cleanUpBuilds

public void cleanUpBuilds (IInvocationContext context, 
                IConfiguration config)

Execute the build_provider clean up step. Associated with the build fetching.

Parameters
`context`	`IInvocationContext`: the `IInvocationContext` of the invocation.
`config`	`IConfiguration`: the `IConfiguration` of this test run.

fetchBuild

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

Execute the build_provider step of the invocation.

Parameters
`testInfo`	`TestInformation`: the `TestInformation` of the invocation.
`config`	`IConfiguration`: the `IConfiguration` of this test run.
`rescheduler`	`IRescheduler`: the `IRescheduler`, for rescheduling portions of the invocation for execution on another resource(s)
`listener`	`ITestInvocationListener`: the `ITestInvocation` to report build download failures.

Returns
`boolean`	True if we successfully downloaded the build, false otherwise.

Throws
`BuildRetrievalError`
`DeviceNotAvailableException`

Protected methods

getLabPreparersToRun

protected  getLabPreparersToRun (IConfiguration config, 
                String deviceName)

Retrieve a list of lab preparers to run on this device.

Overridden in sandbox classes to restrict lab preparers from being run inside the sandbox child

Parameters
`config`	`IConfiguration`
`deviceName`	`String`

Returns

getTargetPreparersToRun

protected  getTargetPreparersToRun (IConfiguration config, 
                String deviceName)

Retrieve a list of target preparers to run on this device.

Overridden in sandbox classes to restrict lab preparers from being run inside the sandbox child

Parameters
`config`	`IConfiguration`
`deviceName`	`String`

Returns

logHostAdb

protected void logHostAdb (IConfiguration config, 
                ITestLogger logger)

Collect the logs from $TMPDIR/adb.$UID.log.

Parameters
`config`	`IConfiguration`
`logger`	`ITestLogger`