Qt for Android 的先决条件

若要使用 Qt 开发 Android 应用程序，您需要配置开发环境，并安装必要的工具和依赖项。本页面提供了分步指南，助您快速入门。

Android 开发先决条件

要使用Qt for Android 进行开发，您需要满足以下先决条件：

• Java 开发工具包 (JDK)
• Android 命令行工具，其中包括：
  • Android NDK：用于构建 C++ 代码。
  • Android SDK 平台和Android SDK 构建工具：用于构建 Android 应用。
  • Android SDK 平台工具：用于部署和管理 Android 依赖项。

安装先决条件

使用Qt Creator 的 Android 开发配置

管理依赖项最简单的方法是使用Qt Creator 内置的 Android 开发设置。在安装完 Qt for Android 后首次打开Qt Creator 时，系统会询问您是否要运行 Android 设置向导。此操作还会为 Android 配置 OpenSSL。

使用现有的 SDK 位置

如果您已经安装了 Android SDK，则无需运行此向导。取而代之的是，在Qt Creator 中访问Preferences > Devices > Android ，并浏览至您现有的 JDK 和 SDK 路径。请参阅常见的Android SDK 路径。有关更多信息，请参阅Qt Creator ：设置 Android 开发环境。

手动安装先决条件

如果您希望手动安装先决条件，请按照以下步骤操作。

1. 安装 Java 开发工具包 (JDK)。

   用于 Android 开发的 Qt 需要 JDK 21 或更高版本，可由以下任何受支持的发行版提供：

   • Adoptium
   • OpenJDK
   • Java SE 开发工具包

   安装您首选的 JDK。如果安装程序未设置指向已安装 JDK 位置的JAVA_HOME 环境变量，您可以手动设置。例如在 Linux 上：

   sudo apt-get install openjdk-21-jdk
   export JAVA_HOME=/usr/lib/jvm/java-21-openjdk-amd64

   或在 macOS 上：

   brew install openjdk@21
   sudo ln -sfn "$(brew --prefix openjdk@21)/libexec/openjdk.jdk" \
       "/Library/Java/JavaVirtualMachines/openjdk-21.jdk"
   export JAVA_HOME="$(/usr/libexec/java_home -v 21)"

2. 安装 Android SDK 命令行工具。下载适用于您操作系统的最新版本Android SDK 命令行工具，并将其解压到下文所述的相应路径中。

   Android SDK 通常由Qt Creator 或 Android Studio 安装在以下位置：

   • Linux：~/Android/Sdk/
   • macOS：~/Library/Android/sdk/
   • Windows：C:\Users\<USER>\AppData\Local\Android\Sdk\

   或者使用您操作系统的软件包管理器，例如在 macOS 上：

   brew install android-commandlinetools

3. 安装 Android SDK 平台、构建工具和平台工具。

   请务必安装 SDK 平台、平台工具和构建工具。对于 Qt 6.12，请使用：

   sdkmanager "platform-tools" "platforms;android-36" "build-tools;36.0.0"

4. 安装 Android NDK。

   Qt 6.12 使用 NDK 27.2.12479018，您可以通过运行以下命令进行安装：

   sdkmanager "ndk;27.2.12479018"

5. （可选）安装 Android 模拟器。

   如果您希望使用Android 模拟器，可通过运行以下命令进行安装：

   sdkmanager "emulator"

6. 特定平台的配置
   • 对于 Windows 系统，您需要安装由 Android SDK扩展包提供的附加 USB 驱动程序。请运行以下命令进行安装：

     sdkmanager.bat "extras;google;usb_driver"

   • 对于 Linux，若要使用adb 或gdb 等工具（这些工具可通过Qt Creator 调用），需要满足以下依赖关系：

     sudo apt-get install libstdc++6 libncurses5

     注意： 要获得令人满意的 Android 模拟器性能，必须启用硬件加速 。若未启用，模拟器将使用软件 CPU 模拟，运行速度会极其缓慢。更多信息请参阅《Android：模拟器加速》。

测试环境

安装并配置完必备条件后，您可以通过运行 Qt 安装包中附带的示例来测试您的开发环境。有关更多信息，请参阅《移动端示例》。