ISandbox

public interface ISandbox

com.android.tradefed.sandbox.ISandbox


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 basada en el entorno y el directorio de trabajo que muestra 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, recurriremos al lanzador delgado, en el que intentamos configurar la zona de pruebas con información conocida y llenar el directorio de trabajo para crear la configuración por completo en la dir con control de versiones.

default discoverTests(IInvocationContext context, IConfiguration configuration)

Un paso secundario 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 los archivos adicionales necesarios para la zona de pruebas.

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

Muestra el TF del entorno de la zona de pruebas que se utilizará 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 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 haberse modificado.

Métodos públicos

Crear ruta de clase

public abstract String createClasspath (File workingDir)

Crea una ruta de clase basada en el entorno y el directorio de trabajo que muestra 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 La ruta de 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, recurriremos al lanzador delgado, en el que intentamos configurar la zona de pruebas con información conocida y llenar el directorio de trabajo para crear la configuración por completo en la dir con control de versiones.

Parámetros
args String: Son los argumentos de la línea de comandos originales.

keyStoreClient IKeyStoreClient: Es el cliente del almacén de claves actual que se usa para crear configuraciones.

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

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

Muestra
IConfiguration un archivo que apunta al XML de configuración de TF para objetos NON_VERSIONED. Resultado que se muestra null si no se pudo crear una configuración de selector estrecho.

descubrirPruebas

public  discoverTests (IInvocationContext context, 
                IConfiguration configuration)

Un paso secundario 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 actual IInvocationContext.

configuration IConfiguration: Es el IConfiguration para que se ejecute el comando.

Muestra
El mapa de pruebas descubiertas o un valor nulo si no es compatible o falló.

descubrirPruebas

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 los archivos adicionales necesarios para la zona de pruebas.

Parámetros
context IInvocationContext: Es la invocación actual IInvocationContext.

configuration IConfiguration: Es el IConfiguration para que se ejecute el comando.

args String: Son los argumentos de la línea de comandos.

Muestra
IFolderBuildInfo la compilación recuperada para los archivos adicionales de 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)

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

Parámetros
context IInvocationContext: Es el IInvocationContext del elemento superior.

nonVersionedConfig IConfiguration: Es el IConfiguration que representa los objetos sin control de versiones.

args String: Son los argumentos de la línea de comandos.

Muestra
File Un directorio ERROR(/File) que contiene los archivos jar del entorno de la 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 actual IInvocationContext.

configuration IConfiguration: Es el IConfiguration para que se ejecute el comando.

listener ITestInvocationListener: Es la invocación actual ITestInvocationListener en la que se muestran los resultados finales. deben canalizarse.

Muestra
Exception un Exception que contiene la falla. o Nulo si tiene éxito.

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: Es 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

Eliminar

public abstract void tearDown ()

Limpia los estados, archivos o entornos que puedan haberse modificado.