Android 版 Qt

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

要启动 Qt for Android 应用程序,请下载并安装 Qt for Android 并使用Qt Creator IDE,按照Qt for Android 入门页面上的说明进行操作。

如果您已有 Android 应用程序,请尝试Qt Quick for Android。它包括 Google Android Studio 的插件。请在 IntelliJ 市场上查找。这样,您就可以将Qt Quick 内容作为视图添加到您的 Android 应用程序中。

要从源代码构建 Qt,请参阅从源代码构建

支持的配置

此 Qt 版本支持以下配置:

部分说明
分布安卓 9 (API 28)15 (API 35)
架构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 17
GradleGradle 8.14.2 和 AGP 8.10.1
软件包Multi-ABIAPKs、AABs 和AARs

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

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

探索 Qt for Android

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

以下主题还提供了有关 Qt for Android 的更多详细信息:

Adding OpenSSL Support for Android

如何将 OpenSSL 库与 Qt for Android 应用程序打包。

Android Platform Notes

在 Android 上构建和运行 Qt 应用程序的特定信息。

Android Services

提供有关 Qt 中 Android 服务支持的信息。

Implementing a splash screen with Qt Quick on Android

展示如何在 Android 上使用Qt Quick View 设置闪屏。

Implementing a splash screen with Qt on Android

展示如何使用 Qt for Android 设置闪屏。

Porting to Android

提供将现有 Qt 应用程序移植到 Android 的说明。

Publishing to Google Play

提供准备发布应用程序的说明。

Qt Quick for Android

在本地 Android 项目中使用 QML 的概述

Qt for Android CMake Configuration

有关 CMake 和 Android 平台 API 的信息。

Qt for Android Environment Variables

列出 Qt For Android 工具链使用的一些有用的环境变量。

Supporting Google Emoji Font Policy

使用 QML 或 C++ 支持 Google Emoji 字体策略的指南。

The androidtestrunner Tool

在 Android 上运行 Qt Test 的 androidtestrunner 工具概述

Third-party Android Libraries

在应用程序中包含第三方 Android 库的说明。

Using Play Feature Delivery

安卓碎片

您不能在 Qt for Android 应用程序中使用 Android片段

不过,Qt 确实提供了自己的模块化组件和 QML 视图。您可以在一个 QML 视图中组合多个组件。更多信息,请参阅 Qt Qml.

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

Active Qt 活跃的社区网站上有维基、论坛以及其他学习指南和介绍。

有关许可的信息,请查看Android GNU C++ 运行时许可

何去何从

我们邀请您探索 Qt 的其他部分。我们为您准备了概述,帮助您决定使用哪些 API,我们的示例还演示了如何使用我们的 API。

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