A partir de 2026, para alinearnos con nuestro modelo de desarrollo llamado Trunk Stable y garantizar la estabilidad de la plataforma para el ecosistema, publicaremos el código fuente en el AOSP en el segundo y cuarto trimestre. Para compilar el AOSP y contribuir a él, usa android-latest-release. La rama del manifiesto android-latest-release siempre hará referencia a la versión más reciente que se envió al AOSP. Para obtener más información, consulta Cambios en el AOSP.

Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

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 auxiliar que proporciona los servicios IRemoteTest y IDeviceTest.

Esto es útil si deseas implementar pruebas que sigan el patrón de JUnit para definir pruebas y, aun así, tener compatibilidad total con otras funciones de tradefed, como Option.

Resumen

Campos
`protected Set<String>`	`mExcludeAnnotation` Anotaciones de exclusión de la prueba que se ejecutará
`protected Set<String>`	`mExcludeFilters` Filtros de exclusión del nombre de la prueba que se ejecutará
`protected Set<String>`	`mIncludeAnnotation` Anotaciones que se incluyen en la prueba que se ejecutará
`protected Set<String>`	`mIncludeFilters` Son 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(Set<String> notAnnotations)` Agrega un `Set` de anotaciones para excluir si una prueba está marcada con él.
`void`	`addAllExcludeFilters(Set<String> filters)` Agrega el `Set` de los filtros de las pruebas que se excluirán.
`void`	`addAllIncludeAnnotation(Set<String> annotations)` Agrega un `Set` de anotaciones para incluir si una prueba está marcada con él.
`void`	`addAllIncludeFilters(Set<String> filters)` Agrega el `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 qué pruebas 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()`
`ITestDevice`	`getDevice()` Obtén el dispositivo que se probará.
`Set<String>`	`getExcludeAnnotations()` Devuelve el `Set` actual de las anotaciones que se excluirán.
`Set<String>`	`getExcludeFilters()` Devuelve el `Set` actual de los filtros de exclusión.
`Set<String>`	`getIncludeAnnotations()` Devuelve el `Set` actual de las anotaciones que se incluirán.
`Set<String>`	`getIncludeFilters()` Devuelve el `Set` actual de los filtros de inclusión.
`void`	`run(TestResult result)` Anula el método principal 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 le informa el resultado al objeto de escucha.
`void`	`setCollectTestsOnly(boolean shouldCollectTest)` Habilita o inhabilita el modo de recopilación de pruebas
`void`	`setDevice(ITestDevice device)` Inserta el dispositivo en prueba.

Campos

mExcludeAnnotation

protected Set<String> mExcludeAnnotation

Anotaciones de exclusión de la prueba que se ejecutará

mExcludeFilters

protected Set<String> mExcludeFilters

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

mIncludeAnnotation

protected Set<String> mIncludeAnnotation

Anotaciones que se incluyen en la prueba que se ejecutará

mIncludeFilters

protected Set<String> mIncludeFilters

Son 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 (Set<String> notAnnotations)

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

Parámetros
`notAnnotations`	`Set`

addAllExcludeFilters

public void addAllExcludeFilters (Set<String> filters)

Agrega el Set de los filtros de las pruebas que se excluirán.

Parámetros
`filters`	`Set`

addAllIncludeAnnotation

public void addAllIncludeAnnotation (Set<String> annotations)

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

Parámetros
`annotations`	`Set`

addAllIncludeFilters

public void addAllIncludeFilters (Set<String> filters)

Agrega el Set de los filtros de las pruebas que se incluirán.

Parámetros
`filters`	`Set`

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 qué pruebas 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 ()

Muestra
`int`

getDevice

public ITestDevice getDevice ()

Obtén el dispositivo que se probará.

Muestra
`ITestDevice`	`ITestDevice`

getExcludeAnnotations

public Set<String> getExcludeAnnotations ()

Devuelve el Set actual de las anotaciones que se excluirán.

Muestra
`Set<String>`

getExcludeFilters

public Set<String> getExcludeFilters ()

Devuelve el Set actual de los filtros de exclusión.

Muestra
`Set<String>`

getIncludeAnnotations

public Set<String> getIncludeAnnotations ()

Devuelve el Set actual de las anotaciones que se incluirán.

Muestra
`Set<String>`

getIncludeFilters

public Set<String> getIncludeFilters ()

Devuelve el Set actual de los filtros de inclusión.

Muestra
`Set<String>`

run

public void run (TestResult result)

Anula el método principal 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 envolvié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 imposibilita 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 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`

setCollectTestsOnly

public void setCollectTestsOnly (boolean shouldCollectTest)

Habilita o inhabilita el modo de recopilación de pruebas

setDevice

public void setDevice (ITestDevice device)

Inserta el dispositivo en prueba.

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