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.

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

TradefedSandbox

TradefedSandbox 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 clase según el entorno y el directorio de trabajo que devuelve `getTradefedSandboxEnvironment(com.android.tradefed.invoker.IInvocationContext, com.android.tradefed.config.IConfiguration, String[])`.
`abstract IConfiguration`	`createThinLauncherConfig(String[] args, IKeyStoreClient keyStoreClient, IRunUtil runUtil, File globalConfig)` Modo especial desconectado de la ejecución principal: Cuando parece que no existe una configuración en el elemento superior, recurrimos al selector delgado, en el que intentamos configurar la zona de pruebas con la información conocida actualmente y completar el directorio de trabajo para crear la configuración por completo en el directorio con control de versión.
`default`	`discoverTests(IInvocationContext context, IConfiguration configuration)` Es un subpaso de `prepareEnvironment(com.android.tradefed.invoker.IInvocationContext, com.android.tradefed.config.IConfiguration, com.android.tradefed.result.ITestInvocationListener)` que descubre pruebas si `SandboxOptions.shouldUseTestDiscovery()` está habilitado.
`default`	`discoverTests(IInvocationContext context, IConfiguration configuration, ITestLogger logger)`
`default IFolderBuildInfo`	`fetchSandboxExtraArtifacts(IInvocationContext context, IConfiguration configuration, String[] args)` Es un paso secundario de `prepareEnvironment(com.android.tradefed.invoker.IInvocationContext, com.android.tradefed.config.IConfiguration, com.android.tradefed.result.ITestInvocationListener)` que recupera archivos adicionales necesarios para la zona de pruebas.
`default File`	`getTradefedSandboxEnvironment(IInvocationContext context, IConfiguration nonVersionedConfig, String[] args)` Devuelve el entorno de sandbox de TF que se usará según los argumentos de 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 la zona de pruebas 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 los estados, archivos o entornos que puedan haber cambiado.

Métodos públicos

createClasspath

public abstract String createClasspath (File workingDir)

Crea una ruta de clase según el entorno y el directorio de trabajo que devuelve 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 abstract IConfiguration createThinLauncherConfig (String[] args, 
                IKeyStoreClient keyStoreClient, 
                IRunUtil runUtil, 
                File globalConfig)

Modo especial desconectado de la ejecución principal: Cuando parece que no existe una configuración en el elemento superior, recurrimos al selector delgado, en el que intentamos configurar la zona de pruebas con la información conocida actualmente y completar el directorio de trabajo para crear la configuración por completo en el directorio con control de versión.

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

Muestra
`IConfiguration`	Un archivo que apunta al archivo en formato XML de configuración de TF para objetos NON_VERSIONED. Muestra un valor nulo si no se pudo crear una configuración de selector delgado.

discoverTests

public  discoverTests (IInvocationContext context, 
                IConfiguration configuration)

Es un subpaso de prepareEnvironment(com.android.tradefed.invoker.IInvocationContext, com.android.tradefed.config.IConfiguration, com.android.tradefed.result.ITestInvocationListener) que descubre pruebas si SandboxOptions.shouldUseTestDiscovery() está habilitado.

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

Muestra
	Es el mapa de pruebas descubiertas o un valor nulo si no se admite o si falló.

discoverTests

public  discoverTests (IInvocationContext context, 
                IConfiguration configuration, 
                ITestLogger logger)

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

Muestra

fetchSandboxExtraArtifacts

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

Es un paso secundario de prepareEnvironment(com.android.tradefed.invoker.IInvocationContext, com.android.tradefed.config.IConfiguration, com.android.tradefed.result.ITestInvocationListener) que recupera archivos adicionales necesarios para la zona de pruebas.

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

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

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

getTradefedSandboxEnvironment

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

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

Parámetros
`context`	`IInvocationContext`: Es el `IInvocationContext` del elemento superior.
`nonVersionedConfig`	`IConfiguration`: El `IConfiguration` que representa los objetos sin versión.
`args`	`String`: Los argumentos de la línea de comandos.

Muestra
`File`	Un directorio `ERROR(/File)` que contiene los frascos del entorno de zona de pruebas de TF

getTradefedSandboxEnvironment

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

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

Muestra
`File`

prepareEnvironment

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

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

Parámetros
`context`	`IInvocationContext`: Es la invocación `IInvocationContext` actual.
`configuration`	`IConfiguration`: Es el `IConfiguration` para que se ejecute el comando.
`listener`	`ITestInvocationListener`: Es la invocación `ITestInvocationListener` actual a la que se deben canalizar los resultados finales.

Muestra
`Exception`	Un `Exception` que contiene el error o nulo si se realiza 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` para que se ejecute el comando.
`logger`	`ITestLogger`: Un `ITestLogger` en el que podemos registrar archivos.

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

tearDown

public abstract void tearDown ()

Limpia los estados, archivos o entornos que puedan haber cambiado.