Qt for Android 入门

下方的视频是使用 Qt for Android 工具链（包括 Qt Creator IDE）进行 Android 应用开发的入门指南。

要学习 Qt for Android 的基础知识，请参见 Qt Academy 上的Qt for Android 入门课程。

本页的其余部分提供了更详细的入门信息。

要下载和安装 Qt for Android，请按“入门”页面上所述说明进行操作。

Android 开发先决条件

为了使用 Qt for Android 进行开发，您需要以下先决条件

Java 开发工具包 (JDK)
Android 命令行工具包括
- Android NDK：用于构建 C++ 代码。
- Android SDK 平台和 Android SDK 构建工具：用于为特定 API 版本的 Android 应用进行构建。
- Android SDK 平台工具：用于部署和管理 Android 依赖项。

通过使用 Qt Creator 集成的 Android 开发设置，可以轻松管理这些依赖项。有关更多信息，请参阅Qt Creator：指定 Android 设备设置。

手动安装先决条件

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

Java 开发工具包 (JDK)

Qt for Android 开发需要 JDK 17 或以上，以下支持的分发版均可提供：

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

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

或在 macOS 上：

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

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-commandlinetool

Android SDK 强制安装包

确保安装 SDK 平台、平台工具和构建工具。对于 Qt 6.7，请使用

sdkmanager "platform-tools" "platforms;android-34" "build-tools;34.0.0"

Android NDK

Qt 6.7使用NDK 26.1.10909125，您可以通过运行以下命令来安装

sdkmanager "ndk;26.1.10909125"

例如，对于macOS

仿真器

如果您想使用Android仿真器，您可以通过运行以下命令来安装

sdkmanager "emulator" "patcher;v4"

平台特定配置

Windows

Windows默认的USB驱动不支持使用Android调试桥接（ADB）工具进行调试。您必须安装包含在Android SDK包中的extras提供的额外USB驱动。通过运行以下命令来安装

sdkmanager.bat "extras;google;usb_driver"

Linux

以下依赖项是使用Qt Creator可用的一些工具（如adb或gdb）所必需的

sudo apt-get install libstdc++6 libncurses5

要运行Android仿真器，还需要以下依赖项

测试设置

现在您可以通过运行与应用安装一同提供的示例来测试您的开发设置。有关更多信息，请参阅移动示例。

要从头开发一个简单的应用程序，请参阅Qt Creator：创建移动应用程序。

Qt for Android Qt for Android工作原理