L'outil harmonydeployqt
Remarque : Qt pour HarmonyOS est en phase de préversion technologique et est susceptible d'évoluer dans les prochaines versions.
La création d'un paquet d'application Qt pour HarmonyOS implique de nombreuses étapes ; c'est pourquoi Qt est fourni avec un outil qui se charge de cette tâche à votre place. La compilation de la cible CMake « <target>_make_hap » lance automatiquement la commande « harmonydeployqt » ; vous n'avez donc généralement pas besoin de l'exécuter manuellement. Le processus global de création de paquet et de déploiement est décrit dans la section « Création et déploiement d'applications Qt pour HarmonyOS ».
Fonctionnement
À l’instar d’androiddeployqt, ` harmonydeployqt ` rassemble tous les éléments nécessaires au fonctionnement de l’application et assemble un paquet prêt à être déployé :
- Il rassemble la bibliothèque partagée de l’application, le plugin de la plateforme HarmonyOS (
libqohos.so), les modules et plugins Qt requis, ainsi que, pour les applications « Qt Quick », les modules QML. - Il place ces éléments dans un modèle d’application HarmonyOS, avec les métadonnées et les autorisations déclarées via l’API CMake de Qt pour HarmonyOS.
- Il invoque l’outil de compilation OpenHarmony
hvigorpour assembler le paquet de capacités HarmonyOS (HAP) final.
Les paramètres qui régissent ce processus sont transmis à l’outil via un fichier de configuration JSON, généré pour vous par la compilation CMake.
Arguments de ligne de commande
Le seul argument obligatoire est ` --input`. La liste ci-dessous est également disponible en transmettant ` --help ` à ` harmonydeployqt`.
| Argument | Description |
|---|---|
--input <file> | Fichier de configuration JSON décrivant l’application et l’installation Qt à déployer. Obligatoire. |
--output <dir> | Répertoire de sortie pour le projet HarmonyOS généré. |
--hvigor <path> | Chemin d'accès au script hvigorw utilisé pour construire le HAP. Peut également être défini à l'aide de la variable d'environnement QT_HARMONYOS_HVIGOR. |
--install | Installez le HAP obtenu sur un appareil connecté à l’aide de ` hdc`. |
--release | Compiler la configuration de publication. La valeur par défaut est « debug ». |
--no-build | Génère le projet HarmonyOS mais ignore la compilation du HAP. |
--test-bundle | Activez le mode « test bundle », qui regroupe tous les binaires de test dans un seul HAP. |
--verbose | Activez la sortie détaillée. |
--depfile <path> | Écrivez un fichier de dépendances pour le système de compilation dans le chemin indiqué. |
--depfile-base <dir> | Répertoire de base utilisé pour les chemins relatifs dans le fichier de dépendances. |
--help | Afficher la liste des arguments disponibles. |
Signature du HAP
Un HAP doit être signé avant de pouvoir être installé sur un appareil. Vous pouvez fournir les éléments de signature soit via des arguments de ligne de commande, soit via les variables d'environnement correspondantes. Lorsque les deux sont fournis, l'argument de ligne de commande prévaut pour ce champ spécifique.
| Argument | Variable d’environnement | Description |
|---|---|---|
--signing-cert-path <p> | QT_HARMONYOS_SIGNING_CERT_PATH | Chemin d'accès au fichier de certificat d'.cer. |
--signing-profile <p> | QT_HARMONYOS_SIGNING_PROFILE | Chemin d’accès au profil de provisionnement de l’ .p7b. |
--signing-store-file <p> | QT_HARMONYOS_SIGNING_STORE_FILE | Chemin d’accès au magasin de clés d’ .p12. |
--signing-key-alias <a> | QT_HARMONYOS_SIGNING_KEY_ALIAS | Alias de la clé dans le keystore. |
--signing-key-password <s> | QT_HARMONYOS_SIGNING_KEY_PASSWORD | Mot de passe de la clé chiffrée. |
--signing-store-password <s> | QT_HARMONYOS_SIGNING_STORE_PASSWORD | Mot de passe chiffré du magasin de clés. |
--signing-alg <alg> | QT_HARMONYOS_SIGNING_ALG | Algorithme de signature. La valeur par défaut est « SHA256withECDSA ». |
Les mots de passe doivent être des blobs au format hvigor-encrypted, et non du texte en clair. La signature est du type « tout ou rien » : si une entrée de signature est définie, les six valeurs requises (certificat, profil, magasin de clés, alias de clé, mot de passe de clé et mot de passe du magasin de clés) doivent toutes être présentes. Sinon, le HAP reste non signé.
Exécution de l’application
Installez et exécutez le HAP obtenu sur un appareil HarmonyOS connecté ou sur l'émulateur. La manière la plus pratique de déployer et de déboguer consiste à ouvrir le projet généré dans DevEco Studio et à utiliser ses outils d'exécution et de débogage.
Pour plus d'informations sur la création d'un package et le déploiement d'une application Qt pour HarmonyOS, consultez la section « Création et déploiement d'applications Qt pour 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.
