Qt for Android 快速入门

The video below is a beginner's guide to using the Qt for Android toolchain, including the Qt Creator IDE, to get you started developing Android apps.

To learn the basics of getting started with Qt for Android, take the Qt for Android 快速入门 课程在 Qt 学院。

The rest of this page has more detailed getting started information.

To download and install Qt for Android, follow the instructions on the Qt 快速入门 页面。

Android 开发的先决条件

为开发 Qt for Android ，需要下列先决条件：

• JDK (Java 开发工具包)
• Android 命令行工具 包括：
  • Android NDK ：用于构建 C++ 代码。
  • Android SDK Platform and Android SDK Build Tools : for building Android apps for specific API version.
  • Android SDK Platform Tools : for deploying and managing Android dependencies.

The easiest way to manage these dependencies is by using Qt Creator's built in Android development setup. For more information, see Qt Creator：指定 Android 设备设置 .

手动安装的先决条件

If you prefer to manually install the prerequisites please follow these next steps.

JDK (Java 开发工具包)

Qt for Android development requires JDK 17 or above, provided by any of the following supported distributions:

• Adoptium
• OpenJDK
• Java SE Development Kit

Install your preferred JDK. If your installer doesn't set the JAVA_HOME environment variable that points to the location of the installed JDK, you can set it manually. For example on Linux:

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

Or on 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 命令行工具 for your operating system and extract it to the appropriate path as stated below.

The Android SDK is commonly installed by Qt Creator or Android Studio in the following locations:

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

Or use your OS's package manager, for example for macOS:

brew install android-commandlinetool
					

Android SDK 强制性包

Make sure to install the SDK Platform, Platform Tools, and Build Tools. For Qt 6.7, use:

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

Android NDK

Qt 6.7 uses NDK 26.1.10909125, you can install it by running:

sdkmanager "ndk;26.1.10909125"
					

For example for macOS:

Emulator

若希望使用 Android Emulator , you can install it by running:

sdkmanager "emulator" "patcher;v4"
					

Platform Specific Configurations

Windows

The default USB driver on Windows does not allow debugging using Android Debug Bridge (ADB) tool. You must install the additional USB driver provided by the extras Android SDK package. Install it by running the following:

sdkmanager.bat "extras;google;usb_driver"
					

Linux

The following dependencies are needed for using tools such as adb or gdb which can be used by Qt Creator:

sudo apt-get install libstdc++6 libncurses5
					
					

To run the Android emulator, the following dependencies are also necessary:

Testing the Setup

Now you can test your development setup by running the examples shipped with the Qt installation. For more information, see Mobile Examples .

To develop a simple application from scratch, see Qt Creator: Creating a Mobile Application .

Qt for Android Qt for Android 如何工作

内容

• Android 开发的先决条件

• 手动安装的先决条件