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.

DeviceTestCase

public class DeviceTestCase
extends MetricTestCase implements IDeviceTest, IRemoteTest, ITestAnnotationFilterReceiver, ITestCollector, ITestFilterReceiver

java.lang.Object
↳	junit.framework.Assert
	↳	junit.framework.TestCase
		↳	com.android.tradefed.testtype.MetricTestCase
			↳	com.android.tradefed.testtype.DeviceTestCase

Caso de prueba de JUnit de ayuda que proporciona los servicios IRemoteTest y IDeviceTest.

Esto es útil si deseas implementar pruebas que sigan el patrón de definición de pruebas de JUnit y, al mismo tiempo, tener compatibilidad total con otras funciones de Tradefed, como Option.

Resumen

Campos
`protected`	`mExcludeAnnotation` Las anotaciones de exclusión de la prueba que se ejecutará
`protected`	`mExcludeFilters` Los filtros de exclusión del nombre de la prueba que se ejecutará
`protected`	`mIncludeAnnotation` Las anotaciones de inclusión de la prueba que se ejecutará
`protected`	`mIncludeFilters` Los filtros de inclusión del nombre de la prueba que se ejecutará

Constructores públicos
`DeviceTestCase()`
`DeviceTestCase(String name)`

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()`
`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.
`void`	`run(TestResult result)` Anula el método superior para ejecutar todos los métodos de prueba si el método de prueba que se ejecutará es nulo.
`void`	`run(TestInformation testInfo, ITestInvocationListener listener)` Ejecuta las pruebas y, luego, informa los resultados al objeto de escucha.
`void`	`setCollectTestsOnly(boolean shouldCollectTest)` Habilita o inhabilita el modo de recopilación de pruebas
`void`	`setDevice(ITestDevice device)` Inyecta el dispositivo en prueba.

Campos

mExcludeAnnotation

protected  mExcludeAnnotation

Las anotaciones de exclusión de la prueba que se ejecutará

mExcludeFilters

protected  mExcludeFilters

Los filtros de exclusión del nombre de la prueba que se ejecutará

mIncludeAnnotation

protected  mIncludeAnnotation

Las anotaciones de inclusión de la prueba que se ejecutará

mIncludeFilters

protected  mIncludeFilters

Los filtros de inclusión del nombre de la prueba que se ejecutará

Constructores públicos

DeviceTestCase

public DeviceTestCase ()

DeviceTestCase

public DeviceTestCase (String name)

Parámetros
`name`	`String`

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

Muestra
`int`

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

run

public void run (TestResult result)

Anula el método superior para ejecutar todos los métodos de prueba si el método de prueba que se ejecutará es nulo.

El framework de JUnit solo admite la ejecución de todas las pruebas en un TestCase uniéndolo en un TestSuite. Lamentablemente, con este mecanismo, los llamadores no pueden controlar el ciclo de vida de sus propios casos de prueba, lo que hace imposible realizar acciones como hacer que el framework de configuración de Tradefed inserte opciones en un caso de prueba.

Parámetros
`result`	`TestResult`

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`

setCollectTestsOnly

public void setCollectTestsOnly (boolean shouldCollectTest)

Habilita o inhabilita el modo de recopilación de pruebas

setDevice

public void setDevice (ITestDevice device)

Inyecta el dispositivo en prueba.

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