支持的平台
Qt 6.12 支持以下平台。有关早期 Qt 版本的信息，请参阅Qt 文档存档中的相应版本。
受支持的平台将得到积极维护并接受测试，在这些平台上发现的错误将被优先修复。测试中发现的重大错误可能会影响发布日期。
Qt 公司为所有官方支持的平台和配置提供商业支持。
注意：部分平台 仅支持特定类型的商业许可证。详情请参阅《Qt 支持条款与条件》以及您的商业许可证协议。
以下未列出的配置不属于 Qt 项目的官方支持范围。不过，Qt 仍可能在不受支持的平台和配置上运行。在此情况下，Qt 公司、Qt 合作伙伴、开源开发人员和社区用户均可提供协助。
注意： 对特定配置或操作系统版本的支持 可能会在 Qt 6.12 的支持结束之前终止。Qt 6.12 的后续补丁版本可能会取消对某项配置的支持，或将其替换为当前受支持的版本。
桌面平台
Linux
| 发行版 | 架构 | 编译器 | 备注 |
|---|---|---|---|
| Red Hat™ 9.6 | x86_64 | GCC 11 | |
| Red Hat 10.0 | x86_64 | GCC 14 | |
| openSUSE 16.0 | x86_64 | GCC 15 | |
| SUSE Linux Enterprise Server 15 SP6 | x86_64 | GCC 11 | |
| Ubuntu 22.04 | x86_64 | Canonical 提供的 GCC，GCC 11.x | 另请参阅：Enterprise Qt Debian 软件包。 |
| Ubuntu 24.04 | x86_64, arm64 | Canonical 提供的 GCC，GCC 13.x | 请参阅关于 Linux on Arm 桌面支持的说明。 |
| Debian 11.6 | x86_64, arm64 | GCC 10 | 请参阅有关 Linux on Arm 桌面支持的说明。 |
| Debian 12 | x86_64, arm64 | GCC 12 | 另请参阅：企业版 Qt Debian 软件包。 请参阅关于 Arm 架构上 Linux 桌面支持的说明。 |
注意：对于基于 Arm 的 Linux 桌面系统，我们使用配备 8GB 内存的 Raspberry Pi 5 及 Ubuntu 24.04 作为参考平台。如果您在其他硬件上遇到问题，请尝试在 Raspberry Pi 5 上复现该问题。 我们计划在更多基于 ARM 的桌面硬件问世后，转为常规平台支持。Qt Online Installer 中的官方二进制文件是在预装 glibc 2.39 的 Ubuntu 24.04 上构建的；如果您的 glibc 版本早于我们构建时使用的版本，则需要从源代码重新编译。
macOS
| 构建环境 | 目标平台 | 架构 |
|---|---|---|
| Xcode 16（macOS 15 SDK）或更高版本 | macOS 14.4 或更高版本（包括 macOS 26） | x86_64，x86_64h ，arm64 |
注意：Apple 对 macOS 的向前兼容性承诺通常可确保 Qt 应用程序在新版操作系统上继续正常运行。可能出现的问题将根据 Qt 的分支 和支持政策进行优先级排序并安排修复。对新操作系统功能的支持通常不包含在补丁版本中。
Windows
| 操作系统 | 架构 | 编译器 | 备注 |
|---|---|---|---|
| Windows 10（1809 或更高版本） | x86_64 | MSVC 2022、Mingw-w64 15.1 | |
| Windows 11 | x86_64 | MSVC 2022、Mingw-w64 15.1 | |
| 基于 ARM 的 Windows | ARM64 | MSVC 2022 | |
| 基于 ARM 的 Windows | ARM64EC | MSVC 2026 | 无安装包。 缺少对某些 Qt 模块的支持（QtWebView 、Qt WebEngine 以及Qt Quick 3D Physics）。 |
注意：Qt 6.12 将是最后一个支持 Windows 10 的版本。
移动平台
Android
此 Qt 版本支持以下配置：
| 章节 | 描述 |
|---|---|
| 发行版 | Android 9（API 28）至16（API 36） |
| 架构 | arm64-v8a、x86_64 、x86 以及armeabi-v7a |
| 编译器 | Clang 17.0.2（NDK r27c 或 27.2.12479018） 注意：建议 Qt 应用程序使用与构建官方 Qt for Android 库相同的 NDK 版本，以避免出现符号缺失错误。在支持多个 NDK 的版本中，将使用最新的受支持 NDK 来构建 Qt。 |
| JDK | JDK 21 |
| Gradle | Gradle 9.5.1 和 AGP 9.2.1 |
| 包 | 多 ABIAPK、AAB和AAR注意： 仅在使用 CMake 时才支持多 ABI 构建。有关详细信息，请参阅《CMake Android 多 ABI》。 |
有关支持的 Android 版本的更多信息，请参阅《Qt for Android 支持版本选择指南》。
iOS
| 构建环境 | 目标平台 | 架构 |
|---|---|---|
| Xcode 16（iOS 18 SDK）或更高版本 | iOS 18 或更高版本（包括 iOS 26） | armv8,arm64 |
注意：Apple 对 iOS 的前向兼容性承诺通常可确保 Qt 应用程序在新操作系统版本上继续正常运行。可能出现的问题将根据 Qt 的分支 和支持政策进行优先级排序并安排处理。对新操作系统功能的支持通常不包含在补丁版本中。
HarmonyOS
注意： HarmonyOS 版的Qt 目前处于技术预览阶段，未来版本中可能会发生变化。
此 Qt 版本支持以下配置：
| 章节 | 描述 |
|---|---|
| 主机 | Linux |
| 架构 | arm64-v8a （物理设备）和x86_64 （模拟器） |
| 软件包 | HarmonyOS 能力包（HAP） |
如需了解更多信息，请参阅《Qt for HarmonyOS》。
有关移动平台上 WebAssembly 支持的信息，请参阅支持的浏览器说明。
嵌入式平台
目标硬件的支持级别
针对特定的硬件和操作系统组合，设有多个支持级别。
注意： 针对 INTEGRITY、QNX 和 VxWorks 目标平台的Qt 仅在长期支持（LTS）版本中提供支持。若需在其他版本中获得针对这些目标平台的支持，请联系Qt 专业服务部。
第 1 级：参考目标
- 参考目标上的问题优先级高于较低层级目标。
- 由标准支持涵盖。
- 可通过Qt Online Installer 获取发布版本。
| 第1级：参考目标 | ||||
|---|---|---|---|---|
| 供应商 | 主板 | 操作系统 / 其他 | 产品 | 支持平台 |
| 英特尔 | NUC | Yocto 5.3 | Boot to Qt | Qt Group |
| 英伟达 | Jetson AGX Orin 64GB 开发套件 | Yocto 5.3 | Boot to Qt | Qt Group |
| NXP | i.MX 8QuadMax MEK | AAOS 14 | Qt for Android Automotive | Qt Group |
| NXP | i.MX 8QuadMax MEK | Yocto 5.3 | Boot to Qt | Qt Group |
| 高通 | SA8155P | AAOS 10-13 | Qt for Android Automotive | Qt Group |
| 树莓派 | 树莓派 5 (单板计算机) | Yocto 5.3 | Boot to Qt | Qt Group |
第 2 层：已验证的目标平台
- 在已验证目标上发现的问题，其优先级低于第 1 级：参考目标。
- 由高级支持服务涵盖。
- 可通过Qt Online Installer 获取发布版本。
| 第2级：已验证目标 | ||||
|---|---|---|---|---|
| 供应商 | 主板 | 操作系统 / 其他 | 产品 | 由以下厂商提供支持 |
| NVIDIA | Jetson AGX Orin 开发套件 | Debian 12 | 企业版 Qt Debian 软件包 | Qt Group |
| NXP | i.MX 8M Plus LPDDR4 评估板 | Yocto 5.3 | Boot to Qt | Qt Group |
| NXP | i.MX 93 11x11 LPDDR4X 评估开发板 | Yocto 5.3 | Boot to Qt | Qt Group |
| 高通 | RB3 第二代视觉开发套件 | Yocto 5.0 | Boot to Qt | Qt Group |
| 树莓派 | 树莓派 4 64 位 | Yocto 5.3 | Boot to Qt | Qt Group |
| ST | STM32MP15 Discovery | Yocto 5.0 | Boot to Qt | Qt Group |
| TI | SK-AM62 | Yocto 5.0 | Boot to Qt | Qt Group |
| Toradex | Apalis iMX6 | Yocto 5.0 | Boot to Qt | Qt Group |
| Toradex | i.MX 95 Verdin | Yocto 5.0 | Boot to Qt | Qt Group |
第3层：其他目标平台
- 其他目标平台上的问题优先级低于第 1 级：参考目标平台和第 2 级：已验证目标平台。
- 硬件不会定期进行测试。
- QBSP 软件包可从不同供应商处获取；Qt Group 提供的软件包可通过Qt 客户门户或Qt Online Installer 获取。
| 第3级：其他目标 | ||||
|---|---|---|---|---|
| 供应商 | 开发板 | 操作系统 / 其他 | 产品 | 由以下厂商提供支持 |
| NVIDIA | Jetson Orin Nano 开发套件 | Yocto 5.3 | Boot to Qt | Qt Group |
| NXP | i.MX 8M Mini LPDDR4 评估套件 | Yocto 5.3 | Boot to Qt | Qt Group |
| NXP | i.MX 8M Nano LPDDR4 评估板 | Yocto 5.3 | Boot to Qt | Qt Group |
| ST | STM32MP15 评估 | Yocto 5.0 | Boot to Qt | Qt Group |
| StarFive | VisionFive 2 | Yocto 5.0 | Boot to Qt | Qt Group |
| Toradex | Apalis iMX8 | Yocto 5.0 | Boot to Qt | Qt Group |
| Toradex | Colibri iMX6 ULL | Yocto 5.0 | Boot to Qt | Qt Group |
有关更多信息，请参阅“其他目标”部分。
有关更多信息，请参阅《Qt 支持条款与条件》。
Android Automotive OS
Qt for Android Automotive，基于Qt for Android Automotive，将对 Android Automotive OS 10 至 13 版本功能的支持范围进行了扩展。
webOS OSE
webOS OSE 是 webOS 的开源版本，支持 Qt 应用程序开发。
嵌入式 Linux
有关为嵌入式Linux设备进行Qt通用交叉编译的信息，请参阅《配置嵌入式Linux设备》。
如需了解其他嵌入式 Linux 平台的支持信息，请查阅 Boot to Qt 文档。
实时操作系统
| 操作系统 | 体系结构 | 编译器 | 提供于 |
|---|---|---|---|
| INTEGRITY 19.0.13 | arm64 | GHS 编译器版本 2020.1.4 或更高版本 | 适用于 INTEGRITY 的 Qt |
| QNX 7.1 |
| 来自 QNX 7.1 SDP 的 QCC（基于 GCC 8.3） | 适用于 QNX 的 Qt |
| QNX 8.0 |
| 来自 QNX 8.0 SDP 的 QCC（基于 GCC 12.2） | QNX 版 Qt |
| 免费实时操作系统 | 特定于平台。详情请参阅“支持的Qt for MCUs 平台”。 | 因平台而异。有关详细信息，请参阅“支持的Qt for MCUs 平台”。 | Qt for MCUs |
| VxWorks 24.03 |
| Clang 版本 17.0.6.1 | 适用于 VxWorks 的 Qt |
| VxWorks 25.03 |
| Clang 版本 17.0.6.3 | 适用于 VxWorks 的 Qt |
| Zephyr | 因平台而异。详情请参阅“受支持的Qt for MCUs 平台”。 | 因平台而异。详情请参阅“受支持的Qt for MCUs 平台”。 | Qt for MCUs |
Web 平台
WebAssembly
| 平台 | 架构 | 编译器 | 实现 |
|---|---|---|---|
| Web 浏览器 | wasm32 | Emscripten 5.0.5 | Chrome、Edge、Firefox、Safari |
Qt for WebAssembly 是一项与平台无关的技术，允许应用程序在兼容的浏览器上运行，而无需考虑底层操作系统。Qt for WebAssembly 在 Chrome、Edge、Firefox 和 Safari 等桌面浏览器上得到了良好的支持和测试。 虽然 Qt for WebAssembly 旨在于桌面浏览器上流畅运行，但需要注意的是，部分移动浏览器可能仍缺乏可靠执行 WebAssembly 应用所需的一些必要功能。因此，我们强烈建议面向移动浏览器的应用提供商进行全面测试，以确保兼容性和性能。
软件包的可用性
您可以从“下载”页面下载 Qt 安装程序和源代码包。如需了解更多信息，请访问“Qt 入门”页面。
注意： 并非所有 受支持的配置都以二进制软件包的形式提供在Qt Online Installer 上。不过，我们的初衷是为方便开发者，提供使用最广泛的配置。
注意：Linux 二进制包是针对 glibc 2.34 链接的。如果您使用的 glibc 版本早于该版本，则需要从源代码构建 Qt，或者将 glibc 升级至 2.34 或更高版本。
例外情况
某些模块可能仅在部分平台上可用，或者可能不支持所有配置。例如，由于Qt WebEngine 将 Chromium 作为第三方依赖项，因此上游的平台或配置限制同样适用于Qt WebEngine 。
每个模块的文档中都包含有关该模块与本页所述的一般平台和配置支持存在差异的详细信息。
Qt 应用程序的部署
各平台的部署流程各不相同，具体内容在相应的平台页面中有更详细的说明。此外，还有一篇关于部署的文章，概括了通用的部署流程。
支持的版本
有关详细信息，请参阅“支持的 Qt 版本”。
一般法律免责声明
请注意，Qt 按“原样”提供，不作任何形式的保证，且我们的产品并非没有错误或漏洞。 在适用法律允许的最大范围内，Qt Company 代表其自身及其供应商，对许可软件不作任何明示或暗示的保证和条件，包括但不限于对适销性、特定用途的适用性、所有权和不侵权的暗示保证。
© 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.
