从零构建嵌入式Linux Qt开发环境：ARM平台实战指南

1. 环境准备：搭建开发环境的基石

在开始构建嵌入式Linux Qt开发环境之前，我们需要准备好必要的软硬件工具。就像盖房子需要打好地基一样，这一步决定了后续所有工作的稳定性。

首先需要一个64位的Ubuntu系统作为开发主机，推荐使用18.04或20.04 LTS版本，这两个版本在嵌入式开发社区中被广泛验证过。我自己的开发机用的是18.04，稳定性相当不错。如果你使用其他Linux发行版，可能需要自行调整部分命令。

交叉编译工具链是嵌入式开发的核心工具，它允许我们在x86主机上编译出能在ARM架构运行的代码。不同厂商提供的工具链可能略有差异，比如：

• ARM官方提供的gcc-arm-linux-gnueabihf
• 芯片厂商提供的定制工具链（如NXP的imx6ull工具链）
• Buildroot或Yocto构建的系统配套工具链

安装基础依赖包是下一步：

sudo apt-get update sudo apt-get install git make gcc g++ python3 perl

对于触摸屏支持，我们需要tslib库。这个库提供了触摸屏校准和滤波功能，能显著改善触摸体验。可以从GitHub获取最新源码：

wget https://github.com/libts/tslib/releases/download/1.22/tslib-1.22.tar.bz2

Qt版本选择也很关键。我推荐使用5.15 LTS版本，它长期支持且稳定性好。可以从Qt官方镜像下载：

wget https://download.qt.io/archive/qt/5.15/5.15.2/single/qt-everywhere-src-5.15.2.tar.xz

2. tslib编译与配置

tslib的编译是Qt触摸功能正常工作的前提条件。我曾经在一个项目上跳过这步，结果触摸坐标错乱，调试了整整两天才找到问题根源。

解压源码包：

tar xvf tslib-1.22.tar.bz2 cd tslib-1.22

安装编译依赖：

sudo apt-get install autoconf automake libtool pkg-config

配置编译选项时需要特别注意--host参数，它必须匹配你的交叉编译工具链前缀。比如使用arm-linux-gnueabihf工具链时应这样配置：

./configure --host=arm-linux-gnueabihf \ --prefix=/opt/tslib \ ac_cv_func_malloc_0_nonnull=yes

编译并安装：

make -j$(nproc) sudo make install

编译完成后，/opt/tslib目录下会生成bin、lib、include等子目录。将这些文件打包以便后续部署到开发板：

tar -cjf arm-tslib.tar.bz2 /opt/tslib

3. Qt源码交叉编译实战

Qt的交叉编译是个耗时且容易出错的过程。我遇到过各种奇怪的问题，从磁盘空间不足到工具链不兼容，所以请严格按照步骤操作。

解压Qt源码：

tar -xvf qt-everywhere-src-5.15.2.tar.xz cd qt-everywhere-src-5.15.2

修改qmake.conf是关键步骤，这个文件决定了Qt如何与交叉编译工具链交互。文件位于：

qtbase/mkspecs/linux-arm-gnueabi-g++/qmake.conf

主要修改内容包括：

QMAKE_CC = arm-linux-gnueabihf-gcc QMAKE_CXX = arm-linux-gnueabihf-g++ QMAKE_LINK = arm-linux-gnueabihf-g++ QMAKE_LINK_SHLIB = arm-linux-gnueabihf-g++

创建autoconfigure.sh配置脚本：

#!/bin/bash ./configure -prefix /opt/qt-5.15.2-arm \ -opensource \ -confirm-license \ -release \ -xplatform linux-arm-gnueabi-g++ \ -optimized-qmake \ -c++std c++11 \ -tslib \ -I /opt/tslib/include \ -L /opt/tslib/lib \ -no-opengl \ -no-icu \ -no-eglfs \ -no-iconv \ -nomake examples \ -nomake tests

给脚本执行权限并运行：

chmod +x autoconfigure.sh ./autoconfigure.sh

编译过程可能需要几个小时，建议使用-j参数加速：

make -j$(nproc) make install

编译完成后，将生成的Qt库打包：

tar -cjf arm-qt-5.15.2.tar.bz2 /opt/qt-5.15.2-arm

4. 开发板环境部署

将编译好的tslib和Qt库部署到开发板是让程序运行的关键一步。我通常使用NFS网络挂载的方式，这样调试起来最方便。

假设开发板的根文件系统挂载在/mnt/nfs，执行以下命令：

cp arm-tslib.tar.bz2 arm-qt-5.15.2.tar.bz2 /mnt/nfs/opt cd /mnt/nfs/opt tar -xf arm-tslib.tar.bz2 tar -xf arm-qt-5.15.2.tar.bz2

配置环境变量，编辑/etc/profile文件添加：

export TSLIB_ROOT=/opt/tslib export QT_ROOT=/opt/qt-5.15.2-arm export LD_LIBRARY_PATH=$TSLIB_ROOT/lib:$QT_ROOT/lib:$LD_LIBRARY_PATH export QT_QPA_PLATFORM_PLUGIN_PATH=$QT_ROOT/plugins export QT_QPA_PLATFORM=linuxfb:fb=/dev/fb0 export QT_QPA_GENERIC_PLUGINS=tslib:/dev/input/event1

使配置生效：

source /etc/profile

5. 测试与验证

Qt自带了很多示例程序，是验证环境是否正常工作的好方法。进入examples/widgets/animation/animatedtiles目录，执行：

./animatedtiles -platform linuxfb

如果看到动画界面，说明Qt环境已经正常工作。触摸测试可以使用tslib的工具：

ts_test

对于自己开发的程序，交叉编译时需要指定qmake路径：

/opt/qt-5.15.2-arm/bin/qmake make

将生成的可执行文件复制到开发板运行即可。如果遇到问题，可以检查：

1. 文件权限是否正确
2. 动态库路径是否设置正确
3. 显示设备参数是否匹配

6. 常见问题与解决方案

在实际项目中，我遇到过不少坑，这里分享几个典型问题的解决方法：

问题1：编译时提示找不到头文件解决方法：检查-I参数指定的路径是否正确，确保tslib和Qt的头文件路径被正确包含。

问题2：运行时报错找不到动态库解决方法：使用ldd查看程序依赖，确保所有库都在LD_LIBRARY_PATH包含的路径中。

问题3：触摸屏坐标不准解决方法：重新运行ts_calibrate校准触摸屏，检查环境变量QT_QPA_GENERIC_PLUGINS是否设置正确。

问题4：界面显示错乱解决方法：确认开发板的framebuffer设备节点是否正确，通常为/dev/fb0。

7. 进阶配置与优化

当基础环境搭建完成后，可以考虑以下优化措施：

使用OpenGL加速如果开发板支持GPU，可以编译OpenGL后端：

-eglfs -opengl es2

裁剪Qt模块通过-skip参数去掉不需要的模块，减小体积：

-skip qtwebengine -skip qt3d

静态编译对于存储空间有限的设备，可以考虑静态编译：

-static -no-shared

自定义字体只包含必要的中文字体，大幅减少空间占用：

make -C src/gui/embedded/qgenericunixfontdatabase INSTALL_ROOT=/opt/qt-5.15.2-arm install

嵌入式Qt开发环境的搭建虽然步骤繁琐，但掌握了这套流程后，就能在各种ARM平台上快速部署Qt应用程序。记得每次修改配置后保存好记录，这样下次搭建时可以节省大量时间。