A partir del 27 de marzo de 2025, te recomendamos que uses android-latest-release en lugar de aosp-main para compilar y contribuir a AOSP. Para obtener más información, consulta Cambios en AOSP.

Se usó la API de Cloud Translation para traducir esta página.

HostTest

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

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

Subclases directas conocidas

JarHostTest

JarHostTest Ejecutor de pruebas para pruebas JUnit del host.

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

Resumen

Campos
`public static final String`	`SET_OPTION_DESC`
`public static final String`	`SET_OPTION_NAME`

Constructores públicos
`HostTest()`

Métodos públicos
`void`	`addAllExcludeAnnotation( notAnnotations)` Se agrega un `ERROR(/Set)` de anotaciones para excluir si una prueba está marcada con él.
`void`	`addAllExcludeFilters( filters)` Agrega el `ERROR(/Set)` de filtros de las pruebas que se deben excluir.
`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 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 de las que se realiza un seguimiento actualmente.
`void`	`clearExcludeFilters()` Borrar todos los filtros de exclusión de los que se realiza un seguimiento actualmente
`void`	`clearIncludeAnnotations()` Borra todas las anotaciones de inclusión de las que se realiza un seguimiento actualmente.
`void`	`clearIncludeFilters()` Borra todos los filtros de inclusión de los que se realiza un seguimiento 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()` Muestra el `ERROR(/Set)` actual de las anotaciones que se deben excluir.
	`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()` Muestra el tiempo de ejecución esperado de la prueba en milisegundos.
`void`	`run(TestInformation testInfo, ITestInvocationListener listener)` Ejecuta las pruebas y, luego, informa los resultados 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)` Inyecta el `IConfiguration` en uso.
`void`	`setDevice(ITestDevice device)` Inyecta el dispositivo en prueba.
`static void`	`setOptionToLoadedObject(Object testObj, keyValueOptions)` Es un asistente para que los ejecutores de dispositivos usen para configurar opciones de la misma manera que HostTest, desde set-option.
`void`	`setTestInformation(TestInformation testInfo)`
	`split(Integer shardCount, TestInformation testInfo)` Dividimos los datos por persona según la clase o el método de prueba.

Métodos protegidos
`HostTest`	`createHostTest(Class<?> classObj)` Es un auxiliar para crear una instancia de HostTest cuando se fragmenta.
`IBuildInfo`	`getBuild()` Obtén la información de compilación que recibió HostTest.
`ClassLoader`	`getClassLoader()` Muestra el cargador de clases predeterminado.
`final`	`getClasses()`
`File`	`getJarFile(String jarName, TestInformation testInfo)` Inspecciona varias ubicaciones en las que suele ubicarse el artefacto para diferentes casos de uso para encontrar nuestro jar.
`boolean`	`hasJUnit4Annotation(Class<?> classObj)` Ayudante para determinar si estamos tratando con 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 que se ejecute.
`boolean`	`shouldTestRun(AnnotatedElement annotatedElement)` Verifica si un elemento que tiene anotación pasa el filtro.

Campos

SET_OPTION_DESC

public static final String SET_OPTION_DESC

SET_OPTION_NAME

public static final String SET_OPTION_NAME

Constructores públicos

HostTest

public HostTest ()

Métodos públicos

addAllExcludeAnnotation

public void addAllExcludeAnnotation ( notAnnotations)

Se 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 filtros de las pruebas que se deben excluir.

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 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 de las que se realiza un seguimiento actualmente.

clearExcludeFilters

public void clearExcludeFilters ()

Borrar todos los filtros de exclusión de los que se realiza un seguimiento actualmente

clearIncludeAnnotations

public void clearIncludeAnnotations ()

Borra todas las anotaciones de inclusión de las que se realiza un seguimiento actualmente.

clearIncludeFilters

public void clearIncludeFilters ()

Borra todos los filtros de inclusión de los que se realiza un seguimiento 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 en prueba.

Muestra
`ITestDevice`	el `ITestDevice`

getExcludeAnnotations

public  getExcludeAnnotations ()

Muestra el ERROR(/Set) actual de las anotaciones que se deben excluir.

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 ()

Muestra el tiempo de ejecución esperado de la prueba en milisegundos. El tiempo 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, luego, informa los resultados 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)

Inyecta el IConfiguration en uso.

Parámetros
`configuration`	`IConfiguration`

setDevice

public void setDevice (ITestDevice device)

Inyecta el dispositivo en prueba.

Parámetros
`device`	`ITestDevice`: Es el `ITestDevice` que se usará.

setOptionToLoadedObject

public static void setOptionToLoadedObject (Object testObj, 
                 keyValueOptions)

Es un asistente para que los ejecutores de dispositivos usen para configurar 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 la opción 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 según la clase o el método de prueba.

Parámetros
`shardCount`	`Integer`: Es el recuento de fragmentos que se intentó.
`testInfo`	`TestInformation`: El elemento superior `TestInformation`

Muestra
	una colección de pruebas secundarias que se ejecutarán por separado o `null` si la prueba no se puede particionar en este momento

Métodos protegidos

createHostTest

protected HostTest createHostTest (Class<?> classObj)

Es un auxiliar para crear una instancia de HostTest cuando se fragmenta. Anula para mostrar cualquier elemento secundario de HostTest.

Parámetros
`classObj`	`Class`

Muestra
`HostTest`

getBuild

protected IBuildInfo getBuild ()

Obtén la información de compilación que recibió HostTest.

Muestra
`IBuildInfo`	el `IBuildInfo`

getClassLoader

protected ClassLoader getClassLoader ()

Muestra el cargador de clases predeterminado.

Muestra
`ClassLoader`

getClasses

protected final  getClasses ()

Muestra

getJarFile

protected File getJarFile (String jarName, 
                TestInformation testInfo)

Inspecciona varias ubicaciones en las que suele ubicarse el artefacto para diferentes casos de uso para encontrar nuestro jar.

Parámetros
`jarName`	`String`
`testInfo`	`TestInformation`

Muestra
`File`

hasJUnit4Annotation

protected boolean hasJUnit4Annotation (Class<?> classObj)

Ayudante para determinar si estamos tratando con 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 que se ejecute.

Parámetros
`className`	`String`

shouldTestRun

protected boolean shouldTestRun (AnnotatedElement annotatedElement)

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

Muestra
`boolean`	Es falso si la prueba no debe ejecutarse.