App Crawler

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

Usa la herramienta App Crawler, parte de Jetpack, para probar automáticamente tu app sin necesidad de escribir ni mantener ningún código.

El rastreador se ejecuta junto con tu app y emite acciones automáticamente (presionar y deslizar, entre otras) para explorar el espacio de estado de tu app. El rastreo finaliza automáticamente cuando no hay más acciones únicas para realizar, cuando falla la app o cuando se alcanza el tiempo de espera designado.

Realizar pruebas con el rastreador es fácil porque no hay código para escribir ni mantener. Además, puedes ejecutarlo en una variedad de dispositivos con el fin de detectar fallas, problemas visuales o de rendimiento. Por lo general, es una buena idea usar un servicio basado en la nube, como Firebase Test Lab, para probar varias combinaciones de tamaños de pantalla y configuraciones de hardware de manera más fácil y rápida.

Público objetivo

App Crawler está dirigido a desarrolladores que quieren garantizar la funcionalidad básica de sus apps con una configuración mínima. Además de las pruebas de caja negra, el rastreador también se puede configurar para proporcionar entradas específicas, como credenciales de acceso o vínculos directos.

Cómo comenzar

Antes de comenzar, asegúrate de tener una versión reciente del SDK de Android. Se incluye con Android Studio. Si instalas un SDK de Android independiente, asegúrate de que incluya las herramientas de compilación y de plataforma más recientes.

Luego, descarga el archivo binario del rastreador.

A continuación, inicia un emulador o conecta un dispositivo físico mediante un cable USB. Confirma que el dispositivo está conectado ejecutando el siguiente comando:

adb devices

Para invocar el rastreador, primero extrae el archivo en el directorio que elijas. En ese directorio, invoca el rastreador mediante el siguiente comando:

java -jar crawl_launcher.jar --apk-file path/to/my/app.apk --android-sdk path/to/my/android/sdk

Opciones del rastreador

Puedes usar las siguientes opciones para invocar al rastreador:

Opción Descripción
--android-sdk path

Especifica la ruta de acceso al SDK de Android.

Esta marca es obligatoria.

--apk-file file

Especifica la ruta de acceso a la aplicación APK, que App Crawler instala y rastrea.

Esta marca es obligatoria si no se especifica --app-package-name.

--app-package-name name

Especifica el nombre del paquete de tu app. Usa esta opción cuando tu app ya esté instalada en el dispositivo y no sea necesario volver a instalarla.

Esta marca es obligatoria si no se especifica --apk-file.

--key-store path

Especifica la ruta al almacén de claves que firma la app y el APK del rastreador. Usa esta opción cuando tu app requiera una firma específica para funcionar correctamente.

--key-store-password password

Especifica la contraseña del almacén de claves que proporcionaste para la opción --key-store.

Esta marca es obligatoria si se especifica --key-store.

--timeout-sec timeout

Especifica el tiempo de espera del rastreo en segundos. Si no se especifica, el rastreo se detiene después de 60 segundos.

Errores conocidos

Error al borrar los archivos de firma originales

Antes del inicio del rastreo, es posible se muestra a los usuarios de JDK 9 el siguiente mensaje de error:

androidx.test.tools.crawler.launcher.exceptions.ApkSigningException: Failed to delete original signature files

Si experimentas este comportamiento, te recomendamos usar JDK 8 o 10+. Para obtener más información sobre este problema, consulta este error de JDK 9. Algunos usuarios solucionan el problema volviendo a compilar el APK con una versión actualizada de Android Studio.

Recursos adicionales

Para obtener más información sobre el uso de App Crawler, consulta los siguientes recursos.