保姆级教程：在Ubuntu 20.04上为RK3588编译Qt 5.15.2的aarch64版本qmake
保姆级教程：在Ubuntu 20.04上为RK3588编译Qt 5.15.2的aarch64版本qmake
RK3588作为新一代高性能ARM处理器，正逐渐成为嵌入式开发的热门选择。而Qt作为跨平台开发框架，其强大的GUI能力和丰富的功能库，使其成为嵌入式界面开发的首选。本文将手把手教你如何在Ubuntu 20.04上为RK3588编译Qt 5.15.2的aarch64版本qmake，即使编译过程中出现错误，也能获取可用的qmake工具。
1. 环境准备与工具安装
在开始编译之前，我们需要准备好开发环境和必要的工具链。Ubuntu 20.04作为长期支持版本，提供了稳定的基础环境。
首先更新系统并安装基础依赖：
sudo apt update && sudo apt upgrade -y sudo apt install build-essential git python3 perl -y接下来安装aarch64交叉编译工具链：
sudo apt install gcc-aarch64-linux-gnu g++-aarch64-linux-gnu -y验证工具链是否安装成功：
aarch64-linux-gnu-gcc --version如果看到类似aarch64-linux-gnu-gcc (Ubuntu 9.4.0-1ubuntu1~20.04) 9.4.0的输出，说明工具链安装正确。
2. 获取Qt源码并配置编译选项
Qt官方提供了完整的源代码包，我们需要下载与目标版本一致的源码：
wget https://download.qt.io/archive/qt/5.15/5.15.2/single/qt-everywhere-src-5.15.2.tar.xz tar xvf qt-everywhere-src-5.15.2.tar.xz cd qt-everywhere-src-5.15.2配置编译选项是关键步骤，以下是一个针对RK3588优化的配置示例：
./configure -prefix $PWD/qtbase/bin \ -opensource \ -confirm-license \ -xplatform linux-aarch64-gnu-g++ \ -no-opengl \ -nomake examples \ -nomake tests \ -skip qtscript \ -skip qtwebengine \ -skip qtlocation \ -skip qtsensors \ -skip qtconnectivity \ -skip qtwayland \ -skip qt3d配置参数说明：
| 参数 | 作用 |
|---|---|
-prefix | 指定安装目录 |
-xplatform | 指定目标平台 |
-no-opengl | 禁用OpenGL支持 |
-nomake | 跳过不需要的模块编译 |
-skip | 跳过特定模块 |
3. 处理编译过程中的常见问题
开始编译：
make -j$(nproc)在编译过程中，可能会遇到以下常见错误：
Unknown module错误：
Unknown module(s) in QT: bootstrap-private这通常是由于某些模块依赖关系导致的，但好消息是这些错误通常不会影响qmake的生成。
缺少依赖错误：
Project ERROR: Unknown module(s) in QT: script-private可以通过在配置时添加
-skip qtscript来避免。
关键技巧：即使编译报错，只要生成了qmake就可以停止编译。检查是否已生成qmake：
ls qtbase/bin/qmake如果该文件存在，就可以进入下一步配置，无需等待完整编译完成。
4. 在Qt Creator中配置开发环境
现在我们已经有了aarch64版本的qmake，接下来需要在Qt Creator中配置开发环境。
- 打开Qt Creator，进入
工具 > 选项 > Kits - 在"Qt Versions"标签页中，点击"添加"按钮
- 选择我们编译生成的qmake路径（
qt-everywhere-src-5.15.2/qtbase/bin/qmake） - 点击"Apply"保存
接下来配置构建套件(Kit)：
在"Kits"标签页中，点击"添加"按钮
配置如下参数：
参数 值 Name RK3588 Qt 5.15.2 Device type Generic Linux Device Sysroot (留空或指定sysroot路径) Compiler aarch64-linux-gnu-g++ Qt version 选择刚才添加的Qt版本 点击"OK"保存配置
5. 创建和测试ARM64项目
现在可以创建一个测试项目来验证我们的配置是否正确。
- 新建一个Qt Widgets Application项目
- 在"Kit Selection"步骤，选择我们刚创建的"RK3588 Qt 5.15.2"套件
- 完成项目创建后，添加一些简单的界面元素
- 点击"构建"按钮进行编译
编译成功后，将生成的二进制文件复制到RK3588开发板上运行测试：
scp your_app root@rk3588_ip:/home/root/ ssh root@rk3588_ip ./your_app如果程序正常运行，说明我们的交叉编译环境配置成功。
6. 性能优化与调试技巧
为了获得更好的开发体验，这里分享几个实用技巧：
加速编译：
- 使用
ccache缓存编译结果 - 在
make命令中添加-j$(nproc)参数使用所有CPU核心
- 使用
减小体积：
aarch64-linux-gnu-strip your_app这个命令可以去除调试符号，显著减小可执行文件大小
调试支持： 安装gdbserver到开发板：
sudo apt install gdbserver然后在开发板上运行：
gdbserver :1234 ./your_app在主机上使用交叉调试器连接：
aarch64-linux-gnu-gdb your_app (gdb) target remote rk3588_ip:1234Qt Creator远程调试： 配置Qt Creator的"设备"选项，添加RK3588开发板的SSH连接，可以实现直接在IDE中部署和调试程序
7. 常见问题解决方案
在实际开发中，可能会遇到以下问题：
运行时报错缺少库： 解决方案：
- 在开发板上安装缺失的库
- 或者使用静态链接编译：
./configure ... -static
字体显示异常： 确保开发板上安装了必要的字体：
sudo apt install fonts-dejavu触摸屏支持： 如果需要触摸屏支持，在配置时不要跳过
tslib相关选项高DPI显示适配： 在main函数中添加：
QApplication::setAttribute(Qt::AA_EnableHighDpiScaling);
经过多次项目实践，我发现最关键的步骤是正确配置交叉编译工具链和Qt的编译选项。即使编译过程中出现一些模块错误，只要生成了可用的qmake，就能满足大部分开发需求。对于RK3588这样的高性能ARM平台，合理配置Qt的模块可以显著提升开发效率和运行性能。