在本页

Android 版 Qt

Qt 有两种为 Android 开发应用程序的方法:

Qt for Android

Qt for Android使您能够为 Android 设备开发 Qt 应用程序,并支持广泛的功能和用例。

Qt for Android 提供平台集成、运行时桥接、构建和打包支持以及平台插件,可将跨平台 Qt 库(如Qt CoreQt GUIQt QuickQt Widgets )连接到 Android 特定服务和 Android SDK。

Qt Application Manager 通过处理本地 Android(Java/Kotlin)端与 Qt(C++)端之间的交互,包括事件传播、生命周期管理和渲染,在 Android 设备上运行 Qt 应用程序。

主要特点和功能

Qt for Android 的主要功能:

  • 跨平台开发。Android 版 Qt 应用程序通常是一个 QML 应用程序,其背后的代码用 C++ 编写。只需极少调整或无需调整,您就可以一次编写应用程序代码并将其部署到多个平台上。
  • 本地性能。由于 Qt 运行时是为 Android 编译的,因此它能提供原生性能并访问 Android 设备的原生功能。
  • 丰富的 UI 组件。使用 Qt 的大量 Qt Quick组件实现响应式界面。

    您还可以使用 Qt 广泛的模块生态系统为您的应用程序添加功能:

  • C++ 集成。非常适合依赖现有 C++ 库或需要高性能本地代码的应用。
  • 成熟一致的 API。Qt 稳定的模块减少了平台碎片化,使平台之间更容易保持功能均等。

探索 Android 版 Qt

要了解如何使用 Qt for Android 进行开发,以下是需要查看的主要内容:

Android 碎片

您不能在 Qt for Android 应用程序中使用 Android片段。不过,Qt 确实提供了自己的模块化组件和 QML 视图。您可以在一个 QML 视图中组合多个组件。更多信息,请参阅QML 文档

如果您要将Qt Quick for Android集成到 Android 应用程序中,您可以在 Android Fragments 中使用QtQuickViewAPI。

Qt Quick 用于安卓

Qt Quick for Android 可让您将Qt Quick 组件作为视图添加到本地 Android 应用程序的 UI 中。这对于将复杂的 UI 元素、动画或 3D 图形集成到应用程序的特定部分特别有用,而无需用 Qt 重写整个应用程序。与用 Qt 取代整个用户界面的 Qt for Android 不同,Qt Quick for Android 是对现有本地 Android 用户界面的补充。

通过Qt Quick for Android,您可以使用这些组件扩展本地应用程序的用户界面:

Qt Quick Android 版包括一个 Google Android Studio插件。您可以在 IntelliJ 市场上找到它。

支持的配置

此 Qt 版本支持以下配置:

部分说明
分布安卓 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。

JDKJDK 21
GradleGradle 9.3.1 和 AGP 9.0.0
软件包Multi-ABIAPKs、AABs 和AARs

注意: 只有在使用 CMake 时才可进行多重ABI 编译。更多信息,请参阅CMake Android Multi-ABI

有关支持的 Android 版本的更多信息,请参阅Qt for Android 支持的版本选择指南

© 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.