ISandbox

public interface ISandbox

com.android.tradefed.sandbox.ISandbox


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 un classpath basado 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 parece que no existe una configuración en el padre, recurrimos al iniciador delgado donde intentamos configurar el entorno limitado con información conocida actualmente y llenamos el directorio de trabajo para crear la configuración completamente en el directorio versionado .

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

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

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

Prepare el entorno para que 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

crear ruta de clase

public abstract String createClasspath (File workingDir)

Cree un classpath basado 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 para el 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 parece que no existe una configuración en el padre, recurrimos al iniciador delgado donde intentamos configurar el entorno limitado con información conocida actualmente y llenamos el directorio de trabajo para crear la configuración completamente en el directorio versionado .

Parámetros
args String : la línea de comando original args.

keyStoreClient IKeyStoreClient : el cliente de almacén de claves actual que se usará para crear configuraciones.

runUtil IRunUtil : el IRunUtil actual para ejecutar comandos de host.

globalConfig File : la configuración global que se usará para ejecutar subprocesos de TF.

Devoluciones
IConfiguration un archivo que apunta al XML de configuración de TF para objetos NO VERSIONADOS. Devuelve nulo si no se pudo crear una configuración de iniciador delgado.

getTradefedSandboxEnvironment

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

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

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 comandos.

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

prepararMedio ambiente

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

Prepare el entorno para que 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 : la 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 de la zona de pruebas.

demoler

public abstract void tearDown ()

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