Qt Tools for Android Studio

概述

关于插件你需要了解的内容

特性

插件允许你将新的或现有的 Qt QML 项目导入到新的或现有的 Android Studio 项目中。

支持的平台配置

你可以在这里找到支持的内容。

主机环境

构建 Qt 应用程序的主机环境限制也适用于插件。插件已在以下操作系统上进行了测试：

  • Linux (Ubuntu 22.04)
  • Windows (10, 11)
  • macOS ARM (Xcode 版本 15.2)

Android Studio

Android Studio Giraffe (2022.3.1) 到 Iguana (2023.2.1) 都受支持。

Qt for Android

需要 Qt for Android 版本 6.7 或更高版本。

Android SDK

Qt 版本中支持以下配置

分发架构编译器JDKGradle包
Android 8.0 (API 26) 到 14 (API 34)arm64-v8a, x86_64, x86, 和 armeabi-v7aClang 17.0.2 (NDK r26b 或 26.1.10909125)JDK 17Gradle 8.3 和 AGP 7.4.1多 ABI APK 和 AAB

注意：只有在使用 CMake 时才能进行多 ABI 构建。有关更多信息，请参见 CMake Android Multi-ABIs。

注意：建议 Qt 应用程序使用与构建这些官方 Qt for Android 库相同的 NDK r26b 版本，以避免缺失符号错误。

工具

支持的 CMake 和 Ninja 版本包含在您所安装的 Qt 版本中。

许可

此插件受 Qt Community Edition 许可证的约束。

入门

以下视频涵盖了安装插件、安装插件使用所需的所有最低 Qt 依赖项、导入示例 Qt for Android 项目以及在目标设备上构建和运行项目的过程。

以下部分将涵盖这些信息，以及插件功能和用户界面等方面的进一步详细信息。

安装依赖项

  • Qt for Android安装（6.7或更高版本）
  • Google的Android Studio IDE
  • Android SDK

安装Qt for Android

获取Qt for Android有两种方法，但对于大多数用户，我们建议以下方法

使用Qt在线安装程序

要下载和安装Qt for Android，请按照获取和安装Qt页面上的说明操作，并执行自定义安装，至少包括最低要求

  • Qt for Android
  • CMake
  • Ninja

以下说明假设您不想安装Qt Design Studio和Qt Creator。这些工具通常默认安装，但在这里的说明中明确选择不安装这些以及任何不需要的工具。

  1. 选择自定义安装。如果您更改了位置，请确保注记下它，稍后您将需要它。
  2. 取消选择Qt Design Studio。
  3. 展开Qt 6.7或更高版本，并选择Qt for Android。
  4. 取消选择开发和设计工具。
  5. 选择CMake和Ninja。
  6. 选择您可能需要的任何可选Qt模块。
  7. 继续安装。
自己克隆、构建和安装Qt

该方法仅适用于使用未发布或修改过的Qt构建的开发人员。这里不会对此方法进行详细说明。

请参阅Qt for Android - 使用源代码构建。

安装Android Studio和插件

此插件与其他IntelliJ插件的安装方式相同。

  1. 下载并安装Android Studio版本Giraffe | 2023.1.1 Canary 1或更高版本。
  2. 转到插件的IntelliJ市场页面，以下载插件的jar文件。
  3. 启动Android Studio。
  4. 在右上角选择设置（齿轮图标）->从磁盘安装插件

  5. 选择文件并选择确定。

  6. 检查插件是否已安装。

配置插件

插件需要知道Qt工具链的某些部分的位置。

  1. 在左上角选择文件 -> 设置。

  2. 展开构建、执行、部署并选择Qt。

  3. 在此页面上，您需要设置[Qt文件夹路径]/<Qt版本>/android_<架构>/bin中qt-cmake脚本的路径。请确保选择您针对的平台正确的架构。

    • 对于Windows主机，请选择qt-qmake.bat。
    • 对于其他操作系统，请选择qt-cmake。

注意：其他CMake标志字段允许您修改项目的CMake调用。

安装Android SDK

使用Android Studio的SDK管理器安装适用于此版本Qt的正确API、平台和工具。请参阅Android SDK。

运行示例

通过运行Qt安装附带示例来测试您的开发环境。首先，您需要知道您的Qt文件夹路径。使用Qt在线安装程序时，Qt文件夹的默认安装位置为

  • Windows: C:/Qt
  • macOS: ~/Qt
  • Linux: ~/Qt

示例项目位于您的 Qt 安装目录下，具体位置在 Qt/Examples/<qt版本>/platforms/android/。要测试示例

  1. 从 Android Studio 欢迎屏幕选择 打开。

  2. 选择您想使用的 Qt 项目示例。

编译和部署到目标设备或模拟器

要编译和部署，请选择 运行。

这将为 Qt 项目和 Android Studio 项目构建并运行它。

注意：选择 构建项目 不会构建 Qt 项目。

调试

使用插件无法调试 QML 或 C++。请参阅 Qt Creator。

从头开始编写第一个应用程序

  1. 从 Android Studio 的左上角选择 文件 -> 新建 -> 新建 Qt 项目。

  2. 设置项目的 名称，选择项目文件夹，选择 Qt 版本，然后选择 确定。

  3. 开始编写您的第一个 Qt QML 应用程序！

如果您是回访用户或者刚开始学习 QML，请参阅 QML 参考。

在 Android 应用程序中集成 QML

将 QML 嵌入 Android 应用程序的 API 文档提供了具体的实现细节以及对此的见解。

© 2024 Qt 公司有限公司。本文件包含的文档贡献为各自所有者的版权。所提供的文档根据 GNU 自由文档许可协议版本 1.3 许可，由自由软件基金会发布。Qt 及其相应标志是芬兰和/或全世界.Qt 公司有限公司的商标。所有其他商标均为各自所有者的财产。