【Qt 学习之路】Qt 如何在 Windows上 交叉编译ARM 程序

1、概述

习惯于开发Arm板上的程序时去Ubuntu上进行开发，如今就想懒一下，不想来切双系统。那么Qt如何在Windows上开发Arm呢？今天我们一起来盘盘吧~

2、确认环境

2.1、各种环境准备

• 操作系统版本：Windows11
• Qt 版本：Qt 5.12.12（其他版本也可以，我电脑上之前有5.12.12，方便做对比）
• ARM板：aarch64（知识普及：aarch64 是 ARMv8 架构中的 64 位指令集）

2.2、查看ARM板 32位 还是 64位

uname -m

案例：

如果系统是 32 位，则将显示 armv7l 。
如果系统是 64 位，则将显示 aarch64 。

2.3、查看当前 Qt 环境

如果只是正常的安装了官网的Qt版本，应该和我的情况差不多。如下图：

3、准备交叉编译

3.1、下载 Qt 源码

因为我装的是：Qt5.12.12，所以我们找到Qt5.12.12的源码，重新进行aarch64的交叉编译
下载链接：https://download.qt.io/new_archive/qt/5.12/5.12.12/single/

我们选择zip压缩包，将源码解压后放在“D:\Qt\qt-everywhere-src-5.12.12”路径下。
在路径“D:\Qt\qt-everywhere-src-5.12.12\qtbase\mkspecs”文件夹下，可以找到 linux-aarch64-gnu-g++文件夹。

用打开文件夹内的qmake.conf文件，即可查看源码编译时使用的编译器，这里默认使用的编译器是aarch64-linux-gcc和aarch64-linux-g++。

3.2、安装交叉编译器

3.2.1、下载交叉编译器

下载路径：https://developer.arm.com/tools-and-software/open-source-software/developer-tools/gnu-toolchain/downloads

这里我们选择 Qt5.12.12 配套的交叉编译器：gcc-arm-11.2-2022.02-mingw-w64-i686-aarch64-none-linux-gnu.zip

如有需要，复制这个链接：https://developer.arm.com/-/media/Files/downloads/gnu/11.2-2022.02/binrel/gcc-arm-11.2-2022.02-mingw-w64-i686-aarch64-none-linux-gnu.zip?rev=47c49a43aa81408b9688daea870832a5&hash=83CD11A792F93343A917E741132D5CD7

3.2.2、更改名称 Qt5.12.12-ARMv8

安装路径：将gcc-arm-11.2-2022.02-mingw-w64-i686-aarch64-none-linux-gnu.zip解压后，放在 D盘 Qt 文件夹下，与我们的源码同级目录，更新名字为Qt5.12.12-ARMv8。

3.2.3、设置环境变量

3.3、安装关联软件

3.3.1、安装Active Perl

3.3.1.1、下载 ActiveState Perl

下载地址：https://www.perl.org/get.html
进到官网下，我们选择Windows上的ActiveState Perl：

下载Window11 架构下的ActivePerl 5.12以上版本，我们直接下载最新的 5.36。

我们这里直接点击 无需账号继续下载
直接安装，没有Win11，选择Win10。

按照步骤一步步来

3.3.1.2、安装 ActiveState Perl

1、安装 ActiveState 命令行工具

输入Y 接受继续

2、安装 ActiveState-Projects/ActiveState-Perl-5.36.0

state checkout ActiveState-Projects/ActiveState-Perl-5.36.0 .

3、将此运行时设置为系统上的默认运行时。运行状态使用重置来取消设置

state use ActiveState-Perl-5.36.0

3.3.1.3、设置环境变量

安装完成后将“<安装路径>\bin”添加至环境变量。

3.3.2、安装python

下载链接：https://www.python.org/downloads
下载Window11 架构下的Python3以上版本。

同样设置环境变量：安装完成后将安装路径添加至环境变量。

测试是否成功

python -V

3.3.3、安装 MinGW 开发工具集

3.3.3.1、下载 开发工具集

下载链接（这里在速度太慢，我传到CSDN上）：https://download.csdn.net/download/u014597198/88864307。

3.3.3.2、安装 开发工具集

直接解压，然后放在“D:\Qt\MinGW64”路径下，复制出 make.exe。
将安装好的qt地址中的mingw中bin目录下的mingw32-make.exe复制一份改名为make.exe即可。因为windows上名字叫mingw32-make，linux上名字叫make，所以在windows上交叉编译时会找不到make，可能会打不开进程。

3.3.3.3、设置环境变量

将“D:\Qt\MinGW64\bin”添加至环境变量。

4、编译 Qt 源码

4.1、进入 Qt 源码 路径

进入 D:\Qt\qt-everywhere-src-5.12.12 路径，按住shift，右键打开Powershell，如下图：

4.2、编译配置

1、执行命令

.\configure.bat -release -opensource -prefix D:\Qt\Qt5.12.12-ARMv8 -nomake tests -nomake examples -no-opengl -skip qtvirtualkeyboard -platform win32-g++ -xplatform aarch64-linux-gnu-g++

2、如果根据命令行提示，输入y，最后完成编译配置。

配置属性说明：

3.1 -release：编译release版本。
3.2 -opensource：表示开源许可；
3.3 -prefix Qt安装路径。根据上文命令，编译好的Qt库放在D:\Softwares\Qt5.12.11-ARMv8目录下。
3.4 -nomake：表示不编译后面参数指定的模块；
3.5 -no-opengl 表示不安装OpenGL。
3.6 -skip 表示不安装的qt工具包，工具包的名称即为源码路径下的文件夹名称。-skip qtvirtualkeyboard表示跳过qtvirtualkeyboard，没有相应库环境，不编译，否则编译和安装过程中可能会报错。
3.7 -platform：为win32-g++，即指定本地编译器配置目录，到qtbase\mkspecs\ win32-g++目录里读取qmake.conf文件，找到本地编译工具来编译qmake。
3.8 -xplatform 表示使用源码路径qtbase\mkspecs\linux-aarch64-gnu-g++文件夹内的配置，编译时会自动去该路径下找到配置文件进行编译。

在命令行内输入“configure -help”命令，可查看详细配置说明。

这里我们复制带none的文件，粘贴的附件去掉none，如下图：

重新执行命令，成功：

4.3、编译源码

继续执行命令，完成编译。

mingw32-make -j2

遇到错误，查找源码文件是对的，查看是否是编译器的错误

4.4、编译安装（耗时约20分钟）

在命令行下，执行命令，完成安装。

mingw32-make install

5、配置Qt Creator

QtCreator4.9.1的配置过程和之前的QtCreator版本配置项相同，配置位置略有差异，主要配置流程如下：
1、配置QMake
打开“工具->选项->kits”，选择Qt Version页面

点击右侧添加按键，选择编译出的源码路径下的bin文件（就是配置Qt源码编译后存放编译结果的那个路径）夹内的QMake.exe即可

2、配置编译器Compilers
该部分主要添加C++和C的编译器，用于编译arm版本的代码，
设置GCC的C编译器，打开“工具->kits->编译器（Compilers）”

右侧选择“添加->GCC->C”，编译器路径即为gnu工具中的C编译器aarch64-linux-gnu-gcc所在路径，ABI设置为arm-linux-generic-elf-64bit
设置GCC的C++编译器，打开“工具->kits->编译器（Compilers）”，右侧选择“添加->GCC->C++”，编译器路径即为gnu工具中的C++编译器aarch64-linux-gnu-g++所在路径，ABI设置为arm-linux-generic-elf-64bit

配置完成后在kits的编译器页面会出现对应的配置项，如下

3、配置Debuggers
该部分配置调试工具，使用gnu编译器所在文件夹下的gdb调试工具，
打开“工具->选项->kits->Debuggers”，点击Add添加新的调试工具，这里选择gnu编译工具集合下的aarch64-linux-gnu-gdb工具，在gnu工具下的aarch64-linux\bin路径

配置结束后会在Debuggers页面下新增调试工具

4、配置CMake
该部分用于编译得到嵌入式系统下的执行程序或者库文件，使用QtCreator自带的CMake编译工具，个人理解这里的CMake是交叉编译工具，之前配置的QMake是Qt代码的编译工具
依次选择“工具->选项->Kits->CMake”，点击Add按键添加新的编译工具，选择添加mingw32-make.exe，所在路径
“<QtCreator安装路径> \Tools\mingw730_64\bin\mingw32-make.exe”

配置成功后在CMake页面会有显示

4、添加Arm64的编译环境（构建套件Kits）
5、该部分用于配置编译Qt代码时的编译环境，基本是将前面的配置内容添加到编译环境里
6、依次选择“工具->选项->Kits->构建套件（Kit）”，点击右侧Add按键进行配置，配置项目选择前面配置好的内容即可，主要配置内容见下图

配置完成后再次进到该“构建套件（Kit）”页面会有如下显示，其中linux_arm64为新增加的编译环境，前面两个是QtCreator安装时配置好的构建环境

第七步，创建Qt工程验证
目前QtCreator编译linux arm64的环境已经已经配置完成，验证是否可以进行编译，
Ctrl+N创建一个新的桌面应用程序，构建套件时选择linux_arm64即可

待程序创建好后，在工作窗口左侧“项目”界面修改Override make选项，点击Make选项右侧的详情即可列出override make栏，选择QtCreator安装路径下的\Tools\mingw730_64\bin\mingw32-make.exe。

然后ctrl+b进行工程编译即可，debug和profile模式设置类似，将上图中Release选项调整为debug或者profile即可，仍旧是设置override make栏。
编译生成的执行程序或者库文件见上图中“构建目录”中列出的路径，注意只能编译，而不能运行。