View source for Qt for HarmonyOS/qt5 Host Build

=== Native Compilation of Qt 5.12.12 on HarmonyOS PC (aarch64) ===

This article describes the complete workflow for setting up the build environment using the Harmonybrew package manager on a HarmonyOS PC (aarch64 architecture, Hongmeng kernel), natively compiling Qt 5.12.12 (the `tqtc/harmonyos-5.12.12` branch) from source, and packaging it into a HarmonyOS application.

== 1. Install Harmonybrew Package Manager ==

Harmonybrew is the Homebrew package manager for the HarmonyOS platform. Run the following command in your terminal to install it:

<source lang="bash">
zsh -c "$(curl -fsSL https://harmonybrew.atomgit.com/install.sh)"
</source>

Configure environment variables and append them to `~/.zshrc`:

<source lang="bash">
echo 'eval "$(/storage/Users/currentUser/.harmonybrew/bin/brew shellenv)"' >> ~/.zshrc
eval "$(/storage/Users/currentUser/.harmonybrew/bin/brew shellenv)"
</source>

== 2. Install Build Dependencies ==

Use Harmonybrew to install the toolchain and OpenHarmony SDK required for building Qt:

<source lang="bash">
brew install make              # GNU Make 4.4.1
brew install perl              # Perl (Qt build system dependency)
brew install python            # Python 3 (qtdeclarative module dependency)
brew install ninja             # Ninja build tool
brew install gperf             # gperf (Qt build dependency)
brew install ohos-sdk          # OpenHarmony SDK (includes sysroot + llvm toolchain + hdc)
</source>

== 3. Configure Environment Variables ==

Persist the OHOS SDK environment variables by writing them to `~/.zshrc`:

<source lang="bash">
cat >> ~/.zshrc << 'EOF'

# OHOS SDK environment variables (for Qt compilation)
export NATIVE_OHOS_SDK="/storage/Users/currentUser/.harmonybrew/opt/ohos-sdk/native"

# Add SDK's llvm/bin and Python to PATH
export PATH="$NATIVE_OHOS_SDK/llvm/bin:/storage/Users/currentUser/.harmonybrew/opt/python@3.14/libexec/bin:/storage/Users/currentUser/.harmonybrew/bin:$PATH"
EOF

source ~/.zshrc
</source>

== 4. Obtain Qt Source Code ==

Reference: [https://wiki.qt.io/Qt_for_HarmonyOS/zh#%E5%A6%82%E4%BD%95%E8%8E%B7%E5%8F%96_Qt_for_HarmonyOS_%E6%BA%90%E4%BB%A3%E7%A0%81| How to obtain Qt for HarmonyOS source code]

== 5. Configure Qt (Out-of-source Build) ==

Create an independent build directory outside the source tree and run `configure`:

<source lang="bash">
BUILD_DIR=/storage/Users/currentUser/workspace/Qt-5.12.12/qt5.12.12-build
INSTALL_DIR=/storage/Users/currentUser/Qt-5.12.12-harmonyos
SRC_DIR=/storage/Users/currentUser/Qt-5.12.12/tqtc-qt5

mkdir -p "$BUILD_DIR"
cd "$BUILD_DIR"

"$SRC_DIR/configure" \
    -platform ohos-native-clang \
    -opensource \
    -confirm-license \
    -release \
    -nomake tests \
    -nomake examples \
    -skip qtwebengine \
    -skip qtactiveqt \
    -skip qtandroidextras \
    -skip qtcanvas3d \
    -skip qtfeedback \
    -skip qtgamepad \
    -skip qtmacextras \
    -skip qtpim \
    -skip qtpurchasing \
    -skip qtremoteobjects \
    -skip qtsystems \
    -skip qtwayland \
    -skip qtwinextras \
    -skip qtx11extras \
    -skip qtvirtualkeyboard \
    -prefix "$INSTALL_DIR" \
    QMAKE_CXXFLAGS+="-Wno-error" \
    QMAKE_CFLAGS+="-Wno-error"
</source>

'''Key Parameter Descriptions:'''
* `-platform ohos-native-clang`: Uses the OHOS native compilation mkspec (for native compilation on arm64 devices).
* `QMAKE_CXXFLAGS+="-Wno-error"` / `QMAKE_CFLAGS+="-Wno-error"`: Disables `-Werror` to prevent the build from failing due to strict warnings from newer Clang compiler versions.

== 6. Compilation and Installation ==

Perform a parallel build utilizing all CPU cores:

<source lang="bash">
cd "$BUILD_DIR"
make -j$(nproc)
</source>

''Note: During multi-core parallel compilation, if individual modules fail due to race conditions, simply rerun `make -j$(nproc)` to resume. The build is successful when the output consists entirely of "Nothing to be done".''

Run the installation after compilation finishes:

<source lang="bash">
make install
</source>

== 7. Verify the Installation ==

1. Check the `qmake` version:

<source lang="bash">
"$INSTALL_DIR/bin/qmake" --version
</source>

Expected output:
<pre>QMake version 3.1
Using Qt version 5.12.12 in /storage/Users/currentUser/Qt-5.12.12-harmonyos/lib</pre>

2. Check core libraries and the QPA platform plugin:

<source lang="bash">ls "$INSTALL_DIR/lib/libQt5Core.so" \
   "$INSTALL_DIR/lib/libQt5Gui.so" \
   "$INSTALL_DIR/lib/libQt5Widgets.so" \
   "$INSTALL_DIR/lib/libQt5Qml.so" \
   "$INSTALL_DIR/lib/libQt5Quick.so"

# Check OHOS QPA platform plugin
ls "$INSTALL_DIR/plugins/platforms/libqohos.so"</source>

== Appendix: Packaging and Building HarmonyOS Applications ==

=== Write Project Files ===

Create a simple Qt/QML application (e.g., in a directory named `myapp`):

`myapp.pro`:
<source lang="qmake">
QT += qml quick gui
CONFIG += c++11 qt qml
TEMPLATE = lib
CONFIG -= app_bundle
TARGET = myapp
SOURCES += main.cpp
RESOURCES += qml.qrc
</source>

=== Compile the Application Library ===

Set environment variables in the terminal and invoke the compiled `qmake` to build the shared library:

<source lang="bash">
export NATIVE_OHOS_SDK="/storage/Users/currentUser/.harmonybrew/opt/ohos-sdk/native"
export PATH="$NATIVE_OHOS_SDK/llvm/bin:/storage/Users/currentUser/.harmonybrew/opt/python@3.14/libexec/bin:/storage/Users/currentUser/.harmonybrew/bin:$PATH"

/storage/Users/currentUser/Qt-5.12.12-harmonyos/bin/qmake myapp.pro
make -j$(nproc)
# Build artifact: libmyapp.so (ELF 64-bit arm64, target aarch64-linux-ohos)
</source>

=== Deployment and Packaging ===

1. Use `openharmonydeployqt` to deploy templates:

<source lang="bash">
/storage/Users/currentUser/Qt-5.12.12-harmonyos/bin/openharmonydeployqt \
    --template-dir /storage/Users/currentUser/tqtc-qt5/qtbase/src/harmonyos/templates \
    --output-dir /path/to/deploy \
    --library /path/to/libmyapp.so \
    --sdk-dir /storage/Users/currentUser/.harmonybrew/opt/ohos-sdk
</source>

2. Copy dependent libraries to the project directory:

<source lang="bash">
# Copy Qt core dependent libraries and plugins
cp /storage/Users/currentUser/Qt-5.12.12-harmonyos/lib/libQt5{Core,Gui,Qml,Quick,Network}.so deploy/entry/libs/arm64-v8a/
cp /storage/Users/currentUser/Qt-5.12.12-harmonyos/plugins/platforms/libqohos.so deploy/entry/libs/arm64-v8a/

# Copy C++ runtime library
find /storage/Users/currentUser/.harmonybrew/opt/ohos-sdk/native -name "libc++_shared.so" -exec cp {} deploy/entry/libs/arm64-v8a/ \;
</source>

3. Modify the application entry point to load the library:
Edit `deploy/entry/src/main/ets/common/QtAppConstants.ets` and change `APP_LIBRARY_NAME` to the name of the generated dynamic library:
<source lang="typescript">
export const APP_LIBRARY_NAME = 'libmyapp.so';
</source>

4. Open the `deploy/` directory using DevEco Studio to directly build, sign, and deploy to your device.