Recorridos para Android Studio

Organiza tus páginas con colecciones Guarda y categoriza el contenido según tus preferencias.

Crear recorridos para Android Studio ayuda a que las pruebas de extremo a extremo sean fáciles de escribir y mantener, ya que te permite usar lenguaje natural para describir los pasos y las aserciones de cada prueba, lo que se denomina recorrido. Cuando aprovechas las capacidades de visión y razonamiento de Gemini, los pasos escritos en lenguaje natural se convierten en acciones que Gemini realiza en tu app, lo que facilita la escritura y la comprensión de tus recorridos. Además, puedes escribir y describir afirmaciones más complejas, que Gemini evalúa en función de lo que ve en el dispositivo para determinar si tus recorridos se aprueban o no.

Y como Gemini razona sobre qué acciones realizar para satisfacer los objetivos, los recorridos son más resistentes a los cambios sutiles en el diseño o el comportamiento de tu app, lo que genera menos pruebas inestables cuando se ejecutan en diferentes versiones de tu app y diferentes configuraciones de dispositivos.

Escribe y ejecuta recorridos directamente desde Android Studio en cualquier dispositivo Android local o remoto. El IDE proporciona una nueva experiencia de editor para crear recorridos, así como resultados enriquecidos que te ayudan a seguir mejor el razonamiento y la ejecución de tu recorrido de Gemini.

Escribe un recorrido

Android Studio proporciona una plantilla de archivo y una nueva experiencia de editor que facilitan la creación y edición de recorridos. Los recorridos se escriben con la sintaxis XML para organizar la descripción y los pasos de tu recorrido.

Para crear y comenzar a editar un recorrido, haz lo siguiente:

1. En el panel Project de Android Studio, haz clic con el botón derecho en el módulo de la app para el que deseas escribir un recorrido.
2. Selecciona New > Test > Journey File.
3. En el diálogo que aparece, proporciona el nombre y la descripción de tu viaje.
4. Haz clic en OK. Android Studio crea un archivo en formato XML para tu recorrido con el nombre que elegiste. Puedes usar la vista Code para editar el archivo en formato XML directamente o la vista Design para mejorar la experiencia de edición.
5. Cuando veas tu recorrido en la vista Design, usa el campo de texto para describir cada paso del recorrido. Cada paso puede incluir acciones descriptivas que deseas que Gemini realice o aserciones que deseas que Gemini evalúe.
6. Presiona Intro en el teclado para comenzar una instrucción nueva en el mismo recorrido. Puedes repetir este proceso según sea necesario para cada paso del recorrido que desees definir.

Sugerencias para escribir recorridos

Escribir tus recorridos de forma detallada y organizada puede aumentar la probabilidad de que Gemini ejecute con precisión los recorridos que deseas de una manera más determinista. Estas son algunas sugerencias para ayudarte a escribir tus recorridos de manera más eficaz:

• Evita las acciones únicas explícitas: Gemini puede convertir cada paso de tu recorrido en varias acciones. Evita escribir instrucciones que sean acciones únicas explícitas, como "haz clic en X", ya que el modelo está entrenado para lograr objetivos complejos.
• Separa las aserciones de las acciones: Gemini evalúa constantemente el estado de tu app para determinar si está en un estado "correcto" para continuar el recorrido. Sin embargo, es posible que debas definir aserciones más complejas como un paso independiente. Además, comienza cada instrucción con frases clave, como "Verifica que", "Confirma que" o "Revisa que" para informarle a Gemini que este paso debe ser una aserción.
• Dirige Gemini con deslizamientos: Además de las interacciones básicas, como presionar o ingresar texto con el teclado, Gemini admite acciones que requieren que se deslice la pantalla en ciertas direcciones. Por ejemplo, para desplazarte por el contenido o descartar parte de la IU, simplemente describe la dirección y el propósito de tu acción de deslizamiento. De forma predeterminada, Gemini se desliza desde el centro de la pantalla, pero puedes guiarlo para que se deslice en una parte diferente de la pantalla del dispositivo.
• Evita otras interacciones complejas y cambios de configuración: Actualmente, Gemini no admite todas las interacciones y cambios de configuración, como gestos con varios dedos, rotaciones de pantalla o acciones de plegado. El equipo está trabajando para mejorar las capacidades de Gemini.

Ejecuta tu recorrido

Puedes ejecutar tu recorrido en cualquier dispositivo local o remoto disponible, similar a cualquier otra prueba de instrumentación, y Android Studio genera resultados enriquecidos que te ayudan a comprender la ejecución de tu recorrido.

Para probar un recorrido, haz lo siguiente:

1. Selecciona un dispositivo de destino en la barra de herramientas principal, como lo harías cuando ejecutas una prueba instrumentada.
2. Navega al archivo en formato XML de viaje que deseas probar y ábrelo en el editor.
3. En el editor, realiza una de las siguientes acciones:
   1. Si estás en la vista Design, haz clic en Run Journey.
   2. Si estás en la vista Code, haz clic en Run en el margen junto a donde se define el nombre del recorrido en el archivo XML.

Android Studio crea una configuración de prueba de Journeys por ti y la ejecuta en el dispositivo de destino. Durante la ejecución, Android Studio compila e implementa tu app, y se conecta a Gemini para determinar qué acciones realizar en cada paso del recorrido.

Los resultados limitados también se muestran en el editor mientras se ejecuta un recorrido, como las capturas de pantalla, las acciones realizadas y el razonamiento durante la ejecución de cada paso del recorrido. Solo coloca el cursor sobre la miniatura en el editor para ver más información. Esto puede ser útil cuando iteres en las instrucciones de tu recorrido.

Ver los resultados

Cuando Android Studio complete la prueba de tu recorrido, el panel de resultados de la prueba aparecerá automáticamente para mostrarte los resultados.

En comparación con otras pruebas instrumentadas que puedes ejecutar en Android Studio, hay algunas diferencias en la forma en que se muestran los resultados de los recorridos.

• El panel Pruebas desglosa el recorrido en pasos discretos. Puedes hacer clic en cada paso para obtener más información sobre cómo lo ejecutó Gemini.
• El panel Resultados muestra información valiosa para ayudarte a comprender cómo Gemini comprende y razona sobre tu recorrido y cómo se ejecutó.
• Las capturas de pantalla que se enviaron a Gemini se muestran como ayuda visual en cada acción del paso.
• Cada acción que se realizó y el razonamiento de Gemini para realizarla se describen junto a cada captura de pantalla.
• Cada acción del paso está numerada.

Problemas conocidos

• Cuando se prueba un viaje, se otorgan todos los permisos de la app de forma predeterminada.
• Cuando pruebes un recorrido en un dispositivo que ejecute Android 15 (nivel de API 35), es posible que veas una advertencia en el dispositivo que diga "Se bloqueó la app no segura" para "AndroidX Crawler". Puedes hacer clic en Instalar de todos modos para omitir esta verificación. Como alternativa, puedes configurar las opciones para desarrolladores en el dispositivo y, luego, inhabilitar la opción para verificar apps por USB.
• Por el momento, los archivos de viaje no aparecen en la vista Android del panel Projects. Para ver los archivos de recorrido en tu proyecto, usa la vista Project.
• Si varias acciones dentro de un recorrido comparten la misma instrucción, es posible que los resultados de la prueba que se muestran en el editor de recorridos sean incorrectos. Específicamente, todas las acciones con la instrucción duplicada mostrarán los resultados de la prueba asociados con la instancia más reciente de esa instrucción. Para solucionar este problema, asegúrate de que cada acción tenga una instrucción única, por ejemplo, agregando un prefijo o sufijo distinto.
• Aparece una ventana emergente de la pluma stylus la segunda vez que se carga el teclado en un emulador nuevo. Por lo general, esta ventana emergente hace que fallan las pruebas que interactúan con campos de texto. Cuando esto suceda, descarta la ventana emergente y vuelve a ejecutar el recorrido.
• En ocasiones, los artefactos del rastreador de aplicaciones pueden aparecer en la justificación del agente.
• En ocasiones, la ejecución del recorrido falla con un IllegalStateException. Cuando esto suceda, puedes hacer clic en Resultados de la prueba para ver el error completo.

• Si el complemento de Android para Gradle (com.android.application) no está definido en el archivo build.gradle de nivel superior, es posible que veas el siguiente error cuando ejecutes un recorrido:

  Failed to apply plugin class 'com.android.tools.journeys.JourneysGradlePlugin'
  

  Para resolver este problema, asegúrate de que el complemento esté definido en el archivo build.gradle de nivel superior. Consulta Cómo configurar el sistema de compilación de Android para obtener más información.