Compilation et déploiement d'applications Qt pour HarmonyOS

Cette page décrit comment compiler et empaqueter une application Qt pour HarmonyOS, ainsi que la manière de l'exécuter sur un appareil ou dans l'émulateur.

Empaquetage dans un HAP

Les applications HarmonyOS sont fournies sous forme de « HarmonyOS Ability Packages » (HAP). Lorsque vous créez un exécutable d’application Qt avec `qt_add_executable()` en ciblant HarmonyOS, Qt génère automatiquement une cible de compilation ` <target>_make_hap `. La compilation de cette cible produit le HAP de votre application :

cmake --build . --target <target>_make_hap

Fonctionnement du déploiement

La cible « <target>_make_hap » exécute harmonydeployqt, l’outil de déploiement HarmonyOS. Il suit la même approche que `androiddeployqt` : il rassemble la bibliothèque partagée de l’application, le plugin de la plateforme HarmonyOS (libqohos.so), les modules Qt requis et, pour les applications « Qt Quick », les modules QML, puis les place dans un modèle d’application HarmonyOS. Il invoque ensuite l’outil de compilation OpenHarmony hvigor pour assembler le HAP final.

Pour configurer les métadonnées écrites dans les manifestes HarmonyOS (app.json5 et module.json5) et pour déclarer les autorisations, utilisez les commandes décrites dans l’API CMake de Qt pour HarmonyOS.

Exécution de l’application

Installez et exécutez le fichier HAP obtenu sur un appareil HarmonyOS connecté ou sur l’émulateur. La méthode la plus pratique pour déployer et déboguer consiste à ouvrir le projet généré dans DevEco Studio et à utiliser ses outils d’exécution et de débogage.