适用于 Android 的 Qt
Qt 提供了两种开发 Android 应用程序的方式:
- Qt for Android,用于开发完整的 Qt 应用程序。
- Qt Quick “Qt for Android”用于将Qt Quick 内容集成到原生Android应用程序中。
Qt for Android
Qt for Android™ 使您能够为 Android 设备开发 Qt 应用程序,并支持广泛的功能和用例。
Qt for Android 提供了平台集成、运行时桥接、构建和打包支持,以及平台插件,这些组件将跨平台的 Qt 库(例如Qt Core 、Qt GUI 、Qt Quick 和Qt Widgets )与 Android 特定服务及 Android SDK 连接起来。
Qt 应用程序通过处理原生 Android(Java/Kotlin)端与 Qt(C++)端之间的交互(包括事件传播、生命周期管理和渲染)在 Android 设备上运行。

主要功能与特性
Qt for Android 的主要功能:
- 跨平台开发。Android 版的 Qt 应用程序通常是基于 Qml 构建的,其底层代码采用 C++ 编写。只需极少或无需调整,您即可编写一次应用程序代码,并将其部署到多个平台上。
- 原生性能。由于 Qt 运行时针对 Android 进行了编译,因此它能提供原生性能,并可访问 Android 设备的原生功能。
- 丰富的 UI 组件。利用 Qt 提供的丰富 Qt Quick 组件,打造响应迅速的界面。
您还可以利用 Qt 庞大的模块生态系统,为应用程序添加功能:
- Qt Quick Controls 获取现成的 UI 控件,这些控件采用可自定义的Material 风格,能适应 Android 的外观和风格。
- Qt Widgets 如有需要,可使用传统的桌面风格小部件。
- Qt Quick 3D 用于在应用程序中显示 3D 图形。
- Qt Quick Shapes 用于矢量图形和自定义形状。
- 用于实现高级视觉效果的粒子与Graphical Effects。
- Qt Multimedia 用于音频和视频的播放与录制。
- Qt Graphs 用于 2D 和 3D 数据可视化。
- Qt Virtual Keyboard 用于支持屏幕键盘。
- Qt Sensors 用于访问设备传感器。
- Qt Location 用于地图和基于位置的服务。
- Qt Bluetooth 用于蓝牙连接。
- Qt Network 用于安全的网络通信和加密。
- C++ 集成。非常适合依赖现有 C++ 库或需要高性能原生代码的应用程序。
- 成熟且一致的API。Qt的稳定模块减少了平台碎片化,并使跨平台功能保持一致变得更加容易。
探索适用于 Android 的 Qt
若要了解如何使用 Qt for Android 进行开发,请查看以下主要主题:
- Qt for Android 入门
- Qt for Android 的先决条件
- Qt for Android 的工作原理
- Qt for Android 清单文件配置
- 从命令行构建 Qt for Android 项目
- 在 Android 上部署应用程序
- androiddeployqt 工具
- 从源代码构建 Qt for Android
- Qt Jenny:Java 代码生成器
Android 片段
在 Qt for Android 应用程序中无法使用Android 片段。不过,Qt 确实通过 Qml 提供了自己的模块化组件和视图。您可以在一个 Qml 视图中组合多个组件。有关更多信息,请参阅Qml 文档。
如果您正在将Qt Quick for Android集成到Android应用程序中,则可以在Android片段内使用QtQuickViewAPI。
Qt Quick for Android
Qt Quick for Android 允许您将Qt Quick 组件作为视图(View)添加到原生 Android 应用程序的用户界面中。这对于将复杂的 UI 元素、动画或 3D 图形集成到应用程序的特定部分尤为有用,而无需将整个应用程序重写为 Qt 版本。与将整个 UI 替换为 Qt 的 Qt for Android 不同,Qt Quick for Android 是对现有原生 Android UI 的补充。
借助 Android 版Qt Quick ,您可以通过以下组件扩展原生应用程序的用户界面:
- Qt Quick 以及 Qt Quick Controls 提供现成的 UI 控件,这些控件采用可自定义的Material 风格,能够适应 Android 的外观和感觉。
- Qt Quick 3D 用于在您的应用中显示 3D 图形。
- Qt Quick Shapes 用于矢量图形和自定义形状。
- 用于实现高级视觉效果的粒子与Graphical Effects。
- Qt Graphs 用于 2D 和 3D 数据可视化。
Qt Quick Android 版本包含一个适用于 Google Android Studio的插件。您可以在 IntelliJ 应用商店中找到它。
支持的配置
此 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 支持版本选择指南》。
概述Qt Jenny |
© 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.