HostTest

public class HostTest
extends Object implements IAbiReceiver, IBuildReceiver, IConfigurationReceiver, IDeviceTest, IDiscoverTestClasses, IRemoteTest, IRuntimeHintProvider, IShardableTest, ITestAnnotationFilterReceiver, ITestCollector, ITestFilterReceiver

java.lang.Object
↳	com.android.tradefed.testtype.HostTest

Subclases directas conocidas JarHostTest JarHostTest Es un ejecutor de pruebas para pruebas JUnit del host.

---

Es un ejecutor de pruebas para pruebas basadas en el host de JUnit. Si la prueba que se ejecutará implementa IDeviceTest, este ejecutor pasará una referencia al dispositivo.

Resumen

Constantes
String	SET_OPTION_DESC
String	SET_OPTION_NAME

Constructores públicos
HostTest()

Métodos públicos
void	addAllExcludeAnnotation( notAnnotations) Agrega un ERROR(/Set) de anotaciones para excluir si una prueba está marcada con él.
void	addAllExcludeFilters( filters) Agrega el ERROR(/Set) de los filtros de las pruebas que se excluirán.
void	addAllIncludeAnnotation( annotations) Agrega un ERROR(/Set) de anotaciones para incluir si una prueba está marcada con él.
void	addAllIncludeFilters( filters) Agrega el ERROR(/Set) de los filtros de las pruebas que se incluirán.
void	addExcludeAnnotation(String notAnnotation) Agrega una anotación para excluir si una prueba está marcada con ella.
void	addExcludeFilter(String filter) Agrega un filtro de las pruebas que se deben excluir.
void	addIncludeAnnotation(String annotation) Agrega una anotación para incluir si una prueba está marcada con ella.
void	addIncludeFilter(String filter) Agrega un filtro de las pruebas que se incluirán.
void	clearExcludeAnnotations() Borra todas las anotaciones de exclusión que se registran actualmente.
void	clearExcludeFilters() Borra todos los filtros de exclusión que se rastrean actualmente.
void	clearIncludeAnnotations() Borra todas las anotaciones de inclusión que se rastrean actualmente.
void	clearIncludeFilters() Borra todos los filtros de inclusión que se rastrean actualmente.
int	countTestCases() Devuelve la cantidad de casos de prueba en todas las clases que forman parte de las pruebas.
IAbi	getAbi()
	getClassNames()
ITestDevice	getDevice() Obtén el dispositivo en prueba.
	getExcludeAnnotations() Devuelve el ERROR(/Set) actual de las anotaciones que se excluirán.
	getExcludeFilters() Devuelve el ERROR(/Set) actual de los filtros de exclusión.
	getIncludeAnnotations() Devuelve el ERROR(/Set) actual de las anotaciones que se incluirán.
	getIncludeFilters() Devuelve el ERROR(/Set) actual de los filtros de inclusión.
long	getRuntimeHint() Devuelve el tiempo de ejecución esperado de la prueba en milisegundos.
void	run(TestInformation testInfo, ITestInvocationListener listener) Ejecuta las pruebas y le informa el resultado al objeto de escucha.
void	setAbi(IAbi abi)
void	setBuild(IBuildInfo buildInfo)
void	setCollectTestsOnly(boolean shouldCollectTest) Habilita o inhabilita el modo de recopilación de pruebas.
void	setConfiguration(IConfiguration configuration) Inserta el IConfiguration en uso.
void	setDevice(ITestDevice device) Inserta el dispositivo en prueba.
static void	setOptionToLoadedObject(Object testObj, keyValueOptions) Es un asistente para que los ejecutores de dispositivos establezcan opciones de la misma manera que HostTest, desde set-option.
void	setTestInformation(TestInformation testInfo)
	split(Integer shardCount, TestInformation testInfo) Dividimos los datos por persona, ya sea por clase o método de prueba.

Métodos protegidos
HostTest	createHostTest(Class<?> classObj) Es un asistente para crear una instancia de HostTest cuando se realiza el sharding.
IBuildInfo	getBuild() Obtiene la información de compilación que recibió HostTest.
ClassLoader	getClassLoader() Devuelve el cargador de clases predeterminado.
final	getClasses()
File	getJarFile(String jarName, TestInformation testInfo) Inspecciona varias ubicaciones donde suelen encontrarse los artefactos para diferentes casos de uso y busca nuestro archivo JAR.
boolean	hasJUnit4Annotation(Class<?> classObj) Es un asistente para determinar si se trata de una clase de prueba con anotaciones de JUnit4.
Object	loadObject(Class<?> classObj) Carga el objeto de clase y establece la información de la prueba (dispositivo, compilación).
void	setClassName(String className) Borra y, luego, establece un nombre de clase para ejecutar.
boolean	shouldTestRun(AnnotatedElement annotatedElement) Verifica si un elemento que tiene una anotación pasa el filtro.

Constantes

SET_OPTION_DESC

public static final String SET_OPTION_DESC

Valor constante: "Opciones que se pasarán a la clase en prueba. La clave y el valor deben separarse con dos puntos ":"; por ejemplo, si la clase en prueba admite "--iteration 1" desde una línea de comandos, se debe pasar como "--set-option iteration:1" o "--set-option iteration:key=value" para pasar opciones al mapa. Los valores que contienen ":" o "=" se pueden escapar con una barra inversa. Se puede segmentar una clase en particular especificándola. " --set-option ::""

SET_OPTION_NAME

public static final String SET_OPTION_NAME

Valor de la constante: "set-option"

Constructores públicos

HostTest

public HostTest ()

Métodos públicos

addAllExcludeAnnotation

public void addAllExcludeAnnotation ( notAnnotations)

Agrega un ERROR(/Set) de anotaciones para excluir si una prueba está marcada con él.

Parámetros
notAnnotations

addAllExcludeFilters

public void addAllExcludeFilters ( filters)

Agrega el ERROR(/Set) de los filtros de las pruebas que se excluirán.

Parámetros
filters

addAllIncludeAnnotation

public void addAllIncludeAnnotation ( annotations)

Agrega un ERROR(/Set) de anotaciones para incluir si una prueba está marcada con él.

Parámetros
annotations

addAllIncludeFilters

public void addAllIncludeFilters ( filters)

Agrega el ERROR(/Set) de los filtros de las pruebas que se incluirán.

Parámetros
filters

addExcludeAnnotation

public void addExcludeAnnotation (String notAnnotation)

Agrega una anotación para excluir si una prueba está marcada con ella.

Parámetros
notAnnotation	String

addExcludeFilter

public void addExcludeFilter (String filter)

Agrega un filtro de las pruebas que se deben excluir.

Parámetros
filter	String

addIncludeAnnotation

public void addIncludeAnnotation (String annotation)

Agrega una anotación para incluir si una prueba está marcada con ella.

Parámetros
annotation	String

addIncludeFilter

public void addIncludeFilter (String filter)

Agrega un filtro de las pruebas que se incluirán.

Parámetros
filter	String

clearExcludeAnnotations

public void clearExcludeAnnotations ()

Borra todas las anotaciones de exclusión que se registran actualmente.

clearExcludeFilters

public void clearExcludeFilters ()

Borra todos los filtros de exclusión que se rastrean actualmente.

clearIncludeAnnotations

public void clearIncludeAnnotations ()

Borra todas las anotaciones de inclusión que se rastrean actualmente.

clearIncludeFilters

public void clearIncludeFilters ()

Borra todos los filtros de inclusión que se rastrean actualmente.

countTestCases

public int countTestCases ()

Devuelve la cantidad de casos de prueba en todas las clases que forman parte de las pruebas.

Muestra
int

getAbi

public IAbi getAbi ()

Muestra
IAbi

getClassNames

public  getClassNames ()

Muestra

getDevice

public ITestDevice getDevice ()

Obtén el dispositivo que se probará.

Muestra
ITestDevice	el ITestDevice

getExcludeAnnotations

public  getExcludeAnnotations ()

Devuelve el ERROR(/Set) actual de las anotaciones que se excluirán.

Muestra

getExcludeFilters

public  getExcludeFilters ()

Devuelve el ERROR(/Set) actual de los filtros de exclusión.

Muestra

getIncludeAnnotations

public  getIncludeAnnotations ()

Devuelve el ERROR(/Set) actual de las anotaciones que se incluirán.

Muestra

getIncludeFilters

public  getIncludeFilters ()

Devuelve el ERROR(/Set) actual de los filtros de inclusión.

Muestra

getRuntimeHint

public long getRuntimeHint ()

Devuelve el tiempo de ejecución esperado de la prueba en milisegundos. La hora se usa para balancear la carga de la ejecución fragmentada.

Muestra
long

run

public void run (TestInformation testInfo, 
                ITestInvocationListener listener)

Ejecuta las pruebas y le informa el resultado al objeto de escucha.

Parámetros
testInfo	TestInformation: Es el objeto TestInformation que contiene información útil para ejecutar pruebas.
listener	ITestInvocationListener: El ITestInvocationListener de los resultados de la prueba

Arroja
DeviceNotAvailableException

setAbi

public void setAbi (IAbi abi)

Parámetros
abi	IAbi

setBuild

public void setBuild (IBuildInfo buildInfo)

Parámetros
buildInfo	IBuildInfo

setCollectTestsOnly

public void setCollectTestsOnly (boolean shouldCollectTest)

Habilita o inhabilita el modo de recopilación de pruebas.

setConfiguration

public void setConfiguration (IConfiguration configuration)

Inserta el IConfiguration en uso.

Parámetros
configuration	IConfiguration

setDevice

public void setDevice (ITestDevice device)

Inserta el dispositivo en prueba.

Parámetros
device	ITestDevice: El ITestDevice que se usará

setOptionToLoadedObject

public static void setOptionToLoadedObject (Object testObj, 
                 keyValueOptions)

Es un asistente para que los ejecutores de dispositivos establezcan opciones de la misma manera que HostTest, desde set-option.

Parámetros
testObj	Object: Es el objeto que recibirá las opciones.
keyValueOptions	: Es la lista de opciones con el formato que requiere set-option de HostTest.

setTestInformation

public void setTestInformation (TestInformation testInfo)

Parámetros
testInfo	TestInformation

división

public  split (Integer shardCount, 
                TestInformation testInfo)

Dividimos los datos por persona, ya sea por clase o método de prueba.

Parámetros
shardCount	Integer: Es el recuento de fragmentos intentado.
testInfo	TestInformation: El TestInformation principal

Muestra
	Colección de subpruebas que se ejecutarán por separado o null si la prueba no se puede fragmentar actualmente

Métodos protegidos

createHostTest

protected HostTest createHostTest (Class<?> classObj)

Es un asistente para crear una instancia de HostTest cuando se realiza el sharding. Anula para devolver cualquier elemento secundario de HostTest.

Parámetros
classObj	Class

Muestra
HostTest

getBuild

protected IBuildInfo getBuild ()

Obtiene la información de compilación que recibió HostTest.

Muestra
IBuildInfo	el IBuildInfo

getClassLoader

protected ClassLoader getClassLoader ()

Devuelve el cargador de clases predeterminado.

Muestra
ClassLoader

getClasses

protected final  getClasses ()

Muestra

getJarFile

protected File getJarFile (String jarName, 
                TestInformation testInfo)

Inspecciona varias ubicaciones donde suelen encontrarse los artefactos para diferentes casos de uso y busca nuestro archivo JAR.

Parámetros
jarName	String
testInfo	TestInformation

Muestra
File

hasJUnit4Annotation

protected boolean hasJUnit4Annotation (Class<?> classObj)

Es un asistente para determinar si se trata de una clase de prueba con anotaciones de JUnit4.

Parámetros
classObj	Class

Muestra
boolean

loadObject

protected Object loadObject (Class<?> classObj)

Carga el objeto de clase y establece la información de la prueba (dispositivo, compilación).

Parámetros
classObj	Class

Muestra
Object

setClassName

protected void setClassName (String className)

Borra y, luego, establece un nombre de clase para ejecutar.

Parámetros
className	String

shouldTestRun

protected boolean shouldTestRun (AnnotatedElement annotatedElement)

Verifica si un elemento que tiene una anotación pasa el filtro. Se expone para pruebas de unidades.

Muestra
boolean	Es falso si no se debe ejecutar la prueba.