1. ARM嵌入式Qt开发环境搭建全攻略第一次在ARM开发板上跑Qt程序时我踩了不少坑。记得当时编译了整整一晚上结果生成的程序在板子上死活跑不起来最后发现是tslib环境变量没配好。这次经历让我深刻认识到搭建完整的交叉编译环境需要系统化的操作流程。1.1 工具链与依赖库准备工欲善其事必先利其器。在Ubuntu 20.04上我们需要先准备好这些工具交叉编译器gcc-linaro-7.5.0根据开发板架构选择基础工具automake、libtool等触摸库tslib-1.21电容屏必备安装基础工具链的命令如下sudo apt-get update sudo apt-get install gcc g make automake libtool pkg-config特别提醒tslib的编译有个坑——必须指定ac_cv_func_malloc_0_nonnullyes参数否则会报内存分配错误。这是我用香橙派调试时得到的教训./configure --hostarm-linux-gnueabihf \ ac_cv_func_malloc_0_nonnullyes \ --prefix/opt/tslib1.2 开发板系统目录结构建议在开发板文件系统创建标准化目录/opt ├── tslib # 触摸库 └── qt5.12 # Qt运行环境环境变量配置示例/etc/profileexport TSLIB_ROOT/opt/tslib export QT_ROOT/opt/qt5.12 export LD_LIBRARY_PATH$TSLIB_ROOT/lib:$QT_ROOT/lib:$LD_LIBRARY_PATH2. Qt源码交叉编译实战选择Qt版本就像选装备——不是越新越好。经过多次测试Qt 5.12.9在ARMv7上的稳定性最佳。下载源码建议用清华镜像站速度能快10倍不止。2.1 关键配置参数解析这个configure命令参数是我调试过最稳定的组合./configure -prefix /opt/qt-arm \ -opensource -confirm-license \ -xplatform linux-arm-gnueabi-g \ -no-opengl -linuxfb -tslib \ -I/opt/tslib/include -L/opt/tslib/lib重点参数说明-no-opengl禁用OpenGL多数ARM板不支持-linuxfb使用Linux帧缓冲-tslib启用触摸屏支持2.2 编译加速技巧遇到大型项目编译试试这些方法使用-j$(nproc)全核编译先编译基础模块make module-qtbase -j8 make module-qtserialport -j8跳过非必要模块如qtwebengine我曾经用Jetson Nano编译Qt WebEngine整整花了6小时后来发现根本用不到这个模块。3. Qt Creator环境配置详解安装Qt Creator时有个隐藏技巧使用.run安装包比apt安装的版本更稳定。建议下载5.12.9配套版本。3.1 交叉编译套件配置配置步骤图解编译器设置指向交叉编译器的gQt版本选择交叉编译生成的qmake调试器配置gdb-multiarch常见报错解决方案qmake not found → 检查qmake路径权限GL/gl.h missing → 安装libgl1-mesa-dev3.2 项目构建配置技巧在.pro文件中添加这些配置可以避免90%的部署问题target.path /home/root INSTALLS target LIBS -L$${TSLIB_ROOT}/lib -lts INCLUDEPATH $${TSLIB_ROOT}/include4. 部署与调试实战心得4.1 文件传输黑科技除了scp推荐用rsync增量同步节省大量时间rsync -avz --delete build/ userarmboard:/opt/app4.2 字体问题解决方案中文显示乱码把Windows的微软雅黑字体复制到开发板sudo mkdir -p /usr/share/fonts cp msyh.ttf /usr/share/fonts fc-cache -fv4.3 性能优化参数在main.cpp中添加这些设置界面流畅度提升明显QApplication::setAttribute(Qt::AA_EnableHighDpiScaling); QCoreApplication::setAttribute(Qt::AA_UseSoftwareOpenGL);5. 常见问题排错指南5.1 触摸屏校准异常现象点击位置偏移 解决方法export TSLIB_CALIBFILE/etc/pointercal ts_calibrate5.2 段错误(Segmentation Fault)排查步骤用file查看程序架构是否匹配ldd检查动态库链接strace跟踪系统调用5.3 内存泄漏检测在开发板运行valgrind --leak-checkfull ./yourapp记得第一次成功在ARM板跑起Qt程序时那个简单的Hello World窗口让我激动了半天。后来项目上线后这套环境稳定运行了3年没出过问题。现在每次看到那些编译参数都能想起当年调试时掉的头发。建议新手一定要做好编译笔记这些经验都是无价的财富。