En esta página

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 hvigor para 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`.

ArgumentoDescripció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.
--installInstala el HAP resultante en un dispositivo conectado mediante hdc.
--releaseCompila la configuración de lanzamiento. El valor predeterminado es «debug».
--no-buildGenera el proyecto de HarmonyOS, pero omite la compilación del HAP.
--test-bundleActiva el modo de paquete de prueba, que agrupa todos los binarios de prueba en un único HAP.
--verboseActiva 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.
--helpMostrar 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.

ArgumentoVariable de entornoDescripción
--signing-cert-path <p>QT_HARMONYOS_SIGNING_CERT_PATHRuta al archivo de certificado « .cer ».
--signing-profile <p>QT_HARMONYOS_SIGNING_PROFILERuta al perfil de aprovisionamiento de .p7b.
--signing-store-file <p>QT_HARMONYOS_SIGNING_STORE_FILERuta al almacén de claves « .p12 ».
--signing-key-alias <a>QT_HARMONYOS_SIGNING_KEY_ALIASAlias de la clave dentro del almacén de claves.
--signing-key-password <s>QT_HARMONYOS_SIGNING_KEY_PASSWORDContraseña de la clave cifrada.
--signing-store-password <s>QT_HARMONYOS_SIGNING_STORE_PASSWORDContraseña cifrada del almacén de claves.
--signing-alg <alg>QT_HARMONYOS_SIGNING_ALGAlgoritmo 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.