Qt for Android - 从源代码构建

本页介绍配置和构建Qt for Android 的过程。要下载并安装预构建的 Android 版 Qt，请按照 "Qt 入门"页面上的说明进行操作。

前提条件

要从源代码构建 Qt for Android，请在继续之前确保满足 "开始使用 Qt for Android "中的所有要求。

Windows

在 Windows 上构建 Qt for Android 还需要以下软件：

• Mingw-w64 13.1 工具链

安装先决条件，并将其二进制路径附加到系统PATH 中：

set MINGW_ROOT=<MINGW_ROOT_PATH>\bin
set PATH=%MINGW_ROOT%;%PATH%

要验证安装，请运行

where mingw32-make.exe

该命令应首先列出<MINGW_ROOT>路径下的 mingw32-make.exe。

获取源代码

你可以从Qt 下载页面下载 Qt源代码，或按照维基指南获取源代码。

配置

有了 Qt 6，你可以使用CMake 从源代码构建 Android 版 Qt。Android 版 Qt 6 需要 Qt 宿主构建，这意味着要构建 Android 版 Qt，您需要为用作宿主的桌面平台（即 Linux、macOS 或 Windows）构建 Qt。有关详情，请参阅交叉编译 Qt。

要配置 Qt for Android，请创建一个影子编译目录，以保持源代码目录的整洁：

mkdir -p ~/dev/build-qt-android
cd ~/dev/build-qt-android

Qt for Android 支持以下设备架构 (ABI)：arm64-v8a,x86_64,x86, 和armeabi-v7a

然后在刚刚创建的构建目录中运行配置脚本：

<qt5_super_repo_path>/configure -prefix <install_path> -qt-host-path <qt_host_path> \
    -android-abis <abi> -android-sdk ~/Android/Sdk -android-ndk ~/Android/Sdk/ndk/27.2.12479018

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

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

高级配置参数

在了解本节内容之前，请参阅Qt 配置选项，其中包含有关配置选项的更多信息。

Qt for Android 包含用javac编译器编译成*.jar文件的 Java 代码。要为源代码和目标代码设置javac版本，请分别使用-android-javac-source和-android-javac-target：

-android-javac-source 8 -android-javac-target 8

要将 Qt 作为开发者构建而非前缀构建，请使用以下内容代替-prefix 参数：

-developer-build

-qt-host-path 应指向宿主开发者联编中宿主联编目录下的qtbase 目录。例如：~/dev/build-qt-host/qtbase 。

构建

要编译 Qt，请运行以下命令：

cmake --build . --parallel

安装

对于前缀构建，要安装 Qt，请运行以下命令：

cmake --install .

在 Unix 上，如果您没有提供-prefix <install_path> configure 选项，安装将被放置在/usr/local/Qt-<version> 下，在这种情况下，您需要在安装命令中使用sudo 。