嵌入式Linux Qt移植详细过程

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

开发说明

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

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

资源以及下载地址

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

tslib1.2.1

1. qt5.12.9源码

qt-everywhere-src-5.15.2.tar.xz

1. 交叉编译器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任意一个编译器即可。

1. 配置工具

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指定生成的库放在哪个目录，可以自定义。

1. 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

1. 修改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)

1. 编写配置文件

新建一个脚本文件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。这个问题也搞了我挺久的。

1. 编译

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

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

chmod 777 myconfig.sh

./myconfig.sh

make -j4

make install

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

移植

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


1. 配置环境变量

修改/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

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

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

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

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

一些问题

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

有问题多百度和Google。

星期五女孩