La herramienta HarmonyOstRunner
Nota: Qt para HarmonyOS se encuentra en fase de vista previa tecnológica y puede sufrir cambios en futuras versiones.
Introducción
La herramienta harmonyostestrunner ejecuta una única prueba automática de Qt en un dispositivo o emulador de HarmonyOS y muestra el resultado en el equipo host. Cuando ejecutas una prueba con ctest, el envoltorio de pruebas de CMake normalmente la invoca por ti. Iníciala directamente cuando el HAP de prueba se haya compilado en un equipo pero el dispositivo esté conectado a otro, o cuando dispongas de un HAP de prueba pero no tengas a mano un árbol de compilación de CMake.
Esta herramienta no compila ni instala el paquete de prueba. En su lugar, harmonydeployqt agrupa los binarios de prueba en un único HAP de prueba (mediante su opción --test-bundle ). Debes compilar, firmar e instalar ese HAP en el dispositivo previamente:
hdc install <path/to/autotests-signed.hap>Cómo funciona
- Comprueba que el dispositivo de destino tenga instalado el paquete HAP de prueba.
- Forza la detención de cualquier instancia del paquete que se esté ejecutando y, a continuación, inicia la función con `
aa start`, indicando a la plataforma qué biblioteca compartida de prueba debe cargar y dónde redirigir la salida estándar y el código de salida de la prueba dentro del entorno aislado de la aplicación. - Transmite la salida estándar de la prueba al host a medida que esta se ejecuta.
- Espera a que finalice la prueba, lo cual detecta cuando el archivo de código de salida se vuelve legible. Una comprobación de actividad detecta un proceso bloqueado, y un watchdog opcional de «sin progreso» detiene forzosamente una prueba que deja de generar resultados de
PASSoFAIL. - Si la prueba declara que bloquea los diálogos del sistema y la salida de la prueba se detiene, realiza un volcado del diseño de la pantalla con
uitesty hace clic en el botón esperado. - Devuelve el código de salida de la prueba como su propio código de salida.
Cómo utilizarlo
La sintaxis básica es:
harmonyostestrunner [OPTIONS] <test-binary> [TESTARGS]El argumento « <test-binary> » es la ruta a la biblioteca compartida de pruebas, por ejemplo, libtst_qobject.so. El nombre del archivo determina qué prueba del paquete se va a ejecutar. Todo lo que venga a continuación, como los nombres de las funciones de prueba o « -v2 », la herramienta lo reenvía a la prueba.
Opciones
En la siguiente tabla se enumeran las opciones de línea de comandos de harmonyostestrunner. Cada opción se puede configurar mediante la variable de entorno que figura entre paréntesis. El valor de la línea de comandos tiene prioridad.
| Opción | Descripción |
|---|---|
--bundle-name <name> | Nombre del paquete HarmonyOS del HAP de prueba instalado (QT_HARMONYOS_BUNDLE_NAME). El valor por defecto es org.qtproject.autotests. |
--ability-name <name> | Nombre de la capacidad de HarmonyOS dentro del HAP de prueba (QT_HARMONYOS_ABILITY_NAME). El valor por defecto es QAbility. |
--hdc <path> | Ruta de acceso a la herramienta hdc (QT_HARMONYOS_HDC). El valor por defecto es el hdc que se encuentra en PATH. |
--timeout <seconds> | Segundos de espera hasta que finalice una prueba antes de abortarla (QT_HARMONYOS_TEST_TIMEOUT). El valor predeterminado es 300. |
--no-progress-timeout <seconds> | Segundos sin un resultado de PASS o FAIL antes de que la herramienta declare que la prueba se ha bloqueado (QT_HARMONYOS_NO_PROGRESS_TIMEOUT). El valor por defecto es 60; 0 desactiva el watchdog. |
--device <key> | La clave de conexión de hdc (-t) para el dispositivo de destino (QT_HARMONYOS_DEVICE). Es obligatoria cuando se conectan varios dispositivos. |
--test-config <path> | Ruta a la configuración de implementación del paquete de pruebas generado (QT_HARMONYOS_TEST_CONFIG). La compilación genera este archivo y el envoltorio de pruebas de CMake lo transmite. La herramienta lo lee para responder a los diálogos del sistema que bloquean el proceso. |
--help | Muestra la información de ayuda. |
--version | Muestra la versión de la herramienta. |
Ejemplo de uso
Ejecuta la prueba « tst_qobject » en un dispositivo específico, ejecutando únicamente el caso de prueba « signalsBlocked »:
harmonyostestrunner --device 127.0.0.1:5555 libtst_qobject.so signalsBlockedPara obtener más información sobre el marco de trabajo « Qt Test », consulta la descripción general de «Qt Test ».
© 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.