设置 Android 开发环境
Qt Creator 提供自动安装所有必要软件包和工具的功能,并通过创建调试器、工具链和开发套件来为您搭建Qt for Android开发环境。
使用Qt Creator 可以:
- 下载并解压 Android SDK 命令行工具。
- 安装或更新关键软件包,例如 NDK、构建工具和平台工具。
要设置 Android 开发环境:
- 访问Preferences >SDKs >Android 。

- 在JDK location 中,设置 JDK 的路径。Qt Creator 会检查 JDK 安装情况并报告错误。
默认情况下,Qt Creator 会尝试查找受支持的Adoptium OpenJDK或OpenJDK安装。如果找不到,则必须手动设置路径。如果您尚未安装受支持的 JDK,请选择
以在默认浏览器中打开 JDK 下载网页。注意:请使用 64 位 JDK,因为 32 位 JDK 可能会导致
cmdline-tools出现问题,且某些软件包可能不会显示在列表中。 - 在Android SDK location 中,设置用于安装Android SDK 命令行工具的文件夹路径。
- 选择“Set Up SDK ”,系统会自动下载并将 Android SDK 命令行工具解压到所选路径。
SDK Manager 会检查您是否具备必要的工具。如果您需要更多软件包或更新,SDK Manager 会提供添加或移除相应软件包的选项。在执行操作之前,系统会提示您确认是否接受这些更改。此外,如有必要,系统还会提示您接受 Google 许可协议。
- Android NDK list 列出了已安装的 NDK 版本。SDK Manager 已安装锁定的项目。您只能通过“Android SDK Manager ”对话框对其进行修改。有关详细信息,请参阅《管理 Android NDK 软件包》。
- 选择“Automatically create kits for Android tool chains ”可自动创建所需的开发工具包。如果Qt Creator 无法找到合适的 Qt 版本,将显示一条警告。
- 此外,您还可以在“Android OpenSSL Settings ”组中设置预编译 OpenSSL 库的路径。
对于需要 OpenSSL 支持的 Qt 应用程序,请按照《向 Android 包添加外部库》中的说明,为项目添加Android OpenSSL 支持。
- 选择“Download OpenSSL ”将 OpenSSL 仓库下载到所选路径。如果自动下载失败,系统将打开下载网页以便手动下载。
手动设置
如果自动设置无法满足您的需求,请下载并安装 Android SDK 命令行工具,然后安装或更新必要的 NDK、工具和软件包。有关更多信息,请参阅《Qt for Android 入门指南》。
查看 Android 工具链设置
一个 JSON 配置文件定义了 Android SDK 命令行工具的下载 URL、必备软件包列表以及适用于每个 Qt 版本的相应 NDK。该文件位于Qt Creator 资源文件夹中:
# Linux and macOS ~/.config/QtProject/qtcreator/android/sdk_definitions.json # Windows C:\Users\Username\AppData\Local\QtProject\qtcreator\android\sdk_definitions.json
例如,该 SDK 配置文件将 NDK 版本设置为 22.1.7171670,适用于 Qt 6.3、Qt 6.2 以及 Qt 5.15.9 至 5.15.20:
"specific_qt_versions": [ { "versions": ["6.3", "6.2", "5.15.[9-20]"], "sdk_essential_packages": ["build-tools;31.0.0", "ndk;22.1.7171670"] }, ]
您可以在 Git 中查看与 Android SDK 和 NDK 变更保持同步的最新版本配置文件, sdk_definitions.json。
注意:对于 Qt 6.5 或更高版本,Qt Creator 会从modules/Core.json 读取构建 Qt 时使用的 NDK 版本,并使用该版本代替sdk_definitions.json 中的版本。
另请参阅 《如何:为 Android 开发》、《Android 开发》和《管理开发套件》。
Copyright © The Qt Company Ltd. and other contributors. 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.