1. 项目概述最近在折腾一块基于i.MX6ULL的嵌入式开发板想把一个用Qt写的图形界面程序跑上去。这听起来像是嵌入式开发的“标准操作”但真动起手来从交叉编译环境搭建、Qt库的裁剪编译到最终在资源受限的板子上把程序跑起来每一步都可能藏着坑。网上教程不少但要么环境对不上要么步骤跳得太快缺了关键细节。我把自己从零开始成功在ARM Linux开发板上搭建Qt 5运行环境并测试程序的全过程梳理了一遍重点不是罗列命令而是解释清楚每个步骤背后的“为什么”以及我踩过的那些坑。如果你也在为嵌入式Qt移植头疼希望这篇记录能帮你少走弯路。1.1 核心需求与方案选型我们的目标很明确在一个运行Linux的ARM开发板以NXP i.MX6ULL为例上运行我们自己编写的Qt应用程序。开发主机是x86_64架构的Ubuntu系统。这注定是一个交叉编译的过程。为什么选择Qt在嵌入式领域Qt因其跨平台特性、丰富的控件库、成熟的工具链Qt Creator以及对触摸屏的良好支持成为开发复杂图形界面应用的首选之一。但Qt本身比较庞大直接使用桌面版的库是不现实的必须针对目标板的架构ARM、图形后端如LinuxFB以及可能用到的输入设备如tslib触摸屏进行定制化编译。整个方案的核心链路是在Ubuntu主机上使用ARM交叉编译工具链编译出适用于开发板的tslib触摸屏库和Qt库然后将编译好的库文件、插件及可执行程序打包移植到开发板的文件系统中并配置好相应的环境变量。这里有几个关键决策点交叉编译工具链必须与开发板内核、C库版本匹配。我使用的是开发板厂商提供的arm-linux-gnueabihf-gcc工具链它针对ARM硬浮点架构进行了优化能提升图形运算性能。Qt版本选择并非越新越好。Qt 5.15 LTS是长期支持版本理论上更稳定但我在编译其最新子版本时遇到了棘手的编译错误。经过权衡我退而求其次选择了Qt 5.12.9这是一个经过大量项目验证的稳定版本编译过程更顺畅。在嵌入式开发中稳定性往往优先于新特性。图形后端开发板通常没有GPU和标准的X Window桌面环境因此我们需要使用linuxfbLinux帧缓冲后端。它直接向/dev/fb0这类帧缓冲设备绘制图形开销小适合嵌入式环境。输入设备电阻式触摸屏需要tslib来进行校准和去抖处理。Qt可以通过tslib插件来读取触摸事件。2. 基础环境与依赖库准备在开始编译Qt这座“大厦”之前必须先把地基打牢。这个地基就是交叉编译工具链和必要的依赖库首当其冲的就是tslib。2.1 交叉编译工具链确认首先确保你的主机上已经安装并配置好了正确的交叉编译工具链。可以通过以下命令验证arm-linux-gnueabihf-gcc --version如果命令未找到你需要根据开发板厂商的指引安装对应的工具链并将其路径添加到系统的PATH环境变量中。这一步是后续所有编译工作的前提工具链不对编译出来的二进制文件根本无法在板子上运行。2.2 tslib的编译与详解tslib是一个用于触摸屏校准、滤波的库Qt的linuxfb平台通过插件与之对接。编译它相对简单但有几个配置项至关重要。2.2.1 获取与解压源码建议从GitHub的release页面下载稳定版本比如tslib-1.21.tar.bz2。将其拷贝到Ubuntu工作目录并解压。tar xvf tslib-1.21.tar.bz2 cd tslib-1.212.2.2 安装编译依赖tslib的编译系统基于autotools需要一些基础工具sudo apt-get install autoconf automake libtool这些工具用于生成最终的configure脚本。2.2.3 配置与编译这是最关键的一步。我们需要在一个独立的目录例如/home/work/arm-tslib中存放编译结果避免污染源码目录。# 创建一个用于存放编译输出的目录 mkdir -p /home/work/arm-tslib # 在源码目录中执行配置 ./configure --hostarm-linux-gnueabihf \ ac_cv_func_malloc_0_nonnullyes \ --cache-filearm-linux.cache \ --prefix/home/work/arm-tslib参数解析--hostarm-linux-gnueabihf指定编译出来的程序运行在ARM架构的Linux系统上这是交叉编译的核心标志。ac_cv_func_malloc_0_nonnullyes这是一个针对交叉编译环境的缓存变量设置。有些工具链的malloc(0)函数可能返回NULL而tslib的配置检测可能会因此失败。强制指定它为yes可以绕过这个检测。--cache-file指定缓存文件加速后续的配置过程。--prefix指定make install时的安装路径。所有编译生成的头文件、库文件都会放到这个目录下。配置成功后执行编译和安装make -j4 # 使用4个线程并行编译加快速度 make install执行完make install后查看/home/work/arm-tslib目录你会看到bin,include,lib,etc等子目录里面就是我们需要移植到开发板上的全部文件。2.2.4 打包与移植准备为了方便移植我们将整个目录打包cd /home/work tar -jcf arm-tslib.tar.bz2 arm-tslib/生成的arm-tslib.tar.bz2文件就是我们需要复制到开发板上的“tslib运行时环境”。注意事项一关于ac_cv_func_malloc_0_nonnull这个参数是编译tslib时最容易卡住的地方。如果编译时出现关于malloc的检查错误显式设置这个缓存变量几乎能解决90%的问题。它的本质是告诉配置系统“别检查了就假设malloc(0)返回非空指针”。3. Qt源码的交叉编译实战Qt源码的交叉编译是整个过程中最耗时、也最容易出错的环节。我们需要根据目标板的特性对庞大的Qt源码进行裁剪和配置。3.1 源码获取与解压从Qt官方归档站点下载所需的源码包例如qt-everywhere-src-5.12.9.tar.xz。使用5.12.9是因为其稳定性经过验证与我使用的工具链兼容性好。tar -xvf qt-everywhere-src-5.12.9.tar.xz cd qt-everywhere-src-5.12.93.2 关键配置qmake.conf文件修改Qt的编译系统qmake需要知道如何为你的目标平台调用编译器。这个信息存储在mkspecs目录下的配置文件中。对于ARM Linux我们需要修改qtbase/mkspecs/linux-arm-gnueabi-g/qmake.conf。为什么是linux-arm-gnueabi-g目录这个目录名对应-xplatform参数。我们后续配置会指定-xplatform linux-arm-gnueabi-gqmake就会来这里找编译规则。打开该文件将其内容修改为# qmake configuration for building with arm-linux-gnueabihf-g MAKEFILE_GENERATOR UNIX CONFIG incremental QMAKE_INCREMENTAL_STYLE sublib include(../common/linux.conf) include(../common/gcc-base-unix.conf) include(../common/g-unix.conf) # modifications to g.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 # modifications to linux.conf QMAKE_AR arm-linux-gnueabihf-ar cqs QMAKE_OBJCOPY arm-linux-gnueabihf-objcopy QMAKE_NM arm-linux-gnueabihf-nm -P QMAKE_STRIP arm-linux-gnueabihf-strip load(qt_config)关键修改点将所有arm-linux-gnueabi-*替换成你自己的工具链前缀arm-linux-gnueabihf-*。这个文件定义了编译、链接、归档等所有环节使用的具体命令必须与你的工具链完全一致。3.3 编写自动化配置脚本Qt的configure脚本选项繁多手动输入既容易出错也不利于复用。最佳实践是编写一个shell脚本。我创建了一个autoconfigure.sh文件内容如下#!/bin/bash ./configure -prefix /home/work/arm-qt \ -opensource \ -confirm-license \ -release \ -strip \ -shared \ -xplatform linux-arm-gnueabi-g \ -optimized-qmake \ -cstd c11 \ -rpath no \ -pch \ -skip qt3d \ -skip qtactiveqt \ -skip qtandroidextras \ -skip qtcanvas3d \ -skip qtconnectivity \ -skip qtdatavis3d \ -skip qtdoc \ -skip qtgamepad \ -skip qtlocation \ -skip qtmacextras \ -skip qtnetworkauth \ -skip qtpurchasing \ -skip qtremoteobjects \ -skip qtscript \ -skip qtscxml \ -skip qtsensors \ -skip qtspeech \ -skip qtsvg \ -skip qttools \ -skip qttranslations \ -skip qtwayland \ -skip qtwebengine \ -skip qtwebview \ -skip qtwinextras \ -skip qtx11extras \ -skip qtxmlpatterns \ -make libs \ -make examples \ -nomake tools \ -nomake tests \ -gui \ -widgets \ -dbus-runtime \ -glib no \ -iconv no \ -pcre qt \ -zlib qt \ -openssl no \ -freetype qt \ -harfbuzz qt \ -no-opengl \ -linuxfb \ -xcb no \ -tslib \ -libpng qt \ -libjpeg qt \ -sqlite qt \ -plugin-sql-sqlite \ -I/home/work/arm-tslib/include \ -L/home/work/arm-tslib/lib \ -recheck-all核心配置项深度解析路径相关 (-prefix,-I,-L)-prefix /home/work/arm-qt指定Qt的安装目录编译好的库和头文件将放在这里。-I和-L分别指定tslib的头文件和库文件搜索路径。这里必须指向你之前编译好的arm-tslib目录这样Qt编译时才能找到tslib并链接。基础属性-opensource -confirm-license使用开源版本并自动确认许可。-release -strip编译发布版本并剥离调试符号减少最终库文件大小。-shared编译动态链接库。嵌入式环境也推荐使用动态库便于多个应用共享节省存储空间。-xplatform linux-arm-gnueabi-g指定目标平台规范对应我们修改过的qmake.conf文件。模块裁剪 (-skip)这是减小Qt体积的关键我跳过了大量在嵌入式GUI应用中用不到的模块例如3D、蓝牙、Web引擎、文档等。裁剪原则是只保留你应用确实需要的模块。例如如果你的应用不需要数据库功能-sqlite qt和-plugin-sql-sqlite也可以去掉。图形与输入后端-linuxfb -xcb no指定使用Linux帧缓冲作为图形后端禁用XCBX11。-tslib启用tslib支持这是触摸屏能用的关键。-no-opengli.MX6ULL没有GPU因此禁用OpenGL。第三方库-freetype qt,-zlib qt,-libpng qt等使用Qt自带的bundled第三方库版本避免再去交叉编译这些依赖简化流程。-openssl no如果应用不需要网络加密通信可以禁用进一步简化。注意事项二磁盘空间与编译时间编译Qt需要大量的磁盘空间至少20GB剩余空间和较长的编译时间在4核虚拟机上可能需1-2小时。务必在开始前检查磁盘空间并使用make -j$(nproc)充分利用所有CPU核心加速编译。3.4 执行编译与安装给脚本加上执行权限并运行chmod x autoconfigure.sh ./autoconfigure.sh配置过程会持续几分钟检查各项依赖。成功后执行编译和安装make -j$(nproc) # 使用所有可用核心编译 make install编译完成后/home/work/arm-qt目录下就包含了完整的、针对ARM架构的Qt运行环境。同样我们将其打包以备移植cd /home/work tar -jcf arm-qt.tar.bz2 arm-qt/3.5 编译问题排查实录问题1编译过程中虚拟机磁盘空间不足现象make编译到中途报错提示“No space left on device”。排查使用df -h命令确认根分区已满。解决给虚拟机扩容。对于VirtualBox可以使用VBoxManage命令修改虚拟硬盘大小然后在Ubuntu内使用gparted工具扩展分区。务必在编译前确保有充足空间。问题2编译Qt 5.15.2时遇到诡异错误现象使用较新的Qt 5.15.2源码编译时在某个模块如QtCore出现复杂的模板编译错误。排查搜索错误信息发现可能与特定版本的GCC工具链或C标准库的兼容性有关。尝试调整-cstd参数或升级工具链均未解决。解决策略性降级。嵌入式开发中追求最新版本往往带来不必要的麻烦。我果断切换回经过广泛验证的Qt 5.12.9配置脚本几乎不用修改编译一次通过。这是嵌入式开发中一个重要的实用原则在稳定性和新特性之间优先选择稳定性。4. 开发板环境部署与配置编译好的库只是“武器”我们需要把“武器”部署到“战场”开发板上并告诉系统怎么使用它们。4.1 文件系统移植假设开发板通过NFS挂载了主机的根文件系统或者你可以通过scp等方式传输文件。我们将两个压缩包复制到开发板的/usr/lib目录下此目录通常用于存放第三方库并解压。# 在开发板上操作假设压缩包已在当前目录 cp arm-tslib.tar.bz2 /usr/lib/ cp arm-qt.tar.bz2 /usr/lib/ cd /usr/lib tar xf arm-tslib.tar.bz2 tar xf arm-qt.tar.bz2 rm arm-tslib.tar.bz2 arm-qt.tar.bz2 # 解压后删除压缩包节省空间解压后/usr/lib目录下会多出arm-tslib和arm-qt两个文件夹。4.2 环境变量配置——灵魂所在环境变量是连接应用程序、Qt库、tslib库和系统设备的桥梁。我们需要编辑开发板上的/etc/profile文件或创建/etc/profile.d/myqt.sh添加以下内容# tslib 环境变量 export TSLIB_ROOT/usr/lib/arm-tslib export TSLIB_CONSOLEDEVICEnone # 控制台设备设为none export TSLIB_FBDEVICE/dev/fb0 # 帧缓冲设备通常是fb0 export TSLIB_TSDEVICE/dev/input/event1 # 触摸屏设备节点需根据实际情况调整 export TSLIB_CONFFILE$TSLIB_ROOT/etc/ts.conf export TSLIB_PLUGINDIR$TSLIB_ROOT/lib/ts export TSLIB_CALIBFILE/etc/pointercal # 触摸校准文件存放位置 export LD_PRELOAD$TSLIB_ROOT/lib/libts.so # 预加载tslib库 # Qt 环境变量 export QT_ROOT/usr/lib/arm-qt export QT_QPA_GENERIC_PLUGINStslib:/dev/input/event1 # 指定输入插件为tslib export QT_QPA_FONTDIR/usr/share/fonts # 字体目录 export QT_QPA_PLATFORM_PLUGIN_PATH$QT_ROOT/plugins # Qt平台插件路径 export QT_QPA_PLATFORMlinuxfb:tty/dev/fb0 # 指定平台为linuxfb使用fb0 export QT_PLUGIN_PATH$QT_ROOT/plugins # 通用插件路径 export LD_LIBRARY_PATH$QT_ROOT/lib:$QT_ROOT/plugins/platforms:$LD_LIBRARY_PATH export QML2_IMPORT_PATH$QT_ROOT/qml # QML模块路径 export QT_QPA_FB_TSLIB1 # 启用linuxfb对tslib的支持关键变量解析与避坑指南TSLIB_TSDEVICE这是第一个大坑。/dev/input/event1不一定是你的触摸屏设备。你需要通过cat /proc/bus/input/devices命令来查看你的触摸屏对应哪个event节点。可能是event0,event2等等。设置错误会导致触摸无反应。QT_QPA_PLATFORM指定图形平台为linuxfb参数tty/dev/fb0告诉Qt使用哪个帧缓冲设备。如果你的系统有多个显示设备可能需要调整。LD_LIBRARY_PATH这是第二个大坑。它告诉系统动态链接器去哪里寻找Qt的共享库。必须包含$QT_ROOT/lib和$QT_ROOT/plugins/platforms。后者尤其重要因为libqlinuxfb.so等平台插件就放在这里找不到插件会导致程序启动失败并报错“Could not find the Qt platform plugin”。QT_QPA_GENERIC_PLUGINS告诉Qt使用tslib作为输入插件并指定设备节点。LD_PRELOAD强制系统在启动任何程序前先加载tslib的库确保触摸事件能被正确拦截和处理。配置完成后执行source /etc/profile让环境变量立即生效或者直接重启开发板。注意事项三环境变量调试如果程序启动失败首先通过echo $LD_LIBRARY_PATH等命令检查环境变量是否设置正确。一个快速测试方法是ls $QT_ROOT/plugins/platforms看是否能列出libqlinuxfb.so等文件。如果找不到说明QT_ROOT路径设置错了。5. Qt程序运行测试与深度排查环境配置好后不要急于运行自己的复杂应用先用Qt自带的例子进行测试它们是最简单的“试金石”。5.1 运行内置示例程序进入Qt编译输出的examples目录找一个简单的例子比如widgets/animation/animatedtilescd /usr/lib/arm-qt/examples/widgets/animation/animatedtiles ./animatedtiles -platform linuxfb这里显式指定了-platform linuxfb参数以确保程序使用我们配置的FB后端。成功现象屏幕上应该会出现一个动画的瓷砖效果窗口。如果你连接了触摸屏尝试点击它应该能看到交互反馈。5.2 交叉编译自己的Qt程序在Ubuntu开发机上使用我们刚编译好的Qt套件来编译你的应用程序。配置Qt Creator在Qt Creator的“工具”-“选项”-“Kits”中添加一个新的“设备”Device类型为“通用Linux设备”配置好开发板的IP和登录信息。然后添加一个新的“编译套件”Kit编译器选择你的arm-linux-gnueabihf-gcc和g。调试器选择对应的arm-linux-gnueabihf-gdb如果不需要调试可暂不设置。Qt版本点击“管理”添加/home/work/arm-qt/bin/qmakeQt Creator会自动识别出这个Qt版本。将新添加的Qt版本和编译器分配给这个Kit并选择刚才创建的设备作为部署设备。编译与部署用这个新建的Kit打开你的Qt项目选择“Release”模式进行构建。构建成功后在“项目”设置中配置部署路径如/home/root然后将可执行文件以及它可能依赖的特定资源文件如图片、qml文件部署到开发板。在开发板上运行通过串口或SSH登录开发板进入程序所在目录运行./YourApp -platform linuxfb5.3 常见问题与排查技巧实录即使按照步骤操作也可能会遇到问题。下面是我遇到过的典型问题及解决方法问题1程序启动时报错 “Could not find the Qt platform plugin “linuxfb” in ”原因QT_QPA_PLATFORM_PLUGIN_PATH环境变量设置错误或者LD_LIBRARY_PATH没有包含平台插件目录导致系统找不到libqlinuxfb.so。排查echo $QT_QPA_PLATFORM_PLUGIN_PATH确认路径是/usr/lib/arm-qt/plugins。ls $QT_QPA_PLATFORM_PLUGIN_PATH/platforms确认libqlinuxfb.so文件存在。echo $LD_LIBRARY_PATH确认其中包含了$QT_ROOT/plugins/platforms。解决仔细检查/etc/profile中的路径设置确保QT_ROOT变量正确并且LD_LIBRARY_PATH包含了必要的路径。然后执行source /etc/profile。问题2程序启动后黑屏或者屏幕闪烁后退出原因A帧缓冲设备/dev/fb0权限不足或者被其他进程占用。排查与解决检查/dev/fb0的权限ls -l /dev/fb0确保当前用户有读写权限通常需要root。使用fuser /dev/fb0查看是否有其他进程占用。原因BQt程序链接了错误的库或者库版本不匹配。排查与解决在开发板上使用ldd ./YourApp命令检查程序的动态库依赖。确保所有Qt相关的库如libQt5Core.so.5,libQt5Gui.so.5,libQt5Widgets.so.5都指向/usr/lib/arm-qt/lib下的版本而不是系统自带的x86版本。如果指向错误检查LD_LIBRARY_PATH。问题3触摸屏点击位置不准或无反应原因ATSLIB_TSDEVICE环境变量设置错误指向了错误的event节点。排查使用ts_test工具在arm-tslib/bin目录下进行测试。先export好所有tslib环境变量然后运行ts_test。如果工具本身就没反应基本就是设备节点错了。解决重新确认触摸屏设备节点。原因B触摸屏未校准。解决运行ts_calibrate进行五点校准。校准数据会保存到TSLIB_CALIBFILE指定的文件默认为/etc/pointercal中。每次系统启动后如果触摸不准都需要重新校准。可以考虑将校准命令加入开机脚本。原因CQt环境变量QT_QPA_GENERIC_PLUGINS未设置或设置错误。解决确保其值为tslib:/dev/input/eventXX是你的正确事件号。问题4中文字体不显示原因QT_QPA_FONTDIR指向的目录没有中文字体或者Qt编译时未包含字体库支持但我们配置中已包含-freetype qt。解决将中文字体文件如.ttf格式的文泉驿、思源字体拷贝到开发板的/usr/share/fonts目录下。可以在Ubuntu系统的/usr/share/fonts/truetype目录下找一些字体文件。问题5运行程序时报 “Fatal: This application failed to start because no Qt platform plugin could be initialized.”原因这是一个综合错误可能由上述多个问题共同导致但根本原因是平台插件初始化失败。排查在运行程序前添加export QT_DEBUG_PLUGINS1环境变量这会让Qt打印详细的插件加载过程信息从中可以精准定位是哪个环节出了问题如找不到库、库版本冲突、依赖不满足等。整个移植过程本质上是一个“在主机上为目标板定制软件环境”的系统性工程。耐心、细致的排查和基于原理的理解是解决问题的关键。当你第一个“Hello Qt”程序在板子的屏幕上亮起时那种成就感就是对所有努力最好的回报。
嵌入式Qt移植实战：从交叉编译到i.MX6ULL开发板部署全记录
发布时间：2026/5/20 15:08:52
1. 项目概述最近在折腾一块基于i.MX6ULL的嵌入式开发板想把一个用Qt写的图形界面程序跑上去。这听起来像是嵌入式开发的“标准操作”但真动起手来从交叉编译环境搭建、Qt库的裁剪编译到最终在资源受限的板子上把程序跑起来每一步都可能藏着坑。网上教程不少但要么环境对不上要么步骤跳得太快缺了关键细节。我把自己从零开始成功在ARM Linux开发板上搭建Qt 5运行环境并测试程序的全过程梳理了一遍重点不是罗列命令而是解释清楚每个步骤背后的“为什么”以及我踩过的那些坑。如果你也在为嵌入式Qt移植头疼希望这篇记录能帮你少走弯路。1.1 核心需求与方案选型我们的目标很明确在一个运行Linux的ARM开发板以NXP i.MX6ULL为例上运行我们自己编写的Qt应用程序。开发主机是x86_64架构的Ubuntu系统。这注定是一个交叉编译的过程。为什么选择Qt在嵌入式领域Qt因其跨平台特性、丰富的控件库、成熟的工具链Qt Creator以及对触摸屏的良好支持成为开发复杂图形界面应用的首选之一。但Qt本身比较庞大直接使用桌面版的库是不现实的必须针对目标板的架构ARM、图形后端如LinuxFB以及可能用到的输入设备如tslib触摸屏进行定制化编译。整个方案的核心链路是在Ubuntu主机上使用ARM交叉编译工具链编译出适用于开发板的tslib触摸屏库和Qt库然后将编译好的库文件、插件及可执行程序打包移植到开发板的文件系统中并配置好相应的环境变量。这里有几个关键决策点交叉编译工具链必须与开发板内核、C库版本匹配。我使用的是开发板厂商提供的arm-linux-gnueabihf-gcc工具链它针对ARM硬浮点架构进行了优化能提升图形运算性能。Qt版本选择并非越新越好。Qt 5.15 LTS是长期支持版本理论上更稳定但我在编译其最新子版本时遇到了棘手的编译错误。经过权衡我退而求其次选择了Qt 5.12.9这是一个经过大量项目验证的稳定版本编译过程更顺畅。在嵌入式开发中稳定性往往优先于新特性。图形后端开发板通常没有GPU和标准的X Window桌面环境因此我们需要使用linuxfbLinux帧缓冲后端。它直接向/dev/fb0这类帧缓冲设备绘制图形开销小适合嵌入式环境。输入设备电阻式触摸屏需要tslib来进行校准和去抖处理。Qt可以通过tslib插件来读取触摸事件。2. 基础环境与依赖库准备在开始编译Qt这座“大厦”之前必须先把地基打牢。这个地基就是交叉编译工具链和必要的依赖库首当其冲的就是tslib。2.1 交叉编译工具链确认首先确保你的主机上已经安装并配置好了正确的交叉编译工具链。可以通过以下命令验证arm-linux-gnueabihf-gcc --version如果命令未找到你需要根据开发板厂商的指引安装对应的工具链并将其路径添加到系统的PATH环境变量中。这一步是后续所有编译工作的前提工具链不对编译出来的二进制文件根本无法在板子上运行。2.2 tslib的编译与详解tslib是一个用于触摸屏校准、滤波的库Qt的linuxfb平台通过插件与之对接。编译它相对简单但有几个配置项至关重要。2.2.1 获取与解压源码建议从GitHub的release页面下载稳定版本比如tslib-1.21.tar.bz2。将其拷贝到Ubuntu工作目录并解压。tar xvf tslib-1.21.tar.bz2 cd tslib-1.212.2.2 安装编译依赖tslib的编译系统基于autotools需要一些基础工具sudo apt-get install autoconf automake libtool这些工具用于生成最终的configure脚本。2.2.3 配置与编译这是最关键的一步。我们需要在一个独立的目录例如/home/work/arm-tslib中存放编译结果避免污染源码目录。# 创建一个用于存放编译输出的目录 mkdir -p /home/work/arm-tslib # 在源码目录中执行配置 ./configure --hostarm-linux-gnueabihf \ ac_cv_func_malloc_0_nonnullyes \ --cache-filearm-linux.cache \ --prefix/home/work/arm-tslib参数解析--hostarm-linux-gnueabihf指定编译出来的程序运行在ARM架构的Linux系统上这是交叉编译的核心标志。ac_cv_func_malloc_0_nonnullyes这是一个针对交叉编译环境的缓存变量设置。有些工具链的malloc(0)函数可能返回NULL而tslib的配置检测可能会因此失败。强制指定它为yes可以绕过这个检测。--cache-file指定缓存文件加速后续的配置过程。--prefix指定make install时的安装路径。所有编译生成的头文件、库文件都会放到这个目录下。配置成功后执行编译和安装make -j4 # 使用4个线程并行编译加快速度 make install执行完make install后查看/home/work/arm-tslib目录你会看到bin,include,lib,etc等子目录里面就是我们需要移植到开发板上的全部文件。2.2.4 打包与移植准备为了方便移植我们将整个目录打包cd /home/work tar -jcf arm-tslib.tar.bz2 arm-tslib/生成的arm-tslib.tar.bz2文件就是我们需要复制到开发板上的“tslib运行时环境”。注意事项一关于ac_cv_func_malloc_0_nonnull这个参数是编译tslib时最容易卡住的地方。如果编译时出现关于malloc的检查错误显式设置这个缓存变量几乎能解决90%的问题。它的本质是告诉配置系统“别检查了就假设malloc(0)返回非空指针”。3. Qt源码的交叉编译实战Qt源码的交叉编译是整个过程中最耗时、也最容易出错的环节。我们需要根据目标板的特性对庞大的Qt源码进行裁剪和配置。3.1 源码获取与解压从Qt官方归档站点下载所需的源码包例如qt-everywhere-src-5.12.9.tar.xz。使用5.12.9是因为其稳定性经过验证与我使用的工具链兼容性好。tar -xvf qt-everywhere-src-5.12.9.tar.xz cd qt-everywhere-src-5.12.93.2 关键配置qmake.conf文件修改Qt的编译系统qmake需要知道如何为你的目标平台调用编译器。这个信息存储在mkspecs目录下的配置文件中。对于ARM Linux我们需要修改qtbase/mkspecs/linux-arm-gnueabi-g/qmake.conf。为什么是linux-arm-gnueabi-g目录这个目录名对应-xplatform参数。我们后续配置会指定-xplatform linux-arm-gnueabi-gqmake就会来这里找编译规则。打开该文件将其内容修改为# qmake configuration for building with arm-linux-gnueabihf-g MAKEFILE_GENERATOR UNIX CONFIG incremental QMAKE_INCREMENTAL_STYLE sublib include(../common/linux.conf) include(../common/gcc-base-unix.conf) include(../common/g-unix.conf) # modifications to g.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 # modifications to linux.conf QMAKE_AR arm-linux-gnueabihf-ar cqs QMAKE_OBJCOPY arm-linux-gnueabihf-objcopy QMAKE_NM arm-linux-gnueabihf-nm -P QMAKE_STRIP arm-linux-gnueabihf-strip load(qt_config)关键修改点将所有arm-linux-gnueabi-*替换成你自己的工具链前缀arm-linux-gnueabihf-*。这个文件定义了编译、链接、归档等所有环节使用的具体命令必须与你的工具链完全一致。3.3 编写自动化配置脚本Qt的configure脚本选项繁多手动输入既容易出错也不利于复用。最佳实践是编写一个shell脚本。我创建了一个autoconfigure.sh文件内容如下#!/bin/bash ./configure -prefix /home/work/arm-qt \ -opensource \ -confirm-license \ -release \ -strip \ -shared \ -xplatform linux-arm-gnueabi-g \ -optimized-qmake \ -cstd c11 \ -rpath no \ -pch \ -skip qt3d \ -skip qtactiveqt \ -skip qtandroidextras \ -skip qtcanvas3d \ -skip qtconnectivity \ -skip qtdatavis3d \ -skip qtdoc \ -skip qtgamepad \ -skip qtlocation \ -skip qtmacextras \ -skip qtnetworkauth \ -skip qtpurchasing \ -skip qtremoteobjects \ -skip qtscript \ -skip qtscxml \ -skip qtsensors \ -skip qtspeech \ -skip qtsvg \ -skip qttools \ -skip qttranslations \ -skip qtwayland \ -skip qtwebengine \ -skip qtwebview \ -skip qtwinextras \ -skip qtx11extras \ -skip qtxmlpatterns \ -make libs \ -make examples \ -nomake tools \ -nomake tests \ -gui \ -widgets \ -dbus-runtime \ -glib no \ -iconv no \ -pcre qt \ -zlib qt \ -openssl no \ -freetype qt \ -harfbuzz qt \ -no-opengl \ -linuxfb \ -xcb no \ -tslib \ -libpng qt \ -libjpeg qt \ -sqlite qt \ -plugin-sql-sqlite \ -I/home/work/arm-tslib/include \ -L/home/work/arm-tslib/lib \ -recheck-all核心配置项深度解析路径相关 (-prefix,-I,-L)-prefix /home/work/arm-qt指定Qt的安装目录编译好的库和头文件将放在这里。-I和-L分别指定tslib的头文件和库文件搜索路径。这里必须指向你之前编译好的arm-tslib目录这样Qt编译时才能找到tslib并链接。基础属性-opensource -confirm-license使用开源版本并自动确认许可。-release -strip编译发布版本并剥离调试符号减少最终库文件大小。-shared编译动态链接库。嵌入式环境也推荐使用动态库便于多个应用共享节省存储空间。-xplatform linux-arm-gnueabi-g指定目标平台规范对应我们修改过的qmake.conf文件。模块裁剪 (-skip)这是减小Qt体积的关键我跳过了大量在嵌入式GUI应用中用不到的模块例如3D、蓝牙、Web引擎、文档等。裁剪原则是只保留你应用确实需要的模块。例如如果你的应用不需要数据库功能-sqlite qt和-plugin-sql-sqlite也可以去掉。图形与输入后端-linuxfb -xcb no指定使用Linux帧缓冲作为图形后端禁用XCBX11。-tslib启用tslib支持这是触摸屏能用的关键。-no-opengli.MX6ULL没有GPU因此禁用OpenGL。第三方库-freetype qt,-zlib qt,-libpng qt等使用Qt自带的bundled第三方库版本避免再去交叉编译这些依赖简化流程。-openssl no如果应用不需要网络加密通信可以禁用进一步简化。注意事项二磁盘空间与编译时间编译Qt需要大量的磁盘空间至少20GB剩余空间和较长的编译时间在4核虚拟机上可能需1-2小时。务必在开始前检查磁盘空间并使用make -j$(nproc)充分利用所有CPU核心加速编译。3.4 执行编译与安装给脚本加上执行权限并运行chmod x autoconfigure.sh ./autoconfigure.sh配置过程会持续几分钟检查各项依赖。成功后执行编译和安装make -j$(nproc) # 使用所有可用核心编译 make install编译完成后/home/work/arm-qt目录下就包含了完整的、针对ARM架构的Qt运行环境。同样我们将其打包以备移植cd /home/work tar -jcf arm-qt.tar.bz2 arm-qt/3.5 编译问题排查实录问题1编译过程中虚拟机磁盘空间不足现象make编译到中途报错提示“No space left on device”。排查使用df -h命令确认根分区已满。解决给虚拟机扩容。对于VirtualBox可以使用VBoxManage命令修改虚拟硬盘大小然后在Ubuntu内使用gparted工具扩展分区。务必在编译前确保有充足空间。问题2编译Qt 5.15.2时遇到诡异错误现象使用较新的Qt 5.15.2源码编译时在某个模块如QtCore出现复杂的模板编译错误。排查搜索错误信息发现可能与特定版本的GCC工具链或C标准库的兼容性有关。尝试调整-cstd参数或升级工具链均未解决。解决策略性降级。嵌入式开发中追求最新版本往往带来不必要的麻烦。我果断切换回经过广泛验证的Qt 5.12.9配置脚本几乎不用修改编译一次通过。这是嵌入式开发中一个重要的实用原则在稳定性和新特性之间优先选择稳定性。4. 开发板环境部署与配置编译好的库只是“武器”我们需要把“武器”部署到“战场”开发板上并告诉系统怎么使用它们。4.1 文件系统移植假设开发板通过NFS挂载了主机的根文件系统或者你可以通过scp等方式传输文件。我们将两个压缩包复制到开发板的/usr/lib目录下此目录通常用于存放第三方库并解压。# 在开发板上操作假设压缩包已在当前目录 cp arm-tslib.tar.bz2 /usr/lib/ cp arm-qt.tar.bz2 /usr/lib/ cd /usr/lib tar xf arm-tslib.tar.bz2 tar xf arm-qt.tar.bz2 rm arm-tslib.tar.bz2 arm-qt.tar.bz2 # 解压后删除压缩包节省空间解压后/usr/lib目录下会多出arm-tslib和arm-qt两个文件夹。4.2 环境变量配置——灵魂所在环境变量是连接应用程序、Qt库、tslib库和系统设备的桥梁。我们需要编辑开发板上的/etc/profile文件或创建/etc/profile.d/myqt.sh添加以下内容# tslib 环境变量 export TSLIB_ROOT/usr/lib/arm-tslib export TSLIB_CONSOLEDEVICEnone # 控制台设备设为none export TSLIB_FBDEVICE/dev/fb0 # 帧缓冲设备通常是fb0 export TSLIB_TSDEVICE/dev/input/event1 # 触摸屏设备节点需根据实际情况调整 export TSLIB_CONFFILE$TSLIB_ROOT/etc/ts.conf export TSLIB_PLUGINDIR$TSLIB_ROOT/lib/ts export TSLIB_CALIBFILE/etc/pointercal # 触摸校准文件存放位置 export LD_PRELOAD$TSLIB_ROOT/lib/libts.so # 预加载tslib库 # Qt 环境变量 export QT_ROOT/usr/lib/arm-qt export QT_QPA_GENERIC_PLUGINStslib:/dev/input/event1 # 指定输入插件为tslib export QT_QPA_FONTDIR/usr/share/fonts # 字体目录 export QT_QPA_PLATFORM_PLUGIN_PATH$QT_ROOT/plugins # Qt平台插件路径 export QT_QPA_PLATFORMlinuxfb:tty/dev/fb0 # 指定平台为linuxfb使用fb0 export QT_PLUGIN_PATH$QT_ROOT/plugins # 通用插件路径 export LD_LIBRARY_PATH$QT_ROOT/lib:$QT_ROOT/plugins/platforms:$LD_LIBRARY_PATH export QML2_IMPORT_PATH$QT_ROOT/qml # QML模块路径 export QT_QPA_FB_TSLIB1 # 启用linuxfb对tslib的支持关键变量解析与避坑指南TSLIB_TSDEVICE这是第一个大坑。/dev/input/event1不一定是你的触摸屏设备。你需要通过cat /proc/bus/input/devices命令来查看你的触摸屏对应哪个event节点。可能是event0,event2等等。设置错误会导致触摸无反应。QT_QPA_PLATFORM指定图形平台为linuxfb参数tty/dev/fb0告诉Qt使用哪个帧缓冲设备。如果你的系统有多个显示设备可能需要调整。LD_LIBRARY_PATH这是第二个大坑。它告诉系统动态链接器去哪里寻找Qt的共享库。必须包含$QT_ROOT/lib和$QT_ROOT/plugins/platforms。后者尤其重要因为libqlinuxfb.so等平台插件就放在这里找不到插件会导致程序启动失败并报错“Could not find the Qt platform plugin”。QT_QPA_GENERIC_PLUGINS告诉Qt使用tslib作为输入插件并指定设备节点。LD_PRELOAD强制系统在启动任何程序前先加载tslib的库确保触摸事件能被正确拦截和处理。配置完成后执行source /etc/profile让环境变量立即生效或者直接重启开发板。注意事项三环境变量调试如果程序启动失败首先通过echo $LD_LIBRARY_PATH等命令检查环境变量是否设置正确。一个快速测试方法是ls $QT_ROOT/plugins/platforms看是否能列出libqlinuxfb.so等文件。如果找不到说明QT_ROOT路径设置错了。5. Qt程序运行测试与深度排查环境配置好后不要急于运行自己的复杂应用先用Qt自带的例子进行测试它们是最简单的“试金石”。5.1 运行内置示例程序进入Qt编译输出的examples目录找一个简单的例子比如widgets/animation/animatedtilescd /usr/lib/arm-qt/examples/widgets/animation/animatedtiles ./animatedtiles -platform linuxfb这里显式指定了-platform linuxfb参数以确保程序使用我们配置的FB后端。成功现象屏幕上应该会出现一个动画的瓷砖效果窗口。如果你连接了触摸屏尝试点击它应该能看到交互反馈。5.2 交叉编译自己的Qt程序在Ubuntu开发机上使用我们刚编译好的Qt套件来编译你的应用程序。配置Qt Creator在Qt Creator的“工具”-“选项”-“Kits”中添加一个新的“设备”Device类型为“通用Linux设备”配置好开发板的IP和登录信息。然后添加一个新的“编译套件”Kit编译器选择你的arm-linux-gnueabihf-gcc和g。调试器选择对应的arm-linux-gnueabihf-gdb如果不需要调试可暂不设置。Qt版本点击“管理”添加/home/work/arm-qt/bin/qmakeQt Creator会自动识别出这个Qt版本。将新添加的Qt版本和编译器分配给这个Kit并选择刚才创建的设备作为部署设备。编译与部署用这个新建的Kit打开你的Qt项目选择“Release”模式进行构建。构建成功后在“项目”设置中配置部署路径如/home/root然后将可执行文件以及它可能依赖的特定资源文件如图片、qml文件部署到开发板。在开发板上运行通过串口或SSH登录开发板进入程序所在目录运行./YourApp -platform linuxfb5.3 常见问题与排查技巧实录即使按照步骤操作也可能会遇到问题。下面是我遇到过的典型问题及解决方法问题1程序启动时报错 “Could not find the Qt platform plugin “linuxfb” in ”原因QT_QPA_PLATFORM_PLUGIN_PATH环境变量设置错误或者LD_LIBRARY_PATH没有包含平台插件目录导致系统找不到libqlinuxfb.so。排查echo $QT_QPA_PLATFORM_PLUGIN_PATH确认路径是/usr/lib/arm-qt/plugins。ls $QT_QPA_PLATFORM_PLUGIN_PATH/platforms确认libqlinuxfb.so文件存在。echo $LD_LIBRARY_PATH确认其中包含了$QT_ROOT/plugins/platforms。解决仔细检查/etc/profile中的路径设置确保QT_ROOT变量正确并且LD_LIBRARY_PATH包含了必要的路径。然后执行source /etc/profile。问题2程序启动后黑屏或者屏幕闪烁后退出原因A帧缓冲设备/dev/fb0权限不足或者被其他进程占用。排查与解决检查/dev/fb0的权限ls -l /dev/fb0确保当前用户有读写权限通常需要root。使用fuser /dev/fb0查看是否有其他进程占用。原因BQt程序链接了错误的库或者库版本不匹配。排查与解决在开发板上使用ldd ./YourApp命令检查程序的动态库依赖。确保所有Qt相关的库如libQt5Core.so.5,libQt5Gui.so.5,libQt5Widgets.so.5都指向/usr/lib/arm-qt/lib下的版本而不是系统自带的x86版本。如果指向错误检查LD_LIBRARY_PATH。问题3触摸屏点击位置不准或无反应原因ATSLIB_TSDEVICE环境变量设置错误指向了错误的event节点。排查使用ts_test工具在arm-tslib/bin目录下进行测试。先export好所有tslib环境变量然后运行ts_test。如果工具本身就没反应基本就是设备节点错了。解决重新确认触摸屏设备节点。原因B触摸屏未校准。解决运行ts_calibrate进行五点校准。校准数据会保存到TSLIB_CALIBFILE指定的文件默认为/etc/pointercal中。每次系统启动后如果触摸不准都需要重新校准。可以考虑将校准命令加入开机脚本。原因CQt环境变量QT_QPA_GENERIC_PLUGINS未设置或设置错误。解决确保其值为tslib:/dev/input/eventXX是你的正确事件号。问题4中文字体不显示原因QT_QPA_FONTDIR指向的目录没有中文字体或者Qt编译时未包含字体库支持但我们配置中已包含-freetype qt。解决将中文字体文件如.ttf格式的文泉驿、思源字体拷贝到开发板的/usr/share/fonts目录下。可以在Ubuntu系统的/usr/share/fonts/truetype目录下找一些字体文件。问题5运行程序时报 “Fatal: This application failed to start because no Qt platform plugin could be initialized.”原因这是一个综合错误可能由上述多个问题共同导致但根本原因是平台插件初始化失败。排查在运行程序前添加export QT_DEBUG_PLUGINS1环境变量这会让Qt打印详细的插件加载过程信息从中可以精准定位是哪个环节出了问题如找不到库、库版本冲突、依赖不满足等。整个移植过程本质上是一个“在主机上为目标板定制软件环境”的系统性工程。耐心、细致的排查和基于原理的理解是解决问题的关键。当你第一个“Hello Qt”程序在板子的屏幕上亮起时那种成就感就是对所有努力最好的回报。
相关文章
2026年B站下载工具终极选择：BiliTools跨平台工具箱完全指南
2026年B站下载工具终极选择：BiliTools跨平台工具箱完全指南 【免费下载链接】BiliTools A cross-platform bilibili toolbox. 跨平台哔哩哔哩工具箱，支持下载视频、番剧等等各类资源 项目地址: https://gitcode.com/GitHub_Trending/bilit/BiliTools …
RDMA之路由算法介绍 （6）
1、自适应路由算法和非自适应路由算法之间的区别 自适应路由算法非自适应路由算法自适应算法涉及用于交换和更新路由器表数据的路由器。非自适应算法涉及网络管理员手动将路由路径输入路由器。该算法根据网络条件创建路由表。而此算法创建一个静态表，以确定何时发送…
如何高效管理Windows文件夹：色彩编码的完整指南
如何高效管理Windows文件夹：色彩编码的完整指南 【免费下载链接】Folcolor Windows explorer folder coloring utility 项目地址: https://gitcode.com/gh_mirrors/fo/Folcolor 你是否曾在数百个黄色文件夹中迷失方向？每天花费宝贵时间寻找特定文…
UrsPahoMqttClient 心跳问题解决指南——Paho 底层已自动处理，设好 KeepAlive 就行
UrsPahoMqttClient 心跳问题解决指南 ——Paho 底层已自动处理，设好 KeepAlive 就行 问题 用 UrsPahoMqttClient 做 MQTT 连接时，心跳 PingReq 报文怎么发送？目的是保持连接，防止被 Broker 踢下线。 结论 不需要手动发心跳&#x…
基于ARM9工业平板与Linux的水质在线监测系统开发实践
1. 项目概述：当工业平板电脑遇上水质监测在环保、水产养殖、市政水务这些领域里，数据就是眼睛。过去，我们看水质，得靠人拿着采样瓶，一趟趟跑现场，再送回实验室，等上半天甚至几天才能拿到一份报告…
猫抓浏览器扩展：5个步骤掌握终极网页资源嗅探工具
猫抓浏览器扩展：5个步骤掌握终极网页资源嗅探工具 【免费下载链接】cat-catch 猫抓 浏览器资源嗅探扩展 / cat-catch Browser Resource Sniffing Extension 项目地址: https://gitcode.com/GitHub_Trending/ca/cat-catch 猫抓（cat-catchÿ…
保姆级教程：用Ollama在Mac上跑通Llama2，顺便聊聊怎么自定义你的专属AI助手
从零打造你的Mac专属AI助手：Ollama与Llama2实战指南 引言：为什么选择本地运行大语言模型？ 最近两年，大语言模型（LLM）的普及让AI助手变得触手可及。但大多数用户仍然依赖云端服务，这带来了隐私顾…
基于RK3568与FPGA的16通道高速AD采集系统设计与实现
1. 项目概述：国产化浪潮下的实时数据采集新选择最近在做一个工业数据采集的项目，客户对国产化、实时性和通道数都有硬性要求。传统的方案要么用X86工控机加PCIe采集卡，成本高、功耗大，要么用一些ARM核心板，但多通道同步…
FL Studio自带的Edison插件，才是隐藏的降噪神器！手把手教你清除录音底噪（含参数设置避坑指南）
FL Studio隐藏神器Edison：专业级降噪全流程实战指南 在家庭录音棚里，空调的嗡嗡声、电脑风扇的呼啸、电路底噪的嘶嘶声——这些不受欢迎的"伴奏"总是如影随形。当你在FL Studio中回放刚录制的人声或乐器时，这些背景噪音往往会毁掉整…
顶伯在线语音工具背后的技术力量：AI语音合成与深度学习解析
顶伯在线语音工具背后的技术力量在人工智能浪潮中，语音交互正成为人机沟通的核心方式。顶伯作为行业领先的在线语音工具，凭借自主研发的深度学习架构，将文字转化为高度自然的语音，广泛应用于有声阅读、智能客服、教育辅助等领域。…
全志V3s开发板实战：用Buildroot 2020.02.4定制你的第一个最小Linux文件系统
全志V3s开发板实战：用Buildroot 2020.02.4定制最小Linux文件系统 在嵌入式开发领域，构建一个精简高效的Linux文件系统往往是项目成功的关键第一步。全志V3s作为一款高性价比的ARM Cortex-A7芯片，搭配Buildroot这一经典构建工具，能…
百考通：AI赋能期刊论文写作，智能生成优质内容
在学术研究领域，期刊论文的撰写是成果输出的关键环节，却也让众多科研工作者与学生倍感压力：选题迷茫、逻辑梳理困难、格式规范复杂、内容提炼耗时，严重拖慢了学术成果的发表节奏。百考通（https://www.baikaotongai.com…
【实用小程序】超轻量级文件上传下载中心 (File Download Server)
站内源码及jar包下载 一、项目概述 文件下载中心一个基于 Java 内置 HTTP 服务器（com.sun.net.httpserver）构建的轻量级文件管理服务。它零第三方依赖，单 JAR 包即可运行，适合在内网环境或临时场景中快速搭建文件共享站点。 你的团队需要临时共享一批日志文件或交付物，…
py每日spider案例之某website之xin东方选课搜索接口(难度一般 扣取代码即可)
加密位置: 逆向接口参数: 逆向接口: const g = globalThis; g.window = g; g.self = g; g.location = {<
终极轻量级Android文本编辑器Markor：多格式笔记应用完全指南
终极轻量级Android文本编辑器Markor：多格式笔记应用完全指南 【免费下载链接】markor Text editor - Notes & ToDo (for Android) - Markdown, todo.txt, plaintext, math, .. 项目地址: https://gitcode.com/gh_mirrors/ma/markor 在移动设备上寻找一款…
MPC-BE：基于DirectShow架构的专业级开源媒体播放解决方案
MPC-BE：基于DirectShow架构的专业级开源媒体播放解决方案 【免费下载链接】MPC-BE MPC-BE – универсальный проигрыватель аудио и видеофайлов для операционной системы Windows. 项目地址:…
如何快速计算3D模型体积和重量：STL-Volume-Model-Calculator终极指南
如何快速计算3D模型体积和重量：STL-Volume-Model-Calculator终极指南 【免费下载链接】STL-Volume-Model-Calculator STL Volume Model Calculator Python 项目地址: https://gitcode.com/gh_mirrors/st/STL-Volume-Model-Calculator 你是否曾经为3D打印项目…
通过Taotoken CLI工具一键配置团队开发环境与模型密钥
通过Taotoken CLI工具一键配置团队开发环境与模型密钥 1. CLI工具安装与基本使用 Taotoken提供的CLI工具可通过npm全局安装或直接使用npx运行。对于需要频繁使用CLI的团队，推荐全局安装： npm install -g taotoken/taotoken对于临时使用或项目级配置&a…