在Ubuntu 20.04上为ARM开发板交叉编译Qt 5.14.2（含QtWebEngine完整依赖清单）
在Ubuntu 20.04上为ARM开发板交叉编译Qt 5.14.2（含QtWebEngine完整依赖清单）
为嵌入式ARM设备构建Qt开发环境是许多工业控制和智能设备开发者的必经之路。不同于桌面应用的直接部署，嵌入式开发需要解决交叉编译工具链配置、依赖库兼容性、硬件加速支持等一系列独特挑战。本文将手把手带你完成从Ubuntu主机环境准备到生成ARM架构Qt SDK的全过程，特别针对QtWebEngine这一依赖复杂的模块提供经过验证的解决方案。
1. 环境准备与源码获取
在开始编译之前，我们需要确保主机系统具备完整的开发工具链和基础依赖库。Ubuntu 20.04作为长期支持版本，其软件仓库中的工具版本与Qt 5.14.2有较好的兼容性。
首先安装基础编译工具：
sudo apt update sudo apt install build-essential git python libgl1-mesa-dev获取Qt源码有两种推荐方式：
- 从官方镜像下载完整源码包：
wget https://download.qt.io/new_archive/qt/5.14/5.14.2/single/qt-everywhere-src-5.14.2.tar.xz- 使用Git仓库获取（便于后续补丁管理）：
git clone git://code.qt.io/qt/qt5.git cd qt5 git checkout v5.14.2 perl init-repository --module-subset=default,-qt3d,-qtactiveqt解压源码包建议放在/opt目录下，便于多用户共享：
sudo tar -xvf qt-everywhere-src-5.14.2.tar.xz -C /opt/ sudo chown -R $USER:$USER /opt/qt-everywhere-src-5.14.22. 交叉编译工具链配置
针对不同ARM架构的开发板，需要准备对应的工具链。以下是常见开发板的工具链选择：
| 开发板类型 | 推荐工具链 | 安装方法 |
|---|---|---|
| 树莓派3/4 | gcc-arm-linux-gnueabihf | sudo apt install g++-arm-linux-gnueabihf |
| RK3399 | aarch64-linux-gnu-gcc | sudo apt install g++-aarch64-linux-gnu |
| i.MX6/8 | 官方提供的fsl-linaro-toolchain | 需从NXP官网下载 |
配置工具链环境变量示例（以aarch64为例）：
export TOOLCHAIN_PATH=/usr/bin export CROSS_COMPILE=aarch64-linux-gnu- export CC=${CROSS_COMPILE}gcc export CXX=${CROSS_COMPILE}g++ export AR=${CROSS_COMPILE}ar export LD=${CROSS_COMPILE}ld3. QtWebEngine完整依赖解决方案
QtWebEngine作为整合Chromium的模块，其依赖关系极为复杂。经过多次实践验证，以下是在Ubuntu 20.04上必须安装的依赖库清单：
核心图形库依赖：
sudo apt install libxcomposite-dev libxcursor-dev libxi-dev \ libxrandr-dev libxtst-dev libxss-dev libxkbcommon-dev \ libdrm-dev libgbm-dev libglu1-mesa-dev多媒体支持组件：
sudo apt install libpulse-dev libasound2-dev libgstreamer1.0-dev \ libgstreamer-plugins-base1.0-dev gstreamer1.0-plugins-good \ gstreamer1.0-plugins-bad系统服务相关依赖：
sudo apt install libdbus-1-dev libcap-dev libpci-dev libudev-dev \ libnss3-dev libfontconfig1-dev libicu-dev libxslt-dev \ libevent-dev libsystemd-dev特别容易遗漏的工具链：
sudo apt install bison flex gperf ninja-build nodejs验证nodejs版本（要求≥8.0）：
node --version npm --version4. 配置参数详解与优化
创建自动配置脚本configure-qt.sh，以下是最关键的参数解析：
基础编译选项：
#!/bin/bash ./configure \ -prefix /opt/qt5.14.2-arm \ -extprefix /opt/qt5.14.2-arm-sdk \ -hostprefix /opt/qt5.14.2-arm-tools \ -opensource \ -confirm-license \ -release \ -c++std c++11 \ -shared \ -optimized-qmake模块裁剪策略（根据嵌入式需求）：
-skip qt3d \ -skip qtactiveqt \ -skip qtandroidextras \ -skip qtwebglplugin \ -skip qtgamepad \ -nomake examples \ -nomake tests图形后端选择（根据目标板GPU支持情况）：
-no-opengl \ -linuxfb \ -eglfs \ -qpa xcb第三方库集成方式：
-qt-zlib \ -qt-libpng \ -qt-libjpeg \ -qt-freetype \ -qt-harfbuzz \ -qt-pcre \ -no-openssl \ -system-sqlite交叉编译关键参数：
-xplatform linux-aarch64-gnu-g++ \ -sysroot /opt/sysroot \ -device-option CROSS_COMPILE=aarch64-linux-gnu-执行配置脚本并开始编译：
chmod +x configure-qt.sh ./configure-qt.sh 2>&1 | tee configure.log make -j$(nproc) 2>&1 | tee build.log sudo make install5. 常见问题排查指南
问题1：gperf未找到错误
sudo apt install gperf export PATH=$PATH:/usr/local/bin问题2：GL/gl.h缺失
sudo apt install libgl1-mesa-dev libglu1-mesa-dev问题3：WebEngine编译卡在nodejs步骤
# 检查nodejs版本 node --version # 若版本低于8.x，需手动升级 curl -sL https://deb.nodesource.com/setup_12.x | sudo -E bash - sudo apt install nodejs问题4：内存不足导致编译失败
# 限制并行编译任务数 make -j4 # 或创建交换空间 sudo fallocate -l 4G /swapfile sudo chmod 600 /swapfile sudo mkswap /swapfile sudo swapon /swapfile编译完成后验证生成的文件架构：
file /opt/qt5.14.2-arm/bin/qmake # 应显示"ELF 64-bit LSB executable, ARM aarch64"6. 目标板部署与验证
将编译好的SDK打包传输到开发板：
tar -czvf qt5.14.2-arm-sdk.tar.gz /opt/qt5.14.2-arm-sdk scp qt5.14.2-arm-sdk.tar.gz pi@192.168.1.100:/home/pi在开发板上配置环境变量：
export QT_ROOT=/home/pi/qt5.14.2-arm-sdk export PATH=$QT_ROOT/bin:$PATH export LD_LIBRARY_PATH=$QT_ROOT/lib:$LD_LIBRARY_PATH创建简单的测试程序验证功能：
// test_webengine.cpp #include <QApplication> #include <QWebEngineView> int main(int argc, char *argv[]) { QApplication app(argc, argv); QWebEngineView view; view.load(QUrl("https://www.qt.io")); view.show(); return app.exec(); }编译测试程序：
qmake -project qmake make在实际项目中，建议使用sysroot方法管理目标板依赖库，保持开发环境与运行环境的一致性。将开发板的/lib和/usr/lib目录复制到主机的sysroot目录，配置qmake时通过-sysroot参数指定路径。