Sur cette page

Qt pour HarmonyOS - Compilation à partir du code source

Remarque : Qt pour HarmonyOS est en phase de préversion technologique et est susceptible d'évoluer dans les prochaines versions.

Cette page décrit comment configurer et compiler Qt pour HarmonyOS à partir du code source.

Prérequis

Avant de continuer, assurez-vous de remplir toutes les conditions requises décrites dans la section « Conditions préalables à Qt pour HarmonyOS ».

La compilation de Qt pour HarmonyOS est une compilation croisée : vous compilez les bibliothèques Qt pour la cible HarmonyOS à l'aide des outils de compilation provenant d'une version Qt correspondante sur la plate-forme hôte. Vous devez donc d'abord disposer d'une version Qt compilée pour votre plate-forme hôte. Pour des informations générales sur la compilation croisée de Qt, consultez les pages Qt for Device Creation et Compilation croisée de Qt.

Configuration et compilation

Configurez Qt pour HarmonyOS en indiquant au processus de compilation le SDK OpenHarmony et la version de Qt de la plateforme hôte :

configure -ohos-sdk <SDK_ROOT> -qt-host-path <HOST_QT_PATH> -ohos-arch arm64-v8a
cmake --build .

Les options de configuration pertinentes sont les suivantes :

  • -ohos-sdk définit le chemin d’accès racine du SDK OpenHarmony. Si elle est omise, ` configure ` utilise la valeur de la variable d’environnement ` OHOS_SDK_ROOT `.
  • -ohos-arch définit l’architecture cible. Utilisez arm64-v8a pour les appareils physiques et x86_64 pour l’émulateur. Si elle est omise, configure sélectionne une architecture en fonction du SDK.
  • -qt-host-path Spécifie le chemin d'accès à la version hôte de Qt utilisée pour la compilation croisée.

Installation

Une fois la compilation terminée, installez Qt pour HarmonyOS :

cmake --install .

Par défaut, Qt est installé dans /usr/local/Qt-<version>. Passez l’option -prefix à configure pour l’installer à un autre emplacement. L’installation de Qt pour HarmonyOS ainsi obtenue est celle que vous utiliserez pour compiler et déployer des applications, comme décrit dans la section « Compilation 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.