Jump to content

Qt for HarmonyOS/development with 6.12.0 Beta2 zh

From Qt Wiki
< Qt for HarmonyOS
Revision as of 07:17, 4 August 2026 by Shawn Luo (talk | contribs) (Created page with "'''Qt 6.12.0 Beta2 已通过 Qt Online Installer 正式提供 HarmonyOS 预编译包！''' 通过 [https://doc-snapshots.qt.io/qt6-6.12/qt-online-installation.html Qt Online Installer]，你可以在 "Qt 6.12.0 Beta2" 下勾选 "HarmonyOS" 条目安装鸿蒙目标平台的预编译 Qt 库。 == 使用 Qt Online Installer 安装 == Qt Online Installer 下载地址： https://www.qt.io/development/download-qt-installer-oss 选择与你操作系统对应的版本下...")
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)

Qt 6.12.0 Beta2 已通过 Qt Online Installer 正式提供 HarmonyOS 预编译包！

通过 Qt Online Installer，你可以在 "Qt 6.12.0 Beta2" 下勾选 "HarmonyOS" 条目安装鸿蒙目标平台的预编译 Qt 库。

使用 Qt Online Installer 安装

Qt Online Installer 下载地址： 

https://www.qt.io/development/download-qt-installer-oss

选择与你操作系统对应的版本下载。以下以安装 Qt 6.12.0 Beta2 HarmonyOS 组件为例。

1. 启动安装后的 "Qt 在线安装程序"，点击下一步。

Qt 在线安装程序欢迎界面

2. 进入登录界面，登录 Qt 账户，点击下一步。

登录 Qt 账户

3. 勾选相应条款。企业用户需填入企业名称，个人用户则勾选 "我是个人用户"，点击下一步。

勾选条款

4. 如果要自定义安装目录，请点击右上方的浏览，选择要安装 Qt 的目录。然后选中下方的 "自定义安装" 并取消选中其他选项，点击下一步。

选择安装目录与自定义安装

5. 依次展开 "Qt for Development" -> "Qt" -> "Qt 6.12.0-beta2"，选中 "HarmonyOS"。其他可选项可按需勾选，其中 Sources 为 Qt 框架的完整源代码。选择完成后，点击下一步。

勾选 Qt 6.12.0-beta2 下的 HarmonyOS 组件

6. 阅读并勾选许可协议，点击下一步。

许可协议

7. 可保持默认，点击下一步。

开始菜单快捷方式设置

8. 点击安装，等待安装完成。

确认安装
安装进行中

9. 安装完成后，点击完成。

安装完成

安装完成后（以Windows安装到 C:\Qt 为例）：

  • 宿主（Windows）构建位于: C:\Qt\6.12.0\mingw_64
  • HarmonyOS 目标构建位于: C:\Qt\6.12.0\harmonyos_arm64_v8a

Windows 平台

编译环境配置

编译前需要准备好以下三项：Qt 6.12.0（上一步已通过在线安装器安装）、DevEco Studio、以及 Additional Packages 额外包。

(1) Qt 安装目录

即上一步通过在线安装器安装的根目录，假设为 C:\Qt，后续命令中需要填入的路径为 C:\Qt\6.12.0（请替换为你的实际安装目录）。

(2) DevEco Studio 安装

需要通过华为官网安装 Windows 版 DevEco Studio 6.1.0 Release，并指定一个不含空格的安装路径，假设安装到 C:\Huawei\DevEcoStudio： 

https://developer.huawei.com/consumer/cn/download/

下载完成后进行安装。注意：选择安装目录时，建议指定一个无空格的安装目录（DevEco Studio 默认安装在 C:\Program Files\Huawei\DevEco Studio，路径中的空格可能导致交叉编译构建或打包步骤失败）。

(3) Additional Packages 额外包

需要通过以下地址下载额外的包（也可直接通过网盘下载），假设解压到 C:\Dev\ohos-additional-packages（请替换为你的实际目录）： https://wiki.qt.io/Building_Qt6_for_HarmonyOS#Additional_Packages

注意：以上路径均为本文示例，每台机器会有差异，请按自己的实际安装位置调整。

尝试构建一个例子

假设通过在线安装器将 Qt 安装到了 C:\Qt。打开 Windows 命令提示符（cmd），先进入示例目录并创建构建目录： 

cd C:\Qt\Examples\Qt-6.12.0\widgets\gallery
mkdir build-harmonyos
cd build-harmonyos

然后执行下面的语句。注意 QtSdk、DevEco、AdditionalPackages 三个变量需要分别替换为上一步编译环境配置时准备的实际路径。 

set "QtSdk=C:\Qt\6.12.0"
set "DevEco=C:\Huawei\DevEcoStudio"
set "AdditionalPackages=C:\Dev\ohos-additional-packages"
set "BuildDir=%CD%"
for %I in ("..") do set "ProjectDir=%~fI"
set "TargetQt=%QtSdk%\harmonyos_arm64_v8a"
set "HostQt=%QtSdk%\mingw_64"
set "NativeSdk=%DevEco%\sdk\default\openharmony\native"

"%TargetQt%\bin\qt-cmake.bat" -S "%ProjectDir%" -B "%BuildDir%" ^
  "-DQT_HOST_PATH=%HostQt%" ^
  "-DQT_CHAINLOAD_TOOLCHAIN_FILE=%NativeSdk%\build\cmake\ohos.toolchain.cmake" ^
  "-DCMAKE_FIND_ROOT_PATH=%AdditionalPackages%" ^
  "-DEGL_INCLUDE_DIR=%NativeSdk%\sysroot\usr\include" ^
  "-DGLESv3_INCLUDE_DIR=%NativeSdk%\sysroot\usr\include" ^
  "-DCMAKE_BUILD_TYPE=Release"

cmake --build . --parallel

注意：直接整段复制粘贴时，请检查最后的 cmake --build . --parallel 命令是否被实际执行。

打包与部署

构建成功后，使用 harmonydeployqt 生成 DevEco Studio 工程。打开 Windows 命令提示符（cmd），进入项目根目录并执行以下语句，同样需要替换 QtSdk 与 DevEco 为实际路径（Node.js 与 JDK（jbr）已随 DevEco Studio 一起提供，无需单独安装）： 

cd /d "C:\Qt\Examples\Qt-6.12.0\widgets\gallery"
set "QtSdk=C:\Qt\6.12.0"
set "DevEco=C:\Huawei\DevEcoStudio"
set "ProjectDir=%CD%"
set "BuildDir=%ProjectDir%\build-harmonyos"
set "HostQt=%QtSdk%\mingw_64"
set "JAVA_HOME=%DevEco%\jbr"
set "DEVECO_SDK_HOME=%DevEco%\sdk"
set "PATH=%JAVA_HOME%\bin;%PATH%"
for /r "%BuildDir%" %I in (*harmony-deployment-settings.json) do set "DeploymentJson=%~fI"
rmdir /s /q "%ProjectDir%\libgallery-harmonyos"

"%HostQt%\bin\harmonydeployqt.exe" --verbose ^
  --hvigor "%DevEco%\tools\hvigor\bin\hvigorw.bat" ^
  --input "%DeploymentJson%"

生成完成后，打开 DevEco Studio，依次点击 "文件" -> "打开项目"，如下图所示，选择生成的鸿蒙工程，并通过 USB 连接对应的鸿蒙设备。

在 DevEco Studio 中打开生成的鸿蒙工程

等待工程同步完成后，依次点击 "文件" -> "项目结构" -> "签名配置" -> "自动生成签名文件"，完成后点击确定。

签名配置：自动生成签名文件

签名完成后，在右上角选择需要安装到的目标设备，点击右侧的绿色三角运行按钮，即可将程序编译、安装并运行到设备上。

macOS（Apple Silicon）

macOS 上的流程与 Windows 类似。假设所有组件安装在 ~/QtSDK：宿主构建位于 ~/QtSDK/6.12.0/macos；在 "Qt 6.12.0 Beta2" 下勾选 "HarmonyOS" 后，目标构建位于 ~/QtSDK/6.12.0/harmonyos_arm64_v8a。

DevEco Studio 需要安装 6.1.0 Release（DevEco Studio for Mac (ARM) 6.1.0.860），下载地址同上（华为开发者官网）。安装后，API 23 的 SDK 位于 /Applications/DevEco-Studio.app/Contents/sdk/default/openharmony。

Additional Packages 同样通过 https://wiki.qt.io/Building_Qt6_for_HarmonyOS#Additional_Packages 获取，可放到 ~/.local/opt/ohos/additional-packages。

在本地设置 SDK 路径

$ sudo mkdir -p /opt/harmonyos/command-line-tools/sdk/default/
$ cd /opt/harmonyos/command-line-tools/sdk/default/
$ sudo ln -s /Applications/DevEco-Studio.app/Contents/sdk/default/openharmony ./openharmony

尝试构建一个例子

$ cd ~/QtSDK/Examples/Qt-6.12.0/widgets/gallery
$ mkdir build
$ cd build
$ ~/QtSDK/6.12.0/harmonyos_arm64_v8a/bin/qt-cmake -DCMAKE_FIND_ROOT_PATH=$HOME/.local/opt/ohos/additional-packages ..
$ cmake --build . --parallel
$ ~/QtSDK/6.12.0/macos/bin/harmonydeployqt --verbose --hvigor /Applications/DevEco-Studio.app/Contents/tools/hvigor/bin/hvigorw --input ./gallery-harmony-deployment-settings.json

之后即可用 DevEco Studio 打开 

~/QtSDK/Examples/Qt-6.12.0/widgets/gallery/build/libgallery-harmonyos

下的工程，签名、构建并部署到设备。

参考链接

  1. Qt 在线安装文档 — https://doc-snapshots.qt.io/qt6-6.12/qt-online-installation.html
  2. Qt Online Installer 下载 — https://www.qt.io/development/download-qt-installer-oss
  3. DevEco Studio 下载 — https://developer.huawei.com/consumer/cn/download/
Retrieved from "https://wiki.qt.io/index.php?title=Qt_for_HarmonyOS/development_with_6.12.0_Beta2_zh&oldid=46204"