A partir de 2026, para alinearnos con nuestro modelo de desarrollo estable de la rama principal y garantizar la estabilidad de la plataforma para el ecosistema, publicaremos el código fuente en AOSP en el segundo y cuarto trimestre. Para compilar AOSP y contribuir a él, te recomendamos que utilices android-latest-release en lugar de aosp-main. La rama del manifiesto android-latest-release siempre hará referencia a la versión más reciente que se envió al AOSP. Para obtener más información, consulta Cambios en AOSP.

TradefedSandbox

public class TradefedSandbox
extends Object implements ISandbox

java.lang.Object
↳	com.android.tradefed.sandbox.TradefedSandbox

Es un contenedor de zona de pruebas que puede ejecutar una invocación de Trade Federation. TODO: Permitir que se pasen opciones al sandbox.

Resumen

Constantes
`String`	`EXTRA_TARGET_LAB`
`String`	`GENERAL_TESTS_ZIP`
`String`	`SANDBOX_ENABLED`

Constructores públicos
`TradefedSandbox()`

Métodos públicos
`String`	`createClasspath(File workingDir)` Crea una ruta de acceso a clases basada en el entorno y el directorio de trabajo que devuelve `ISandbox.getTradefedSandboxEnvironment(com.android.tradefed.invoker.IInvocationContext, com.android.tradefed.config.IConfiguration, String[])`.
`IConfiguration`	`createThinLauncherConfig(String[] args, IKeyStoreClient keyStoreClient, IRunUtil runUtil, File globalConfig)` El modo especial se desconectó de la ejecución principal: Cuando una configuración no parece existir en el elemento superior, recurrimos al selector delgado, en el que intentamos configurar el sandbox con la información conocida actualmente y completar el directorio de trabajo para crear la configuración por completo en el directorio versionado.
`File`	`getTradefedSandboxEnvironment(IInvocationContext context, IConfiguration nonVersionedConfig, ITestLogger logger, String[] args)`
`static`	`matchSandboxExtraBuildTargetByConfigName(String configName)` Dado el nombre de la configuración de prueba, haz coincidir los destinos de compilación adicionales de los destinos de compilación adicionales de Sandbox.
`Exception`	`prepareEnvironment(IInvocationContext context, IConfiguration config, ITestInvocationListener listener)` Prepara el entorno para que la zona de pruebas se ejecute correctamente.
`CommandResult`	`run(TestInformation info, IConfiguration config, ITestLogger logger)` Ejecuta la zona de pruebas con el entorno que se configuró.
`void`	`tearDown()` Limpia cualquier estado, archivo o entorno que se haya cambiado.

Métodos protegidos
`File`	`dumpGlobalConfig(IConfiguration config, exclusionPatterns)` Volca la configuración global filtrada de algunos objetos.
`String`	`getJava()`
`Exception`	`prepareConfiguration(IInvocationContext context, IConfiguration config, ITestInvocationListener listener)` Prepara el `IConfiguration` que se pasará al subproceso y controlará la ejecución del contenedor.
`File`	`prepareContext(IInvocationContext context, IConfiguration config)` Prepara y serializa el `IInvocationContext`.

Constantes

EXTRA_TARGET_LAB

public static final String EXTRA_TARGET_LAB

Valor de la constante: "lab"

GENERAL_TESTS_ZIP

public static final String GENERAL_TESTS_ZIP

Valor de la constante: "general-tests.zip"

SANDBOX_ENABLED

public static final String SANDBOX_ENABLED

Valor de la constante: "SANDBOX_ENABLED"

Constructores públicos

TradefedSandbox

public TradefedSandbox ()

Métodos públicos

createClasspath

public String createClasspath (File workingDir)

Crea una ruta de acceso a clases basada en el entorno y el directorio de trabajo que devuelve ISandbox.getTradefedSandboxEnvironment(com.android.tradefed.invoker.IInvocationContext, com.android.tradefed.config.IConfiguration, String[]).

Parámetros
`workingDir`	`File`: Es el directorio de trabajo actual de la zona de pruebas.

Muestra
`String`	Es la ruta de acceso a la clase que se usará.

Arroja
`ConfigurationException`

createThinLauncherConfig

public IConfiguration createThinLauncherConfig (String[] args, 
                IKeyStoreClient keyStoreClient, 
                IRunUtil runUtil, 
                File globalConfig)

El modo especial se desconectó de la ejecución principal: Cuando una configuración no parece existir en el elemento superior, recurrimos al selector de inicio delgado, en el que intentamos configurar el sandbox con la información conocida actualmente y completar el directorio de trabajo para crear la configuración por completo en el directorio versionado.

Parámetros
`args`	`String`: Son los argumentos originales de la línea de comandos.
`keyStoreClient`	`IKeyStoreClient`: Es el cliente actual del almacén de claves que se usa para crear configuraciones.
`runUtil`	`IRunUtil`: Es el `IRunUtil` actual para ejecutar comandos del host.
`globalConfig`	`File`: Es la configuración global que se usará para ejecutar subprocesos de TF.

Muestra
`IConfiguration`	Un archivo que apunta al XML de configuración de TF para objetos NON_VERSIONED. Devuelve null si no se pudo crear ninguna configuración de inicio delgada.

getTradefedSandboxEnvironment

public File getTradefedSandboxEnvironment (IInvocationContext context, 
                IConfiguration nonVersionedConfig, 
                ITestLogger logger, 
                String[] args)

Parámetros
`context`	`IInvocationContext`
`nonVersionedConfig`	`IConfiguration`
`logger`	`ITestLogger`
`args`	`String`

Muestra
`File`

matchSandboxExtraBuildTargetByConfigName

public static  matchSandboxExtraBuildTargetByConfigName (String configName)

Dado el nombre de la configuración de prueba, haz coincidir los destinos de compilación adicionales de los destinos de compilación adicionales de Sandbox.

Parámetros
`configName`	`String`

Muestra

prepareEnvironment

public Exception prepareEnvironment (IInvocationContext context, 
                IConfiguration config, 
                ITestInvocationListener listener)

Prepara el entorno para que la zona de pruebas se ejecute correctamente.

Parámetros
`context`	`IInvocationContext`: Es la invocación actual `IInvocationContext`.
`config`	`IConfiguration`: Es el `IConfiguration` del comando que se ejecutará.
`listener`	`ITestInvocationListener`: Es la invocación actual `ITestInvocationListener` en la que se deben canalizar los resultados finales.

Muestra
`Exception`	Un `Exception` que contiene la falla o un valor nulo si la operación se realizó correctamente.

run

public CommandResult run (TestInformation info, 
                IConfiguration config, 
                ITestLogger logger)

Ejecuta la zona de pruebas con el entorno que se configuró.

Parámetros
`info`	`TestInformation`: Es el `TestInformation` que describe la invocación.
`config`	`IConfiguration`: Es el `IConfiguration` del comando que se ejecutará.
`logger`	`ITestLogger`: Un `ITestLogger` en el que podemos registrar archivos.

Muestra
`CommandResult`	Un `CommandResult` con el estado de la ejecución de la zona de pruebas y los registros.

tearDown

public void tearDown ()

Limpia cualquier estado, archivo o entorno que se haya cambiado.

Métodos protegidos

dumpGlobalConfig

protected File dumpGlobalConfig (IConfiguration config, 
                 exclusionPatterns)

Volca la configuración global filtrada de algunos objetos.

Parámetros
`config`	`IConfiguration`
`exclusionPatterns`

Muestra
`File`

Arroja
`ConfigurationException`

getJava

protected String getJava ()

Muestra
`String`

prepareConfiguration

protected Exception prepareConfiguration (IInvocationContext context, 
                IConfiguration config, 
                ITestInvocationListener listener)

Prepara el IConfiguration que se pasará al subproceso y controlará la ejecución del contenedor.

Parámetros
`context`	`IInvocationContext`: Es el `IInvocationContext` actual.
`config`	`IConfiguration`: Es el `IConfiguration` que se preparará.
`listener`	`ITestInvocationListener`: Es el `ITestInvocationListener` de la invocación actual.

Muestra
`Exception`	Una excepción si algo salió mal; de lo contrario, es nulo.

prepareContext

protected File prepareContext (IInvocationContext context, 
                IConfiguration config)

Prepara y serializa el IInvocationContext.

Parámetros
`context`	`IInvocationContext`: Es el `IInvocationContext` que se preparará.
`config`	`IConfiguration`: Es el `IConfiguration` de la zona de pruebas.

Muestra
`File`	Es el `IInvocationContext` serializado.

Arroja
	IOException