嵌入式Linux Qt移植详细过程

嵌入式Linux下的Qt移植详细过程

开发说明

前段时间需要用开发板写一个下位机程序，是基于Linux系统，就想着用Qt来写，于是上网找教程看如何移植到开发板上。由于我不熟悉嵌入式Linux，加上网上的教程大多都有不少坑，移植过程搞了几天，实在难受，故记录下移植过程，作为记录，也为需要的人提供参考。

我用来编译qt的主机是Ubuntu18系统，用的是VM虚拟机。要移植的开发板的架构是Cortex-72A。

资源以及下载地址

1. tslib1.2.1源码(触摸屏需要用到tslib)

   tslib1.2.1

2. qt5.12.9源码

   qt-everywhere-src-5.15.2.tar.xz

3. 交叉编译器aarch64-linux-gnu-gcc/aarch64-linux-gnu-g++或者gcc-arm-linux-gnueabi

sudo apt-get install aarch64-linux-gnu-gcc

sudo apt-get install aarch64-linux-gnu-g++

sudo apt-get install gcc-arm-linux-gnueabi

sudo apt-get install g++-arm-linux-gnueabi

或者去官网ARM 直接下载你需要的交叉编译器。安装aarch64或者gnueabi任意一个编译器即可。

4. 配置工具

sudo apt-get install libtool autogen autoconf automake

编译tslib

1. 记住你用的是哪个交叉编译器进行编译的，下面编译Qt需要用到同样的交叉编译器。

2. 解压下载好的源码，进入根目录。

3. 进行configure

CC=/usr/bin/arm-linux-gnueabi-g++ ./configure --host=arm-linux-gnueabi --prefix=/home/tslib1.2.1

CC指定交叉编译器，host指定平台，prefix指定生成的库放在哪个目录，可以自定义。

4. make and make install

make

然后

make install

等待make install 结束就可以在/home/tslib1.2.1目录下看到生成tslib.

编译Qt

1. 解压qt5.12.9源码，进入根目录。

tar -vxf everywhere-src-5.12.9.tar.xz

cd everywhere-src-5.12.9

2. 修改qmake.conf

我用的交叉编译器是linux-arm-gnueabi-g++，所以进入qt源码目录下的/qtbase/mkspecs/linux-arm-gnueabi-g++/ 找到qmake.conf进行修改。

如果你用的是其它交叉编译器，那需要进入到对应编译器的目录修改

aarch64进入qtbase/mkspecs/linux-aarch64-gun-g++/

其它找对应目录即可。

qmake.conf添加以下三行:

QT_QPA_DEFAULT_PLATFORM = linuxfb
QMAKE_CFLAGS_RELEASE += -O2 -march=armv8-a
QMAKE_CXXFLAGS_RELEASE += -O2 -march=armv8-a

修改后:

AKEFILE_GENERATOR = UNIX
CONFIG += incremental
QMAKE_INCREMENTAL_STYLE = sublib

# 添加以下三行

QT_QPA_DEFAULT_PLATFORM = linuxfb
QMAKE_CFLAGS_RELEASE += -O2 -march=armv8-a
QMAKE_CXXFLAGS_RELEASE += -O2 -march=armv8-a

include(../common/linux.conf)
include(../common/gcc-base-unix.conf)
include(../common/g++-unix.conf)

# modifications to g++.conf

QMAKE_CC = arm-linux-gnuebai-gcc # 指定编译器
QMAKE_CXX = arm-linux-gnuebai-g++
QMAKE_LINK = arm-linux-gnuebai-g++
QMAKE_LINK_SHLIB = arm-linux-gnuebai-g++

# modifications to linux.conf

QMAKE_AR =arm-linux-gnuebai-ar cqs
QMAKE_OBJCOPY = arm-linux-gnuebai-objcopy
QMAKE_NM = arm-linux-gnuebai-nm -P
QMAKE_STRIP = arm-linux-gnuebai-strip
load(qt_config)

3. 编写配置文件

新建一个脚本文件myconfig.sh,写入以下内容。有几项需要根据自己情况修改

-prefix 指定生成文件的目录

-l/home/tslib1.2.1/include 修改成上面编译好的tslib对应路径

-L/home/tslib1.2.1/lib 修改成上面编译好的tslib对应路径

-xplatform 平台目标,交叉编译时的目标平台

configure参数的意思用法参考 Qt configure参数详解 .

./configure -prefix /home/forlinx/qt5.12.9
-opensource
-confirm-license
-release
-strip
-shared
-xplatform linux-arm-gnuabi-g++
-optimized-qmake
-c++std c++11
--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
-skip qtdeclarative
-make libs
-make examples
-nomake tools -nomake tests
-gui
-widgets
-dbus-runtime
--glib=no
--iconv=no
--pcre=qt
--zlib=qt
-no-openssl
--freetype=qt
--harfbuzz=qt
-no-opengl
-linuxfb
--xcb=no
-tslib
--libpng=qt
--libjpeg=qt
--sqlite=qt
-plugin-sql-sqlite
-I/home/tslib1.2.1/include
-L/home/tslib1.2.1/lib
-recheck-all

这里注意一下格式，如果你从windows复制脚本到虚拟机的linux下，那个换行格式可能导致configure的时候有错误. Windows下换行是\r\n 。linux下是\n。这个问题也搞了我挺久的。

4. 编译

在qt源码根目录下执行刚才编写好的脚本文件,并且make && make install.

编译的过程要挺久十几分钟到几个小时不等。

chmod 777 myconfig.sh

./myconfig.sh

make -j4

make install

如果上面的过程有问题，根据提示进行修改.

移植

1. 将生成好的tslib和qt5.12.9复制到开发板上。

2. 配置环境变量

修改/etc/profile文件,在末尾添加以下内容。

路径根据自己情况修改

TSLIB_ROOT tslib的路径

QT_ROOT qt 的路径

export TSLIB_ROOT=/root/qtres/tslib_result
export TSLIB_CONSOLEDEVICE=none
export TSLIB_FBDEVICE=/dev/fb0
export TSLIB_TSDEVICE=/dev/input/event0
export TSLIB_CONFFILE=$TSLIB_ROOT/etc/ts.conf
export TSLIB_PLUGINDIR=$TSLIB_ROOT/lib/ts
export TSLIB_CALIBFILE=/etc/pointercal

export QT_ROOT=/root/qtres/qt5.12.9
export QT_QPA_GENERIC_PLUGINS=tslib:/dev/input/event0
export QT_QPA_FONTDIR=/usr/share/fonts
export QT_QPA_PLATFORM_PLUGIN_PATH=$QT_ROOT/plugins
export QT_QPA_PLATFORM=linuxfb:tty=/dev/fb0
export QT_PLUGIN_PATH=$QT_ROOT/plugins
export LD_LIBRARY_PATH=$QT_ROOT/lib:$QT_ROOT/plugins/platforms:$TSLIB_ROOT/lib:$QT_ROOT/bin
export QML2_IMPORT_PATH=$QT_ROOT/qml
export QT_QPA_FB_TSLIB=1

使文件生效.

source /etc/profile

到此，qt5.12.9移植完成。

配置QCreator开发环境

1. 一般不直接在开发板上开发，而是在另外的系统上编写好程序，再放到开发板上运行。

2. 安装qcreator。Qt的IDE。

sudo apt-get install qtcreator

3. 用上面编译好的qt5.12.9和交叉编译器配置qcreator

配置qmake(在编译好的qt/bin/)

配置交叉编译器(配置我们之前安装的交叉编译器)

生成的程序移植到开发板上运行。

一些问题

这个Qt移植会出现各种各样的问题，有些问题卡了好久，Google上也没有找到好的解决，归根到底还是不懂原理，只是照着别人的步骤来，由于别人的系统和板子和你不同，问题自然很多。不过我不是搞嵌入式方面的，只是需要用到才去搞的，所以也不深究原理。如果是研究这方面的，一定要把原理搞清楚，就不至于移植个Qt都这么麻烦。

有问题多百度和Google。

星期五女孩