La herramienta harmonydeployqt
Nota: Qt para HarmonyOS se encuentra en fase de vista previa tecnológica y puede sufrir cambios en futuras versiones.
La creación de un paquete de una aplicación Qt para HarmonyOS implica muchos pasos, por lo que Qt incluye una herramienta que se encarga de todo el proceso por ti. Al compilar el objetivo « <target>_make_hap » de CMake, se ejecuta automáticamente « harmonydeployqt », por lo que normalmente no es necesario invocarlo manualmente. El proceso general de creación de paquetes y despliegue se describe en «Creación y despliegue de aplicaciones Qt para HarmonyOS».
Cómo funciona
Al igual que «androiddeployqt», « harmonydeployqt » recopila todo lo que la aplicación necesita para ejecutarse y crea un paquete listo para su implementación:
- Recopila la biblioteca compartida de la aplicación, el complemento de la plataforma HarmonyOS (
libqohos.so), los módulos y complementos de Qt necesarios y, en el caso de las aplicaciones « Qt Quick », los módulos QML. - Los coloca en una plantilla de aplicación de HarmonyOS junto con los metadatos y los permisos declarados a través de la API CMake de Qt para HarmonyOS.
- Invoca la herramienta de compilación OpenHarmony
hvigorpara ensamblar el paquete de capacidades de HarmonyOS (HAP) definitivo.
Los ajustes que controlan este proceso se pasan a la herramienta en un archivo de configuración JSON, que la compilación de CMake genera automáticamente.
Argumentos de la línea de comandos
El único argumento obligatorio es ` --input`. La lista que figura a continuación también está disponible pasando ` --help ` a ` harmonydeployqt`.
| Argumento | Descripción |
|---|---|
--input <file> | Archivo de configuración JSON que describe la aplicación y la instalación de Qt que se va a implementar. Obligatorio. |
--output <dir> | Directorio de salida para el proyecto HarmonyOS generado. |
--hvigor <path> | Ruta al script hvigorw utilizado para compilar el HAP. También se puede configurar mediante la variable de entorno QT_HARMONYOS_HVIGOR. |
--install | Instala el HAP resultante en un dispositivo conectado mediante hdc. |
--release | Compila la configuración de lanzamiento. El valor predeterminado es «debug». |
--no-build | Genera el proyecto de HarmonyOS, pero omite la compilación del HAP. |
--test-bundle | Activa el modo de paquete de prueba, que agrupa todos los binarios de prueba en un único HAP. |
--verbose | Activa la salida detallada. |
--depfile <path> | Escribe un archivo de dependencias para el sistema de compilación en la ruta indicada. |
--depfile-base <dir> | Directorio base utilizado para las rutas relativas en el archivo de dependencias. |
--help | Mostrar la lista de argumentos disponibles. |
Firmar el HAP
Un HAP debe firmarse antes de poder instalarse en un dispositivo. Puedes proporcionar el material de firma bien mediante argumentos de línea de comandos, bien mediante las variables de entorno correspondientes. Cuando se especifican ambos, prevalece el argumento de línea de comandos para ese campo concreto.
| Argumento | Variable de entorno | Descripción |
|---|---|---|
--signing-cert-path <p> | QT_HARMONYOS_SIGNING_CERT_PATH | Ruta al archivo de certificado « .cer ». |
--signing-profile <p> | QT_HARMONYOS_SIGNING_PROFILE | Ruta al perfil de aprovisionamiento de .p7b. |
--signing-store-file <p> | QT_HARMONYOS_SIGNING_STORE_FILE | Ruta al almacén de claves « .p12 ». |
--signing-key-alias <a> | QT_HARMONYOS_SIGNING_KEY_ALIAS | Alias de la clave dentro del almacén de claves. |
--signing-key-password <s> | QT_HARMONYOS_SIGNING_KEY_PASSWORD | Contraseña de la clave cifrada. |
--signing-store-password <s> | QT_HARMONYOS_SIGNING_STORE_PASSWORD | Contraseña cifrada del almacén de claves. |
--signing-alg <alg> | QT_HARMONYOS_SIGNING_ALG | Algoritmo de firma. Por defecto es « SHA256withECDSA ». |
Las contraseñas deben ser blobs de hvigor-encrypted, no texto sin cifrar. La firma es de todo o nada: si se establece cualquier entrada de firma, deben estar presentes los seis valores obligatorios (el certificado, el perfil, el almacén de claves, el alias de clave, la contraseña de la clave y la contraseña del almacén de claves). De lo contrario, el HAP queda sin firmar.
Ejecución de la aplicación
Instala y ejecuta el HAP resultante en un dispositivo HarmonyOS conectado o en el emulador. La forma más cómoda de implementar y depurar es abrir el proyecto generado en DevEco Studio y utilizar sus herramientas de ejecución y depuración.
Para obtener más información sobre cómo empaquetar e implementar una aplicación Qt para HarmonyOS, consulta «Compilación e implementación de aplicaciones Qt para HarmonyOS».
© 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.