La API de pruebas de unidades de Glance te permite probar tu código de Glance sin inflar vistas ni necesitar un automatizador de IU. Por ejemplo, la API de pruebas unitarias te permite verificar condiciones, como si los elementos están en una lista o si se marcaron casillas de verificación, con comparadores como hasContentDescriptionEqualTo
o isChecked
.
Esta API es ligera y requiere menos configuración, por lo que puedes realizar un desarrollo basado en pruebas a medida que desarrollas partes individuales de tu widget y las organizas para mejorar la reutilización del código.
Configuración
En los siguientes ejemplos, se muestran las dependencias necesarias para usar la biblioteca de pruebas de unidades:
// Other Glance and Compose runtime dependencies.
...
testImplementation 'androidx.glance:glance-testing:1.1.1'
testImplementation 'androidx.glance:glance-appwidget-testing:1.1.1'
testImplementation 'org.robolectric:robolectric:4.11.1'
...
// You may include additional dependencies, such as Robolectric, if your test
// needs to set a LocalContext.
Estructura de la prueba
Organiza las funciones de componibilidad fuera de la clase GlanceAppWidget
para habilitar la reutilización del código y las pruebas de unidades. Reduce la complejidad de las unidades que se probarán tanto como sea posible.
class MyGlanceComposableTest {
@Test
fun myNewsItemComposable_largeSize_hasAuthorAsSubtitle() = runGlanceAppWidgetUnitTest {
// Prepare inputs and state
setAppWidgetSize(100.dp, 100.dp)
// Set the composable under test
provideComposable {
MyNewsItemComposable(TEST_NEWS_ITEM)
}
// Perform assertions
onNode(hasTestTag("subTitle"))
.assertHasText(TEST_NEWS_ITEM.authorName)
}
}
Establece el contexto y el tamaño de la prueba
Si tu función componible lee el contexto con el método LocalContext.current()
, debes establecer un contexto con setContext()
. De lo contrario, este paso es opcional.
Puedes usar cualquier framework de pruebas de unidades de Android basado en JVM, como Robolectric, para proporcionar el contexto.
Si tu función de componibilidad accede a LocalSize
, establece el tamaño previsto para la prueba antes de proporcionar una función de componibilidad en la prueba. El tamaño predeterminado es de 349 dp x 455 dp, lo que equivale a un widget de 5 x 4 que se muestra en un dispositivo Pixel 4 en modo vertical.
- Si tu AppWidget usa
sizeMode == Single
, puedes establecerlo enminWidth
yminHeight
en el archivoinfo.xml
de tu widget. - Si tu AppWidget usa
sizeMode == Exact
, puedes identificar los tamaños para probar de manera similar a como determinas un tamaño para tu widget y, luego, identificar los tamaños horizontal y vertical en los que puede aparecer tu widget y realizar pruebas para ellos. - Si tu AppWidget usa
sizeMode == Responsive
, puedes establecerlo en uno de los tamaños de la lista que proporcionas cuando especificas elsizeMode
.
La duración predeterminada para el tiempo de espera de una prueba es de 1 segundo, pero puedes pasar una duración personalizada como argumento al método runGlanceAppWidgetUnitTest
si tu infraestructura de pruebas aplica un tiempo de espera diferente.
Para obtener más información y ejemplos de código, consulta la documentación de referencia de runGlanceAppWidgetUnitTest
.