【解决方案】

• 可以在鸿蒙系统上安装Qt开发环境
• HarmonyOS SDK：最低支持 API 版本 15（HarmonyOS 5 及以上需 API 15+）
• 开发工具：需同时使用 Qt Creator（Qt 开发 IDE）和 华为 DevEco Studio（HarmonyOS 环境依赖，默认自带 SDK，可手动升级至 API 15+），且需先确认 DevEco Studio 可正常开发 Arkts 应用

Gerrit 简介

• Qt 源代码托管于 Gerrit（代码审查与版本控制平台），使用前需参考：Setting up Gerrit、Gerrit Introduction。

Qt for HarmonyOS 源代码获取

需通过 Gerrit 克隆仓库，步骤如下：

1. 登录 Gerrit 平台：https://codereview.qt-project.org。
2. 进入「设置 → HTTP 凭证 → 生成新密码」，保存密码用于后续 git clone。
3. 克隆仓库：访问 https://codereview.qt-project.org/admin/repos/qt/tqtc-qt5，复制仓库地址执行 git clone。
4. 切换分支（二选一）： git checkout tqtc/harmonyos-5.12.12 或 git checkout tqtc/harmonyos-5.15.16。
5. 更新子模块：git submodule update --init --recursive。

macOS 环境构建（Qt 库 + 应用）

1. 构建 Qt 库

（1）准备第三方依赖

• 基于 macOS Sonoma 14.0 验证，依赖版本：git 2.39.3、python 3.12.0（非最低要求，供参考）。

（2）配置系统环境变量

编辑 ~/.zshrc 或 ~/.bashrc，添加以下内容：

local HARMONY_OS_API_VER=12
local HOME_LIBRARY=${HOME}/Library
export OHOS_SDK_ROOT=${HOME_LIBRARY}/OpenHarmony/Sdk
export HOS_SDK_HOME=${HOME_LIBRARY}/OpenHarmony/Sdk
export OHOS_SDK_12=${HOS_SDK_HOME}/${HARMONY_OS_API_VER}
export NATIVE_OHOS_SDK=${OHOS_SDK_12}/native

（3）构建源代码

• 目标架构：arm64-v8a，需替换脚本中 <ENTER PATH TO YOUR qt/qt5 DIRECORY> 为本地源码路径：

  # 创建构建目录
  ARCH="arm64-v8a"
  QT5_ROOT_DIR=<本地Qt5源码路径>
  QT5_BUILD_DIR="$QT5_ROOT_DIR/build_${ARCH}"
  mkdir "$QT5_BUILD_DIR" && cd "$QT5_BUILD_DIR"
  
  # 执行配置（跳过非必要模块，启用OpenGLES3）
  ../configure \
      -v -xplatform ohos-clang \
      -prefix /data/storage/el1/bundle/libs/arm64 \
      -extprefix ${NATIVE_OHOS_SDK}/opt/Qt/5.12.12/ohos-${ARCH}-clang/ \
      -opensource -confirm-license -release \
      -no-use-gold-linker -no-gcc-sysroot -ohos-arch ${ARCH} -opengles3 \
      -skip qt3d -skip qtactiveqt ...（省略多个非必要模块） \
      -no-dbus -c++std c++14 -nomake examples -nomake tests
  
  # 编译与安装（-j16 为线程数，可调整）
  make -j16
  make install
  

• 若需 OpenSSL 特性，在 configure 中添加：-openssl-runtime -I"${QT_SOURCE_DIR_OPENSSL}" -ssl（QT_SOURCE_DIR_OPENSSL 为 OpenSSL 头文件路径，可从 openharmony/third_party_openssl 获取）。

2. 构建 Qt 应用程序（Qt Creator 配置）

（1）创建开发工具包

进入 Qt Creator「Preferences → Kits → Qt Versions」，点击「Add」，选择构建 Qt 库时生成的 qmake 文件。

（2）配置编译器

• C 编译器：「Compilers → Add → Custom → C」，名称设为 OHOS Clang，路径为 ${NATIVE_OHOS_SDK}/llvm/bin/clang，Make 路径为 /usr/bin/make，ABI 设为 arm-linux-generic-elf-64bit。
• C++ 编译器：步骤同上，名称设为 OHOS Clang++，路径选择 clang++。

（3）配置套件

「Kits → Add」，创建新套件（需关联上述 Qt 版本和编译器）。

（4）设置环境变量

「Preferences → Environment → System → Change」，添加：NATIVE_OHOS_SDK=<路径>/OpenHarmony/Sdk/12/native。

Windows 环境构建（Qt 库 + 应用）

1. 构建 Qt 库

（1）准备构建环境

1. 克隆源码：带 --recursive 参数克隆 tqtc-qt5 仓库（确保子模块完整）。

2. 安装工具：

   • DevEco Studio（下载 HarmonyOS/native 包）；
   • MinGW 工具链（例：llvm-mingw-20230919-ucrt-x86_64.zip，解压至 d:\）；
   • Perl（Strawberry Perl for Windows）。

3. 配置环境变量：

   • 向 PATH 添加 MinGW 和 Perl 的 bin 目录；
   • 新增系统变量：MINGW_ROOT=<MinGW路径>、PERL_ROOT=<Perl路径>。

4. 命令行设置变量（CMD 中执行）：

   SET NATIVE_OHOS_SDK=D:\oh\DevEcoStudio\sdk\HarmonyOS-NEXT-DB6\openharmony\native
   SET OHOS_SDK_SYSROOT=%NATIVE_OHOS_SDK%\sysroot
   SET LLVM_INSTALL_DIR=%NATIVE_OHOS_SDK%\llvm
   SET QT5_ROOT_DIR=D:\oh\tqtc-qt5
   

（2）构建与安装

1. 创建构建目录（与源码目录同级，非子目录），进入目录后设置跳过模块变量：

   SET QT_SKIPS=-skip qt3d -skip qtactiveqt ...（省略多个非必要模块）-no-dbus -skip doc
   

2. 执行配置（需替换路径）：

   call ..\tqtc-qt5\configure.bat -v -xplatform ohos-clang \
       -device-option CROSS_COMPILE=%LLVM_INSTALL_DIR%\bin \
       -prefix /data/storage/el1/bundle/libs/arm64 \
       -extprefix c:\Qt\qt-5.12.12-ohos \
       -opensource -confirm-license -debug -no-use-gold-linker \
       %QT_SKIPS% -nomake tests -nomake examples -no-gcc-sysroot -opengles3 -c++std c++14 -ohos-arch arm64-v8a
   

   • 需 OpenSSL 时添加：-openssl-runtime -I%QT_SOURCE_DIR_OPENSSL% -ssl（头文件路径同 macOS）。

3. 编译与安装：

   mingw32-make -j8  # -j8 为线程数
   mingw32-make install
   

2. 构建 Qt 应用程序（Qt Creator 配置）

（1）核心配置步骤

1. 配置 Qt 版本：「偏好设置 → Kits → Qt Versions → Add」，选择 C:\Qt\qt-5.12.12-ohos\bin\qmake，名称设为 Qt %{Qt:Version} for OHOS。
2. 配置编译器：同 macOS 逻辑，C 编译器路径为 MinGW 的 clang.exe，C++ 为 clang++.exe，Make 路径为 mingw32-make.exe，ABI 为 arm-linux-generic-elf-64bit。
3. 配置套件：「Kits → Add」，名称设为 OHOS Clang，Sysroot 设为 D:\oh\DevEcoStudio\sdk\HarmonyOS-NEXT-DB6\openharmony\native\sysroot，关联上述 Qt 版本和编译器，Qt mkspec 设为 ohos-clang。
4. 设置环境变量：添加 NATIVE_OHOS_SDK=<上述路径>。

（2）获取模板与编译示例

1. 下载 DevEco 项目模板：http://codereview.qtcompany.cn:29416/template/，在模板 entry 目录下创建 libs/arm64-v8a。
2. 编译示例（以 Qt 计算器为例）：
   • 复制 <qt5-root>\examples\widgets\widgets\calculator 到项目目录，用 Qt Creator 打开 calculator.pro，选择 OHOS Clang 套件编译，生成 libcalculator.so（路径：build-calculator-OHOS_Clang-Debug）。

在 HarmonyOS 硬件上运行应用

1. 准备应用文件

1. 复制 libcalculator.so 到 DevEco 模板的 entry\libs\arm64-v8a 目录。
2. 复制 Qt 依赖库：从 <Qt安装路径>\lib\ 复制必要库（如 libQt5Widgets.so）到上述 libs 目录。

2. 修改与运行

1. 修改 ETS 代码：在 DevEco Studio 中打开模板，编辑 entry\src\main\ets\common\QtAppConstants.ets，将 APP_LIBRARY_NAME 改为 libcalculator.so。
2. 设备配置：连接硬件设备（确保 DevEco 可识别），配置签名（「file → project structure → signing configs」，勾选所有项）。
3. 构建运行：在 DevEco Studio 中选择设备，点击运行，编译成功后应用将在设备上启动。

注意：

• 架构支持：当前仅验证 arm64-v8a 架构。
• Qt 版本：支持 5.12.12 和 5.15.16（对应 HarmonyOS 分支）。
• 问题排查：优先确保 DevEco Studio 可正常开发 Arkts 应用，避免环境依赖冲突。