A partir de 2026, para alinearnos con nuestro modelo de desarrollo llamado Trunk Stable y garantizar la estabilidad de la plataforma para el ecosistema, publicaremos el código fuente en el AOSP en el segundo y cuarto trimestre. Para compilar el AOSP y contribuir a él, usa android-latest-release. 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 el AOSP.

Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

ISandbox

public interface ISandbox

com.android.tradefed.sandbox.ISandbox

Subcategorías indirectas conocidas

GoogleTradefedSandbox, TradefedSandbox

GoogleTradefedSandbox	Es la especialización interna de `TradefedSandbox` que se usará en la infraestructura del lab.
TradefedSandbox	Es un contenedor de zona de pruebas que puede ejecutar una invocación de Trade Federation.

Interfaz que define una zona de pruebas que se puede usar para ejecutar una invocación.

Resumen

Métodos públicos
`abstract String`	`createClasspath(File workingDir)` Crea una ruta de acceso a clases basada en el entorno y el directorio de trabajo que devuelve `getTradefedSandboxEnvironment(IInvocationContext,IConfiguration,String[])`.
`abstract 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.
`default Map<String, List<String>>`	`discoverTests(IInvocationContext context, IConfiguration configuration)` Es un subpaso de `prepareEnvironment(IInvocationContext,IConfiguration,ITestInvocationListener)` que descubre pruebas si `SandboxOptions.shouldUseTestDiscovery()` está habilitado.
`default Map<String, List<String>>`	`discoverTests(IInvocationContext context, IConfiguration configuration, ITestLogger logger)`
`default IFolderBuildInfo`	`fetchSandboxExtraArtifacts(IInvocationContext context, IConfiguration configuration, String[] args)` Subpaso de `prepareEnvironment(IInvocationContext,IConfiguration,ITestInvocationListener)` que recupera los archivos adicionales necesarios para la zona de pruebas.
`default File`	`getTradefedSandboxEnvironment(IInvocationContext context, IConfiguration nonVersionedConfig, String[] args)` Devuelve el TF del entorno de pruebas que se usará según los argumentos de la línea de comandos.
`default File`	`getTradefedSandboxEnvironment(IInvocationContext context, IConfiguration nonVersionedConfig, ITestLogger logger, String[] args)`
`abstract Exception`	`prepareEnvironment(IInvocationContext context, IConfiguration configuration, ITestInvocationListener listener)` Prepara el entorno para que el sandbox se ejecute correctamente.
`abstract CommandResult`	`run(TestInformation info, IConfiguration configuration, ITestLogger logger)` Ejecuta la zona de pruebas con el entorno que se configuró.
`abstract void`	`tearDown()` Limpia cualquier estado, archivo o entorno que se haya cambiado.

Métodos públicos

createClasspath

public abstract String createClasspath (File workingDir)

Crea una ruta de acceso a clases basada en el entorno y el directorio de trabajo que devuelve getTradefedSandboxEnvironment(IInvocationContext,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 abstract 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`	Es 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.

discoverTests

public Map<String, List<String>> discoverTests (IInvocationContext context, 
                IConfiguration configuration)

Es un subpaso de prepareEnvironment(IInvocationContext,IConfiguration,ITestInvocationListener) que descubre pruebas si SandboxOptions.shouldUseTestDiscovery() está habilitado.

Parámetros
`context`	`IInvocationContext`: Es la invocación actual `IInvocationContext`.
`configuration`	`IConfiguration`: Es el `IConfiguration` del comando que se ejecutará.

Muestra
`Map<String, List<String>>`	Mapa de las pruebas detectadas o valor nulo si no se admiten o fallaron.

discoverTests

public Map<String, List<String>> discoverTests (IInvocationContext context, 
                IConfiguration configuration, 
                ITestLogger logger)

Parámetros
`context`	`IInvocationContext`
`configuration`	`IConfiguration`
`logger`	`ITestLogger`

Muestra
`Map<String, List<String>>`

fetchSandboxExtraArtifacts

public IFolderBuildInfo fetchSandboxExtraArtifacts (IInvocationContext context, 
                IConfiguration configuration, 
                String[] args)

Subpaso de prepareEnvironment(IInvocationContext,IConfiguration,ITestInvocationListener) que recupera los archivos adicionales necesarios para la zona de pruebas.

Parámetros
`context`	`IInvocationContext`: Es la invocación actual `IInvocationContext`.
`configuration`	`IConfiguration`: Es el `IConfiguration` del comando que se ejecutará.
`args`	`String`: Son los argumentos de la línea de comandos.

Muestra
`IFolderBuildInfo`	Es la compilación recuperada para los archivos adicionales en zona de pruebas.

Arroja
	com.android.tradefed.build.BuildRetrievalError
	com.android.tradefed.config.ConfigurationException
	java.io.IOException
`BuildRetrievalError`
`ConfigurationException`
`IOException`

getTradefedSandboxEnvironment

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

Devuelve el TF del entorno de pruebas que se usará según los argumentos de la línea de comandos.

Parámetros
`context`	`IInvocationContext`: Es el `IInvocationContext` del elemento principal.
`nonVersionedConfig`	`IConfiguration`: Es el `IConfiguration` que representa los objetos sin versiones.
`args`	`String`: Son los argumentos de la línea de comandos.

Muestra
`File`	Un directorio `File` que contiene los archivos .jar del entorno de zona de pruebas de TF.

Arroja
`Exception`

getTradefedSandboxEnvironment

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

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

Muestra
`File`

Arroja
`Exception`

prepareEnvironment

public abstract Exception prepareEnvironment (IInvocationContext context, 
                IConfiguration configuration, 
                ITestInvocationListener listener)

Prepara el entorno para que el sandbox se ejecute correctamente.

Parámetros
`context`	`IInvocationContext`: Es la invocación actual `IInvocationContext`.
`configuration`	`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 abstract CommandResult run (TestInformation info, 
                IConfiguration configuration, 
                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.
`configuration`	`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.

Arroja
`Throwable`

tearDown

public abstract void tearDown ()

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