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