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