Qt for HarmonyOS Prerequisites
Note: Qt for HarmonyOS is in technology preview and may change in future releases.
To develop Qt applications for HarmonyOS, you need to set up your development host with the OpenHarmony SDK and the related command-line tools.
The same prerequisites apply whether you build Qt for HarmonyOS from source or use a pre-built Qt for HarmonyOS to build and deploy your own applications.
Prerequisites
- The OpenHarmony SDK command-line tools, which provide the compiler toolchain, the system libraries, and the
hvigorbuild tool used to assemble a HarmonyOS Ability Package (HAP). - Optionally, DevEco Studio, the official IDE for HarmonyOS, which is convenient for running and debugging applications on a device or the emulator.
Supported development hosts
The Qt for HarmonyOS toolchain is currently developed and tested on Linux.
Setting up the SDK
After installing the OpenHarmony SDK command-line tools, point Qt at the SDK so that the build system can locate the toolchain and system libraries. This is required both when configuring a Qt for HarmonyOS build from source and when building applications against a pre-built Qt. You can do this in two ways:
- Set the
OHOS_SDK_ROOTenvironment variable to the SDK root path. - Pass the path to configure using the
-ohos-sdkoption.
© 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.