Windows10 ARM64 QtWidget工程构建：从环境配置到交叉编译实战

1. 为什么要在Windows10上构建ARM64 QtWidget工程

最近几年ARM架构的处理器越来越火，从手机到嵌入式设备，再到现在的笔记本电脑，ARM芯片凭借低功耗高性能的特点正在快速占领市场。像TI的AM62X这类嵌入式平台，很多开发者习惯在Windows环境下工作，但最终程序要跑在ARM架构的设备上。这就引出了一个很实际的问题：能不能直接在Windows电脑上开发ARM平台的Qt程序？

答案是肯定的。虽然Linux环境下有现成的SDK可以直接用，但在Windows上通过交叉编译的方式同样能搞定。我最近刚完成了一个AM62X平台的项目，整个过程踩了不少坑，也积累了一些经验。下面就把从环境配置到成功编译的完整流程分享给大家，手把手教你如何在Windows10上搭建ARM64 Qt开发环境。

2. 准备工作：工具链与软件安装

2.1 必备工具清单

在开始之前，我们需要准备以下工具：

• Windows10系统（建议版本1903以上）
• Qt Creator 5.14.2（其他版本也可，但配置可能略有不同）
• 交叉编译工具链（推荐gcc-arm-10.3-2021.07）
• make工具（3.81版本即可）
• 预编译好的qmake工具

这里特别说明一下交叉编译工具链的选择。我测试过多个版本，最终选择了gcc-arm-10.3这个版本，主要是因为它对ARM64的支持比较完善，而且和Qt5.14.2的兼容性很好。工具链下载解压后，建议放在没有中文和空格的路径下，比如直接放在C盘根目录。

2.2 安装与配置细节

安装Qt Creator没什么特别的，一路next就行。但有几个关键点需要注意：

1. 安装时建议勾选所有组件，避免后续缺少依赖
2. 安装完成后先不要急着打开，我们需要先配置工具链
3. 把make工具的可执行文件路径添加到系统环境变量PATH中

交叉编译工具链解压后，你会看到一堆可执行文件。其中最重要的是aarch64-none-linux-gnu-g++，这是我们后面配置编译器时要用的。我建议把工具链的bin目录路径记下来，后面配置Qt Creator时会用到。

3. Qt Creator配置详解

3.1 配置编译器

打开Qt Creator后，首先进入"工具"->"选项"->"Kits"（有些版本可能在"编辑"->"参数"里）。这里我们需要配置三个关键部分：编译器、Qt版本和构建套件。

先来配置编译器：

1. 点击"编译器"选项卡
2. 选择"添加"->"GCC"->"C++"
3. 在"路径"处浏览选择交叉编译工具链中的g++（就是前面提到的aarch64-none-linux-gnu-g++）
4. 给编译器起个有意义的名字，比如"ARM64 GCC 10.3"

3.2 配置Qt版本

这一步很关键，需要使用预编译好的qmake：

1. 点击"Qt Versions"选项卡
2. 点击"添加"按钮
3. 浏览选择预编译好的qmake可执行文件
4. 给它起个名字，比如"Qt 5.14.2 ARM64"

这里有个常见坑点：如果直接使用官方安装的qmake，会报各种奇怪错误。必须使用专门为ARM64交叉编译配置过的qmake。我提供的资源包里有已经配置好的版本，解压后直接使用即可。

3.3 配置构建套件

最后把前面配置的内容组合起来：

1. 点击"Kits"选项卡
2. 点击"添加"按钮
3. 设置套件名称，比如"ARM64 Build"
4. 选择刚才配置的编译器和Qt版本
5. 设备类型选择"通用Linux设备"
6. Sysroot留空即可
7. 确保ABI设置正确（应该是arm64架构）

配置完成后，建议先点击"Apply"保存，然后关闭Qt Creator重新打开，确保配置生效。

4. 创建并编译QtWidget工程

4.1 新建项目

现在可以开始创建我们的第一个ARM64 QtWidget工程了：

1. 文件->新建文件或项目
2. 选择"Application"->"Qt Widgets Application"
3. 在Build System选择qmake（不要选CMake）
4. 选择我们刚才配置的ARM64套件
5. 完成项目创建向导

创建完成后，你会看到标准的Qt Widget项目结构。这里有个小技巧：可以先选择Desktop套件创建项目，然后再切换成ARM64套件，这样可以在Windows上先验证UI设计。

4.2 编译与部署

项目创建完成后，右键点击项目选择"构建"：

1. 第一次构建可能会比较慢，耐心等待
2. 构建成功后，在编译输出目录会生成可执行文件
3. 把这个文件拷贝到ARM64设备上运行测试

如果遇到libgcc_s_dw2-1.dll缺失的错误，可以把Qt安装目录下的对应dll文件（一般在bin目录里）复制到可执行文件同级目录，或者添加到系统环境变量PATH中。

5. 常见问题与解决方案

5.1 编译错误排查

在实际操作中，可能会遇到各种编译错误。我总结了几种常见情况：

1. "找不到编译器"错误：检查工具链路径是否正确，环境变量是否设置
2. Qt头文件找不到：检查qmake配置是否正确，特别是Qt版本路径
3. 链接错误：检查是否使用了正确的库文件，ARM64设备可能需要额外的库

5.2 性能优化建议

当项目越来越大时，编译速度可能会变慢。可以考虑：

1. 使用ccache加速编译
2. 在.pro文件中合理配置编译选项
3. 只编译必要的模块

5.3 调试技巧

在ARM设备上调试Qt程序有些特殊：

1. 可以使用gdbserver进行远程调试
2. 在Qt Creator中配置远程调试环境
3. 合理使用qDebug输出调试信息

经过这些步骤，你应该能在Windows10上顺利开发和编译ARM64平台的QtWidget应用了。虽然过程有些复杂，但一旦环境配置完成，后续开发就和其他Qt项目没什么区别了。我在实际项目中用这套环境开发了一个工业控制界面，运行在AM62X平台上非常稳定。