开始使用 Qt for Android

下面的视频是使用 Qt for Android 工具链（包括Qt Creator IDE）的入门指南，可帮助您开始开发 Qt for Android 应用程序。

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

本页其余部分有更详细的入门信息。

要下载并安装 Android 版 Qt，请按照 "Qt入门 "页面上的说明进行操作。

Android 开发先决条件

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

• Java 开发工具包（JDK）
• Android 命令行工具，包括
  • Android NDK：用于构建 C++ 代码。
  • Android SDK 平台和Android SDK 构建工具：用于为特定 API 版本构建 Android 应用程序。
  • Android SDK 平台工具：用于部署和管理 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 开发环境。

手动安装先决条件

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

Java 开发工具包 (JDK)

Qt for Android 开发需要 JDK 17 或更高版本，由以下任何支持的发行版提供：

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

安装您喜欢的 JDK。如果安装程序没有设置指向已安装 JDK 位置的JAVA_HOME 环境变量，可以手动设置。例如，在 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)"

安卓 SDK 命令行工具

为您的操作系统下载最新版本的Android SDK 命令行工具，并将其解压缩到以下相应路径。

安卓 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

Android SDK 强制软件包

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

sdkmanager "platform-tools" "platforms;android-35" "build-tools;35.0.1"

Android NDK

Qt 6.9 使用 NDK 26.1.10909125 和 27.2.12479018，您可以运行以下命令进行安装：

sdkmanager "ndk;26.1.10909125"

以 macOS 为例

模拟器

如果您想使用安卓模拟器，可以运行以下命令进行安装：

sdkmanager "emulator"

平台特定配置

视窗

Windows 的默认 USB 驱动程序不允许使用 Android 调试桥（ADB）工具进行调试。您必须安装由extrasAndroid SDK 软件包提供的附加 USB 驱动程序。运行以下命令进行安装：

sdkmanager.bat "extras;google;usb_driver"

Linux

使用adb 或gdb 等工具需要以下依赖项，这些工具可由Qt Creator 使用：

sudo apt-get install libstdc++6 libncurses5

要运行安卓模拟器，还需要以下依赖项：

测试设置

现在，您可以运行随 Qt 安装提供的示例来测试您的开发设置。更多信息，请参阅移动示例。

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