建立 Android 开发环境

Qt Creator Qt for Android提供自动安装所有必要的软件包和工具,并通过创建调试器、工具链和工具包来设置Qt for Android开发环境。

使用Qt Creator

  • 下载并提取 Android SDK 命令行工具。
  • 安装或更新基本软件包,如 NDK、构建工具和平台工具。

为 Android 设置开发环境:

  1. 转到首选项>SDKs >Android

    SDK 偏好设置中的 Android 选项卡

  2. JDK location 中,设置 JDK 的路径。Qt Creator 检查 JDK 的安装情况并报告错误。

    默认情况下,Qt Creator 会尝试查找受支持的Adoptium OpenJDKOpenJDK安装。如果找不到,则必须手动设置路径。如果没有安装受支持的 JDK,请选择在系统浏览器中打开 JDK 下载 URL ,在默认浏览器中打开 JDK 下载网页。

    注意: 请使用 64 位 JDK,因为 32 位 JDK 可能会导致cmdline-tools 出现问题,而且某些软件包可能不会出现在列表中。

  3. Android SDK location 中,设置安装Android SDK 命令行工具的文件夹路径。
  4. 选择Set Up SDK ,将自动下载并解压 Android SDK Command-line Tools 到所选路径。

    SDK 管理器会检查您是否拥有必要的工具。如果需要更多软件包或更新,SDK 管理器会主动添加或删除相应的软件包。在采取行动之前,它会提示您接受更改。此外,如有必要,它还会提示您接受 Google 许可证。

  5. Android NDK list 列出已安装的 NDK 版本。SDK 管理器安装了锁定的项目。您只能从 对话框修改它们。有关详细信息,请参阅Android SDK Manager 管理 Android NDK 包
  6. 选择Automatically create kits for Android tool chains 以自动创建必要的工具包。如果Qt Creator 找不到合适的 Qt XML 版本,则会显示警告。
  7. 可选择在Android OpenSSL Settings 组中设置预构建 OpenSSL 库的路径。

    对于需要 OpenSSL 支持的 Qt 应用程序,请按照添加外部库中的说明,将Android OpenSSL 支持 添加到项目中。

  8. 选择Download OpenSSL ,将 OpenSSL 资源库下载到所选路径。如果自动下载失败,则会打开下载网页进行手动下载。

手动设置

如果自动设置无法满足您的需求,请下载并安装 Android SDK 命令行工具,然后安装或更新必要的 NDK、工具和软件包。有关更多信息,请参阅Android 版 Qt 入门

查看 Android 工具链设置

一个 JSON 配置文件为每个 Qt 版本定义了 Android SDK Command-Line Tools 下载 URL、必备软件包列表和相应的 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 配置文件设置了与 Qt 6.3、Qt 6.2 和 Qt 5.15.9 至 5.15.20 一起使用的 NDK 版本 22.1.7171670:

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