Esta página se ha traducido con Cloud Translation API.

ISandbox

public interface ISandbox

com.android.tradefed.sandbox.ISandbox

Subclases indirectas conocidas

Tradefed Sandbox Contenedor Sandbox que puede ejecutar una invocación de Trade Federation.

Interfaz que define un entorno limitado que se puede utilizar para ejecutar una invocación.

Resumen

Métodos públicos
`abstract String`	`createClasspath (File workingDir)` Cree una ruta de clases basada en el entorno y el directorio de trabajo devuelto por `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 una configuración no parece existir en el padre, recurrimos al iniciador ligero donde intentamos configurar la zona de pruebas con información actualmente conocida y llenar el directorio de trabajo para crear la configuración completamente en el directorio versionado. .
`default`	`discoverTests ( IInvocationContext context, IConfiguration configuration)` 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)` Subpaso de `prepareEnvironment(com.android.tradefed.invoker.IInvocationContext, com.android.tradefed.config.IConfiguration, com.android.tradefed.result.ITestInvocationListener)` que recupera archivos adicionales necesarios para el entorno sandbox.
`default File`	`getTradefedSandboxEnvironment ( IInvocationContext context, IConfiguration nonVersionedConfig, String[] args)` Devuelve el TF del entorno sandbox que se utilizará en función de los argumentos de la línea de comando.
`default File`	`getTradefedSandboxEnvironment ( IInvocationContext context, IConfiguration nonVersionedConfig, ITestLogger logger, String[] args)`
`abstract Exception`	`prepareEnvironment ( IInvocationContext context, IConfiguration configuration, ITestInvocationListener listener)` Prepare el entorno para que el sandbox funcione correctamente.
`abstract CommandResult`	`run ( TestInformation info, IConfiguration configuration, ITestLogger logger)` Ejecute el sandbox con el entorno que se configuró.
`abstract void`	`tearDown ()` Limpie cualquier estado, archivo o entorno que pueda haber sido modificado.

Métodos públicos

crearClasspath

public abstract String createClasspath (File workingDir)

Cree una ruta de clases basada en el entorno y el directorio de trabajo devuelto por getTradefedSandboxEnvironment(com.android.tradefed.invoker.IInvocationContext, com.android.tradefed.config.IConfiguration, String[]) .

Parámetros
`workingDir`	`File` : el directorio de trabajo actual del sandbox.

Devoluciones
`String`	El classpath que se utilizará.

Lanza
`ConfigurationException`

crearThinLauncherConfig

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

Modo especial desconectado de la ejecución principal: cuando una configuración no parece existir en el padre, recurrimos al iniciador ligero donde intentamos configurar la zona de pruebas con información actualmente conocida y llenar el directorio de trabajo para crear la configuración completamente en el directorio versionado. .

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

Devoluciones
`IConfiguration`	un archivo que apunta al XML de configuración de TF para objetos NON_VERSIONED. Devuelve nulo si no se pudo crear ninguna configuración de iniciador ligero.

descubrirPruebas

public  discoverTests (IInvocationContext context, 
                IConfiguration configuration)

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` : la invocación actual `IInvocationContext` .
`configuration`	`IConfiguration` : la `IConfiguration` para que se ejecute el comando.

Devoluciones
	El mapa de pruebas descubiertas o nulas si no son compatibles o fallan.

descubrirPruebas

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

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

Devoluciones

buscarSandboxExtraArtifacts

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

Subpaso de prepareEnvironment(com.android.tradefed.invoker.IInvocationContext, com.android.tradefed.config.IConfiguration, com.android.tradefed.result.ITestInvocationListener) que recupera archivos adicionales necesarios para el entorno sandbox.

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

Devoluciones
`IFolderBuildInfo`	la compilación recuperada para los archivos adicionales en el espacio aislado.

Lanza
	com.android.tradefed.build.BuildRetrievalError
	com.android.tradefed.config.ConfigurationException
	IOExcepción
`BuildRetrievalError`
`ConfigurationException`

getTradefedSandboxEnvironment

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

Devuelve el TF del entorno sandbox que se utilizará en función de los argumentos de la línea de comando.

Parámetros
`context`	`IInvocationContext` : el `IInvocationContext` del padre.
`nonVersionedConfig`	`IConfiguration` : la `IConfiguration` que representa los objetos no versionados.
`args`	`String` : los argumentos de la línea de comando.

Devoluciones
`File`	un directorio `ERROR(/File)` que contiene los archivos jar del entorno sandbox de TF.

getTradefedSandboxEnvironment

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

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

Devoluciones
`File`

preparar el medio ambiente

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

Prepare el entorno para que el sandbox funcione correctamente.

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

Devoluciones
`Exception`	una `Exception` que contiene el error. o Nulo si tiene éxito.

correr

public abstract CommandResult run (TestInformation info, 
                IConfiguration configuration, 
                ITestLogger logger)

Ejecute el sandbox con el entorno que se configuró.

Parámetros
`info`	`TestInformation` : `TestInformation` que describe la invocación.
`configuration`	`IConfiguration` : la `IConfiguration` para que se ejecute el comando.
`logger`	`ITestLogger` : un `ITestLogger` donde podemos registrar archivos.

Devoluciones
`CommandResult`	un `CommandResult` con el estado de la ejecución y los registros del sandbox.

demoler

public abstract void tearDown ()

Limpie cualquier estado, archivo o entorno que pueda haber sido modificado.