La herramienta androidtestrunner
Introducción
La herramienta « androidtestrunner » ejecuta Qt Tests en dispositivos y emuladores Android. Automatiza los pasos necesarios para ejecutar las pruebas, incluyendo la gestión de la instalación de los APK, la ejecución de las pruebas y la obtención de los resultados.
Antes de utilizar la herramienta « androidtestrunner », asegúrate de haber configurado tu proyecto de Qt Test con CMake o qmake.
Cómo funciona
- En primer lugar, comienza ejecutando el comando de compilación del APK para generar el APK necesario para la prueba.
- A continuación, instala la aplicación de prueba en el dispositivo de destino y la inicia, poniendo en marcha el proceso de prueba.
- Los resultados de las pruebas se guardan en el directorio de datos de la aplicación en el dispositivo, lo que garantiza que se recojan todos los resultados de las pruebas.
- Una vez finalizadas las pruebas, el ejecutor crea un archivo de código de salida junto a los archivos de resultados.
- En esta fase, el «
androidtestrunner» recupera estos archivos de resultados del dispositivo y examina el código de salida en busca de fallos. - Si se detectan problemas, muestra inmediatamente los registros «logcat» de la aplicación, incluyendo cualquier posible traza de pila de fallos, que se formatean para mostrar los nombres de los archivos y los números de línea de cada fotograma. Además, captura y notifica los registros de «Aplicación sin respuesta» (ANR) si se producen dichos eventos durante la ejecución de la prueba.
Para mejorar la experiencia de integración, el ejecutor de pruebas propaga las variables de entorno QT o Qt Test desde el entorno del host del proceso del ejecutor de pruebas a la aplicación, lo que garantiza la coherencia y un flujo de trabajo de pruebas fluido.
Ejecución de pruebas con el envoltorio de pruebas
Qt genera un script de envoltura específico para cada destino junto con cada prueba de Android (cuyo nombre se basa en el destino de la prueba) que invoca androidtestrunner con las rutas correctas y reenvía cualquier argumento adicional al binario de prueba. El ejemplo siguiente ejecuta tst_android en un emulador específico, reenvía una variable de entorno de Qt y ejecuta únicamente el caso de prueba testAssets:
ANDROID_SERIAL=emulator-5554 QT_DEBUG_PLUGINS=1 ./tst_android testAssetsObtención de resultados
Por defecto, y si la salida de prueba a stdout no se desactiva explícitamente, los resultados de la prueba se envían al host a medida que se ejecuta la prueba. Tras ejecutar las pruebas, los archivos de prueba solicitados explícitamente se guardan en la ruta de salida especificada con sus respectivos formatos.
Para obtener información detallada sobre el marco « Qt Test », consulta la Descripción general de «Qt Test ».
Cómo utilizarlo
La sintaxis básica para ejecutar el comando « androidtestrunner » es la siguiente:
androidtestrunner [ARGUMENTS] -- [TESTARGS]Para ejecutar la prueba en un dispositivo o emulador específico, pasa --serial <serial> o configura la variable de entorno adb como ANDROID_SERIAL o ANDROID_DEVICE_SERIAL. La opción explícita tiene prioridad.
Argumentos obligatorios
El ejecutor de pruebas siempre espera que se le pasen los siguientes argumentos:
--path <build-path>: La ruta donde se compila el paquete Gradle de Android, normalmente<build-dir>/android-build-<target>.--make <build-command>: El comando utilizado para compilar el APK de prueba, por ejemplo,cmake --build <build-dir> --target <target>_make_apk.Nota: Pasa este argumento entre comillas para que no se interprete como varios argumentos del ejecutor de pruebas, sino como el valor del argumento «
--make».- Una de las siguientes opciones:
--apk <apk-path>: Ruta al APK de prueba generado por el comando de compilación e instalado en el dispositivo.--aab <aab-path>: Ruta al AAB de prueba; requiere--bundletool. No se pueden establecer ambas opciones al mismo tiempo, y ninguna de ellas puede especificarse más de una vez.
Argumentos opcionales
También puedes pasar los siguientes argumentos opcionales:
--bundletool <path>: Ruta al archivo JAR de «bundletool» de Android. Obligatorio cuando se utiliza «--aab».--manifest <path>: Ruta personalizada de «AndroidManifest.xml». Por defecto, se utiliza un archivo que se encuentra en la ruta de compilación o en su subdirectorio «app/».--adb <adb-path>: Especifica una ruta personalizada para los comandos ADB. Por defecto, es la ruta de «adb» que se encuentra en el directorio «$PATH» del sistema.--serial <serial>: Número de serie del dispositivo Android de destino. Anula los valores de «ANDROID_SERIAL» y «ANDROID_DEVICE_SERIAL».--activity <activity-name>: Especifica una actividad personalizada que se va a ejecutar. El valor por defecto es la primera actividad definida en `AndroidManifest.xml`.--timeout <seconds>: Establece el tiempo de espera para la ejecución de la prueba. El valor por defecto es 600 segundos (10 minutos).--pre-test-adb-command <command>: Llama a la<command>de adb tras la instalación y antes de ejecutar la prueba. Se puede pasar varias veces.--skip-install-root: Suprime el sufijo automático de «INSTALL_ROOT=<path> install» que se añade a «--make» cuando el comando de compilación es una herramienta de «make-family» (make,gmake,nmake,mingw32-make,jom; la coincidencia no distingue entre mayúsculas y minúsculas). El sufijo nunca se añade a «cmake», «ninja» u otros controladores de compilación, por lo que esta opción solo tiene efecto con las herramientas enumeradas.--ndk-stack <command-path>: Especifica la ruta a la herramienta ndk-stack para simbolizar las trazas de pila de fallos. Por defecto, se utiliza la ruta de la herramienta que se encuentra en$ANDROID_NDK_ROOT.--show-logcat: Muestra la salida de logcat en stdout independientemente de si la prueba falla. Lee los búferes principal, del sistema y de fallos, e incluye líneas desystem_servercuando se detecta un ANR.--verbose: Muestra una salida detallada.-- <arguments>: Pasa todo lo que haya después de los guiones como argumentos de la prueba.--help: Muestra la información de ayuda.
Ejemplo de uso
A continuación se muestra un ejemplo que ejecuta la prueba « tst_android », ejecutando únicamente el caso de prob testAssets:
androidtestrunner \
--path ~/tst_android/build/android-build-tst_openssl \
--make "cmake --build ~/tst_android/build --target apk" \
--apk ~/tst_android/build/android-build-tst_openssl/tst_openssl.apk \
testAssets© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.