Google se compromete a impulsar la igualdad racial para las comunidades afrodescendientes. Obtén información al respecto.

ITestSuite

public abstract class ITestSuite
extends Object implements IRemoteTest, IDeviceTest , IBuildReceiver , ISystemStatusCheckerReceiver , IShardableTest , ITestCollector , IInvocationContextReceiver , IRuntimeHintProvider , IMetricCollectorReceiver , IConfigurationReceiver , IReportNotExecuted , ITokenRequest, ITestLoggerReceiver

java.lang.Objeto
com.android.tradefed.testtype.suite.ITestSuite


Clase abstracta utilizada para ejecutar Test Suite. Esta clase proporciona la base de cómo se ejecutará la Suite. Cada implementación puede definir la lista de pruebas a través del método loadTests() .

Resumen

Campos

public static final String ABI_OPTION

public static final String ACTIVE_MAINLINE_PARAMETER_KEY

public static final String MAINLINE_PARAMETER_KEY

public static final String MODULE_CHECKER_POST

public static final String MODULE_CHECKER_PRE

public static final String MODULE_METADATA_EXCLUDE_FILTER

public static final String MODULE_METADATA_INCLUDE_FILTER

public static final String PARAMETER_KEY

public static final String PREPARER_WHITELIST

public static final String PRIMARY_ABI_RUN

public static final String RANDOM_SEED

public static final String REBOOT_BEFORE_TEST

public static final String RUNNER_WHITELIST

public static final String SKIP_HOST_ARCH_CHECK

public static final String SKIP_SYSTEM_STATUS_CHECKER

public static final String TOKEN_KEY

Constructores públicos

ITestSuite ()

Métodos públicos

void addModuleMetadataExcludeFilters (MultiMap<String, String> filters)
void addModuleMetadataIncludeFilters (MultiMap<String, String> filters)
final void enableRebootBeforeTest ()

Establece reiniciar antes de la prueba en verdadero.

getAbis (ITestDevice device)

Obtiene el conjunto de ABI compatibles con las pruebas de compatibilidad AbiUtils.getAbisSupportedByCompatibility() y el dispositivo bajo prueba.

static getAbisForBuildTargetArchFromSuite ()

Devuelve el posible abis de TestSuiteInfo.

IBuildInfo getBuildInfo ()

La implementación de ITestSuite puede requerir la información de compilación para cargar las pruebas.

final IConfiguration getConfiguration ()

Devuelve la invocación IConfiguration .

ITestLogger getCurrentTestLogger ()
ITestDevice getDevice ()

Obtenga el dispositivo bajo prueba.

ModuleDefinition getDirectModule ()

Devuelve ModuleDefinition para que se ejecute directamente, o nulo si aún no lo ha hecho (cuando ITestSuite aún no se ha fragmentado).

IInvocationContext getInvocationContext ()

Devuelve el contexto de invocación.

final String getRequestedAbi ()

Devuelve el abi solicitado con la opción -a o --abi.

getRequiredTokens ()
long getRuntimeHint ()

Devuelve el tiempo de ejecución esperado de la prueba en milisegundos.

File getTestsDir ()
boolean isSplitting ()

Devuelve verdadero si actualmente estamos en IShardableTest.split(int) .

abstract loadTests ()

Método abstracto para cargar la configuración de las pruebas que se ejecutarán.

void reportNotExecuted (ITestInvocationListener listener, String message)

Informe las pruebas no ejecutadas al oyente principal proporcionado.

void reportNotExecuted (ITestInvocationListener listener)

Informe las pruebas no ejecutadas al oyente principal proporcionado.

final void run (TestInformation testInfo, ITestInvocationListener listener)

Método de ejecución genérico para todas las pruebas cargadas desde loadTests() .

void setAbiName (String abiName)

Establecer el valor de mAbiName

final void setAbis ( abis) setAbis ( abis)
void setBuild (IBuildInfo buildInfo)

void setCollectTestsOnly (boolean shouldCollectTest)

Ejecute el conjunto de pruebas en modo de solo recopilador, esto requiere todas las subpruebas para implementar esta interfaz también.

void setConfiguration ( IConfiguration configuration)

Inyecta la IConfiguration en uso.

void setDevice (ITestDevice device)

Inyecte el dispositivo bajo prueba.

void setInvocationContext (IInvocationContext invocationContext)

void setInvocationInjector (Injector injector)

Obtenga el Injector Guice actual de la invocación.

void setMetricCollectors ( collectors) setMetricCollectors ( collectors)

Establece la lista de IMetricCollector definidos para la ejecución de la prueba.

void setPrimaryAbiRun (boolean primaryAbiRun)

Establecer el valor de mPrimaryAbiRun

void setShouldMakeDynamicModule (boolean dynamicModule)

Al hacer fragmentación distribuida, no podemos tener ModuleDefinition que comparte pruebas en un grupo; de lo contrario, la fragmentación dentro del módulo no funcionará, por lo que permitimos deshabilitarla.

void setSystemStatusChecker ( systemCheckers) setSystemStatusChecker ( systemCheckers)

Establece los ISystemStatusChecker desde la configuración para la prueba.

void setTestLogger (ITestLogger testLogger)

split (Integer shardCountHint, TestInformation testInfo)

Versión alternativa de split(int) que también proporciona TestInformation que contiene información temprana del padre que crea los fragmentos.

Métodos protegidos

createModuleListeners ()

Devuelve la lista de ITestInvocationListener aplicable al nivel de ModuleListener .

boolean filterByConfigMetadata ( IConfiguration config, MultiMap<String, String> include, MultiMap<String, String> exclude)

Aplique el filtro de metadatos a la configuración y vea si la configuración debe ejecutarse.

boolean filterByRunnerType ( IConfiguration config, allowedRunners) filterByRunnerType ( IConfiguration config, allowedRunners)

Aplique el filtrado de la lista blanca de corredores, eliminando cualquier corredor que no esté en la lista blanca.

getAbisForBuildTargetArch ()

Devuelve el abis compatible con la arquitectura de destino de compilación del Host.

getHostAbis ()

Devuelve el abis de la máquina host.

boolean shouldModuleRun ( ModuleDefinition module)

Campos

ABI_OPCIÓN

public static final String ABI_OPTION

ACTIVE_MAINLINE_PARAMETER_KEY

public static final String ACTIVE_MAINLINE_PARAMETER_KEY

LÍNEA PRINCIPAL_PARAMETER_KEY

public static final String MAINLINE_PARAMETER_KEY

MODULE_CHECKER_POST

public static final String MODULE_CHECKER_POST

MODULE_CHECKER_PRE

public static final String MODULE_CHECKER_PRE

MODULE_METADATA_EXCLUDE_FILTER

public static final String MODULE_METADATA_EXCLUDE_FILTER

MODULE_METADATA_INCLUDE_FILTER

public static final String MODULE_METADATA_INCLUDE_FILTER

PARAMETER_KEY

public static final String PARAMETER_KEY

PREPARADOR_LISTABLANCO

public static final String PREPARER_WHITELIST

PRIMARY_ABI_RUN

public static final String PRIMARY_ABI_RUN

SEMILLA ALEATORIA

public static final String RANDOM_SEED

REINICIAR_ANTES DE LA PRUEBA

public static final String REBOOT_BEFORE_TEST

CORREDOR_LISTABLANCA

public static final String RUNNER_WHITELIST

SALTAR_HOST_ARCH_CHECK

public static final String SKIP_HOST_ARCH_CHECK

SALTAR_SYSTEM_STATUS_CHECKER

public static final String SKIP_SYSTEM_STATUS_CHECKER

TOKEN_KEY

public static final String TOKEN_KEY

Constructores públicos

ITestSuite

public ITestSuite ()

Métodos públicos

addModuleMetadataExcludeFilters

public void addModuleMetadataExcludeFilters (MultiMap<String, String> filters)

Parámetros
filters MultiMap

addModuleMetadataIncludeFilters

public void addModuleMetadataIncludeFilters (MultiMap<String, String> filters)

Parámetros
filters MultiMap

enableRebootBeforeTest

public final void enableRebootBeforeTest ()

Establece reiniciar antes de la prueba en verdadero.

obtenerAbis

public  getAbis (ITestDevice device)

Obtiene el conjunto de ABI compatibles con las pruebas de compatibilidad AbiUtils.getAbisSupportedByCompatibility() y el dispositivo bajo prueba.

Parámetros
device ITestDevice

Devoluciones
El conjunto de ABI para ejecutar las pruebas en

Lanza
DeviceNotAvailableException

getAbisForBuildTargetArchFromSuite

public static  getAbisForBuildTargetArchFromSuite ()

Devuelve el posible abis de TestSuiteInfo.

Devoluciones

getBuildInfo

public IBuildInfo getBuildInfo ()

La implementación de ITestSuite puede requerir la información de compilación para cargar las pruebas.

Devoluciones
IBuildInfo

getConfiguration

public final IConfiguration getConfiguration ()

Devuelve la invocación IConfiguration .

Devoluciones
IConfiguration

getCurrentTestLogger

public ITestLogger getCurrentTestLogger ()

Devoluciones
ITestLogger

obtenerDispositivo

public ITestDevice getDevice ()

Obtenga el dispositivo bajo prueba.

Devoluciones
ITestDevice el dispositivo de ITestDevice

getDirectModule

public ModuleDefinition getDirectModule ()

Devuelve ModuleDefinition para que se ejecute directamente, o nulo si aún no lo ha hecho (cuando ITestSuite aún no se ha fragmentado).

Devoluciones
ModuleDefinition

getInvocationContext

public IInvocationContext getInvocationContext ()

Devuelve el contexto de invocación.

Devoluciones
IInvocationContext

getRequestedAbi

public final String getRequestedAbi ()

Devuelve el abi solicitado con la opción -a o --abi.

Devoluciones
String

obtener tokens requeridos

public  getRequiredTokens ()

Devoluciones

getRuntimeHint

public long getRuntimeHint ()

Devuelve el tiempo de ejecución esperado de la prueba en milisegundos. El tiempo se utiliza para equilibrar la carga de la ejecución fragmentada.

Devoluciones
long

getTestsDir

public File getTestsDir ()

Devoluciones
File

es dividir

public boolean isSplitting ()

Devuelve verdadero si actualmente estamos en IShardableTest.split(int) .

Devoluciones
boolean

pruebas de carga

public abstract  loadTests ()

Método abstracto para cargar la configuración de las pruebas que se ejecutarán. Cada prueba está definida por una IConfiguration y un nombre único bajo el cual informará los resultados.

Devoluciones

informe no ejecutado

public void reportNotExecuted (ITestInvocationListener listener, 
                String message)

Informe las pruebas no ejecutadas al oyente principal proporcionado. Deben informarse como fallidos con el mensaje NOT_EXECUTED_FAILURE .

Parámetros
listener ITestInvocationListener : el oyente principal donde reportar los resultados no ejecutados.

message String : el mensaje que se asociará con la falla no ejecutada.

informe no ejecutado

public void reportNotExecuted (ITestInvocationListener listener)

Informe las pruebas no ejecutadas al oyente principal proporcionado. Deben informarse como fallidos con el mensaje NOT_EXECUTED_FAILURE .

Parámetros
listener ITestInvocationListener : el oyente principal donde reportar los resultados no ejecutados.

correr

public final void run (TestInformation testInfo, 
                ITestInvocationListener listener)

Método de ejecución genérico para todas las pruebas cargadas desde loadTests() .

Parámetros
testInfo TestInformation

listener ITestInvocationListener

Lanza
DeviceNotAvailableException

establecerNombreAbi

public void setAbiName (String abiName)

Establecer el valor de mAbiName

Parámetros
abiName String

conjuntoAbis

public final void setAbis ( abis)

Parámetros
abis

establecerConstruir

public void setBuild (IBuildInfo buildInfo)

Parámetros
buildInfo IBuildInfo

setCollectTestsOnly

public void setCollectTestsOnly (boolean shouldCollectTest)

Ejecute el conjunto de pruebas en modo de solo recopilador, esto requiere todas las subpruebas para implementar esta interfaz también.

setConfiguration

public void setConfiguration (IConfiguration configuration)

Inyecta la IConfiguration en uso.

Parámetros
configuration IConfiguration

establecer dispositivo

public void setDevice (ITestDevice device)

Inyecte el dispositivo bajo prueba.

Parámetros
device ITestDevice : el ITestDevice a utilizar

establecerInvocaciónContexto

public void setInvocationContext (IInvocationContext invocationContext)

Parámetros
invocationContext IInvocationContext

conjuntoInvocaciónInyector

public void setInvocationInjector (Injector injector)

Obtenga el Injector Guice actual de la invocación. Debería permitirnos continuar con la inyección de objetos de módulos.

Parámetros
injector Injector

setMetricCollectors

public void setMetricCollectors ( collectors)

Establece la lista de IMetricCollector definidos para la ejecución de la prueba.

Parámetros
collectors

setPrimaryAbiRun

public void setPrimaryAbiRun (boolean primaryAbiRun)

Establecer el valor de mPrimaryAbiRun

Parámetros
primaryAbiRun boolean

setShouldMakeDynamicModule

public void setShouldMakeDynamicModule (boolean dynamicModule)

Al hacer fragmentación distribuida, no podemos tener ModuleDefinition que comparte pruebas en un grupo; de lo contrario, la fragmentación dentro del módulo no funcionará, por lo que permitimos deshabilitarla.

Parámetros
dynamicModule boolean

establecerSystemStatusChecker

public void setSystemStatusChecker ( systemCheckers)

Establece los ISystemStatusChecker desde la configuración para la prueba.

Parámetros
systemCheckers

setTestLogger

public void setTestLogger (ITestLogger testLogger)

Parámetros
testLogger ITestLogger

separar

public  split (Integer shardCountHint, 
                TestInformation testInfo)

Versión alternativa de split(int) que también proporciona TestInformation que contiene información temprana del padre que crea los fragmentos. Es útil si es necesario acceder a elementos como el dispositivo o la información de compilación durante la fragmentación.

Parámetros
shardCountHint Integer : el número de fragmentos intentados.

testInfo TestInformation : El padre TestInformation

Devoluciones
una colección de subpruebas que se ejecutarán por separado o null si la prueba no se puede fragmentar actualmente

Métodos protegidos

createModuleListeners

protected  createModuleListeners ()

Devuelve la lista de ITestInvocationListener aplicable al nivel de ModuleListener . Estos oyentes se reutilizarán para cada módulo, no se volverán a crear instancias, por lo que no deberían asumir un estado interno.

Devoluciones

filterByConfigMetadata

protected boolean filterByConfigMetadata (IConfiguration config, 
                MultiMap<String, String> include, 
                MultiMap<String, String> exclude)

Aplique el filtro de metadatos a la configuración y vea si la configuración debe ejecutarse.

Parámetros
config IConfiguration : la IConfiguration que se está evaluando.

include MultiMap : el filtro de inclusión de metadatos

exclude MultiMap : el filtro de exclusión de metadatos

Devoluciones
boolean Verdadero si el módulo debe ejecutarse, falso en caso contrario.

filtroPorTipoCorredor

protected boolean filterByRunnerType (IConfiguration config, 
                 allowedRunners)

Aplique el filtrado de la lista blanca de corredores, eliminando cualquier corredor que no esté en la lista blanca. Si una configuración tiene varios ejecutores, es posible que se eliminen algunos y la configuración seguirá ejecutándose.

Parámetros
config IConfiguration : la IConfiguration que se está evaluando.

allowedRunners : La lista blanca actual del corredor.

Devoluciones
boolean Verdadero si el módulo de configuración puede ejecutarse, falso en caso contrario.

getAbisForBuildTargetArch

protected  getAbisForBuildTargetArch ()

Devuelve el abis compatible con la arquitectura de destino de compilación del Host. Expuesto para la prueba.

Devoluciones

getHostAbis

protected  getHostAbis ()

Devuelve el abis de la máquina host.

Devoluciones

deberíaModuleRun

protected boolean shouldModuleRun (ModuleDefinition module)

Parámetros
module ModuleDefinition

Devoluciones
boolean