Espresso-Intents es una extensión de Espresso que permite la validación y el stubbing de los intents que envía la aplicación que se está probando. Es como Mockito, pero para intents de Android.
Si tu app delega funciones a otras apps o a la plataforma, puedes usar Espresso-Intents para enfocarte en la lógica de tu propia app y suponer que otras apps o la plataforma funcionarán correctamente. Con Espresso-Intents, puedes hacer coincidir y validar los intents salientes o incluso proporcionar respuestas de stub en lugar de respuestas de intents reales.
Cómo incluir Espresso-Intents en tu proyecto
En el archivo app/build.gradle de tu app, agrega la siguiente línea dentro de
dependencies:
Groovy
androidTestImplementation 'androidx.test.espresso:espresso-intents:3.6.1'
Kotlin
androidTestImplementation('androidx.test.espresso:espresso-intents:3.6.1')
Espresso-Intents solo es compatible con Espresso 2.1 y versiones posteriores, y con la versión 0.3 y posteriores de las bibliotecas de pruebas de Android, por lo que también debes asegurarte de actualizar esas líneas:
Groovy
androidTestImplementation 'androidx.test:runner:1.6.1' androidTestImplementation 'androidx.test:rules:1.6.1' androidTestImplementation 'androidx.test.espresso:espresso-core:3.6.1'
Kotlin
androidTestImplementation('androidx.test:runner:1.6.1') androidTestImplementation('androidx.test:rules:1.6.1') androidTestImplementation('androidx.test.espresso:espresso-core:3.6.1')
Cómo escribir reglas de prueba
Antes de escribir una prueba de Espresso-Intents, configura una IntentsTestRule. Esta es una extensión de la clase ActivityTestRule y facilita el uso de las APIs de Espresso-Intents en las pruebas de IU funcionales. Una IntentsTestRule inicializa Espresso-Intents antes de cada prueba anotada con @Test y libera Espresso-Intents después de cada ejecución de prueba.
El siguiente fragmento de código es un ejemplo de una IntentsTestRule:
@get:Rule val intentsTestRule = IntentsTestRule(MyActivity::class.java)
Coincidencia
Espresso-Intents proporciona la capacidad de interceptar intents salientes según ciertos criterios de coincidencia, que se definen con comparadores de Hamcrest. Hamcrest te permite hacer lo siguiente:
- Usa un comparador de intents existente: Es la opción más sencilla, que casi siempre se debe preferir.
- Implementar tu propio buscador de coincidencias de intent: es la opción más flexible. Puedes encontrar más detalles en la sección "Cómo escribir comparadores personalizados" del instructivo de Hamcrest.
Espresso-Intents ofrece los métodos intended() y intending() para la validación y la creación de stub de intents, respectivamente. Ambos toman un objeto Matcher<Intent> de Hamcrest como argumento.
En el siguiente fragmento de código, se muestra la validación de intents que usa comparadores de intents existentes que coinciden con un intent saliente que inicia un navegador:
assertThat(intent).hasAction(Intent.ACTION_VIEW) assertThat(intent).categories().containsExactly(Intent.CATEGORY_BROWSABLE) assertThat(intent).hasData(Uri.parse("www.google.com")) assertThat(intent).extras().containsKey("key1") assertThat(intent).extras().string("key1").isEqualTo("value1") assertThat(intent).extras().containsKey("key2") assertThat(intent).extras().string("key2").isEqualTo("value2")
Cómo validar intents
Espresso-Intents registra todos los intents que intentan iniciar actividades desde la aplicación que se está probando. Con el método intended(), que es similar a Mockito.verify(), puedes confirmar que se vio un intent determinado. Sin embargo, Espresso-Intents no genera respuestas de stub para intents, a menos que lo configures de forma explícita para que lo haga.
En el siguiente fragmento de código, se muestra una prueba de ejemplo que valida, pero no genera respuestas de stub para un intent saliente que inicia una actividad externa de "teléfono":
@Test fun validateIntentSentToPackage() { // User action that results in an external "phone" activity being launched. user.clickOnView(system.getView(R.id.callButton)) // Using a canned RecordedIntentMatcher to validate that an intent resolving // to the "phone" activity has been sent. intended(toPackage("com.android.phone")) }
Cómo implementar stubs
Con el método intending(), que es similar a Mockito.when(), puedes proporcionar una respuesta de stub para las actividades que se inician con startActivityForResult(). Esto es particularmente útil para las actividades externas, ya que no puedes manipular la interfaz de usuario de una actividad externa ni controlar el ActivityResult que se devuelve a la actividad que se está probando.
En los siguientes fragmentos de código, se implementa una prueba de activityResult_DisplaysContactsPhoneNumber() de ejemplo, que verifica que, cuando un usuario inicia una actividad de "contacto" en la app que se está probando, se muestra el número de teléfono de contacto:
Compila el resultado que se mostrará cuando se inicie una actividad en particular. La prueba de ejemplo intercepta todos los intents enviados a "contacts" y genera respuestas de stub con un
ActivityResultválido, usando el código de resultadoRESULT_OK.val resultData = Intent() val phoneNumber = "123-345-6789" resultData.putExtra("phone", phoneNumber) val result = Instrumentation.ActivityResult(Activity.RESULT_OK, resultData)
Indica a Espresso que proporcione el objeto de resultado de stub en respuesta a todas las invocaciones del intent "contacts":
intending(toPackage("com.android.contacts")).respondWith(result)
Verifica que la acción que se usó para iniciar la actividad produzca el resultado de stub esperado. En este caso, la prueba de ejemplo verifica que se devuelva y muestre el número de teléfono "123-345-6789" cuando se inicia la "actividad de contactos":
onView(withId(R.id.pickButton)).perform(click()) onView(withId(R.id.phoneNumber)).check(matches(withText(phoneNumber)))
Esta es la prueba completa de activityResult_DisplaysContactsPhoneNumber():
@Test fun activityResult_DisplaysContactsPhoneNumber() { // Build the result to return when the activity is launched. val resultData = Intent() val phoneNumber = "123-345-6789" resultData.putExtra("phone", phoneNumber) val result = Instrumentation.ActivityResult(Activity.RESULT_OK, resultData) // Set up result stubbing when an intent sent to "contacts" is seen. intending(toPackage("com.android.contacts")).respondWith(result) // User action that results in "contacts" activity being launched. // Launching activity expects phoneNumber to be returned and displayed. onView(withId(R.id.pickButton)).perform(click()) // Assert that the data we set up above is shown. onView(withId(R.id.phoneNumber)).check(matches(withText(phoneNumber))) }
Recursos adicionales
Para obtener más información sobre el uso de Espresso-Intents en pruebas de Android, consulta los siguientes recursos.
Ejemplos
- IntentsBasicSample:
Uso básico de
intended()yintending(). - IntentsAdvancedSample: Simula que un usuario recupera un mapa de bits con la cámara.