下面的视频是使用 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\
或者使用操作系统的软件包管理器,例如 macOS:
brew install android-commandlinetools
Android SDK 强制软件包
确保安装 SDK 平台、平台工具和构建工具。对于 Qt 6.8,请使用
sdkmanager "platform-tools" "platforms;android-36" "build-tools;36.0.0"
Android NDK
Qt 6.8 使用 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
注意: 要获得可接受的安卓模拟器性能,需要硬件加速。没有硬件加速,模拟器将使用软件 CPU 模拟,运行速度极慢。请参阅Android:仿真器加速了解更多信息。
测试设置
现在,您可以运行随 Qt 安装提供的示例来测试您的开发设置。有关详细信息,请参阅移动示例。
要从头开始开发一个简单的应用程序,请参阅Qt Creator: 创建移动应用程序。