树莓派3B+ QT5.9.6交叉编译环境搭建指导

----2019.04.22更新（本人基于最新的2019版本树莓派镜像根据本博文安装QT5.9.8成功）

------------------------------------------------------分割线--------------------------------------------------------------------------------------

本人这边为树莓派3B+ 使用的QT源码和IDE版本均为QT5.9.6，镜像为2018-10-09-raspbian-stretch.img

1.将刚烧录好2018-10-09-raspbian-stretch.img镜像的SD卡插入到树莓派中，启动系统

2.(树莓派) 树莓派通过 sudo raspi-config 命令配置一些参数

• 修改用户密码 (1. change user password)
  树莓派默认账号是 username: pi, password: raspberry

• 修改启动项 (2. boot options -> B1 Desktop / CLI)，选择启动界面为控制台，而不是图形界面
  这里要说明的是，如果家里只有 WiFi 而没有以太网，建议这里先不设置，因为后面需要使用图形界面连接网络
  可以在后面运行 Qt 程序之前再设置

• 修改显存大小 (7. advanced options -> A3 Memory Split)，设置大小为 256M

修改结束后重新启动

3.(树莓派) 树莓派更新固件和驱动

sudo rpi-update

sudo reboot

4.(树莓派) 树莓派更新程序并安装必要的文件

1. 首先修改 /etc/apt/sources.list 文件 (注意要用管理员权限)， 去掉 deb-src所在这一行头部的 # 号，解开注释（注意：其他源不要修改，不要使用国内镜像源，不然下面2的操作会失败的）

2. 更新必要的库

          sudo apt-get update

          sudo apt-get build-dep qt4-x11

          sudo apt-get build-dep libqt5gui5

          sudo apt-get install libudev-dev libinput-dev libts-dev libxcb-xinerama0-dev libxcb-xinerama0

5.(树莓派) 在树莓派新建文件夹

    sudo mkdir /usr/local/qt5pi

    sudo chown pi:pi /usr/local/qt5pi

6.(主机) 在主机安装 gcc 交叉工具链

   注意: 这里没有采用树莓派 github 上提供的工具链，主要原因是那个工具链太老了，4.8 版本的 gcc。

   这里推荐 linaro 的 gcc 工具链，版本为 6.3，32 位和 64 位主机请选择各自对应的工具链，下载好后解压到 ~/raspi 文件夹中

    具体路径为：/home/galaxy/raspi/gcc-linaro-6.3.1-2017.05-x86_64_arm-linux-gnueabihf

7.(主机) 主机创建 sysroot ，这是 Qt5 之后官方推荐的一种编译方案，类似于在主机上提供编译 ARM 版本 Qt 所需要的库和头文件等环境，实现交叉编译

cd /home/galaxy/raspi

mkdir sysroot sysroot/usr sysroot/opt

rsync -avz [email protected]:/lib sysroot

rsync -avz [email protected]:/usr/include sysroot/usr

rsync -avz [email protected]:/usr/lib sysroot/usr

rsync -avz [email protected]:/opt/vc sysroot/opt

请注意:

• 下面的 raspberrypi.local 是 树莓派的 IP 地址，它必须和主机在同一个局域网下，可以直连，也可以通过路由器
• rsync 命令将远程的树莓派的文件同步到主机，这里可能耗时比较长，取决于网络质量。需要说明的是，有些博客会将整个 rootfs 的所有文件都同步到主机，即 rsync -avz [email protected]:/ sysroot，这样要传输的文件实在是太多了，不推荐这么做。
• 如果在传输时，出现 permission denied ，说明有些文件传输需要管理员权限，不用管它，一般这些文件不是很重要
• 如果出现 connection refused 错误，说明需要在树莓派上开启 ssh 服务，可以去 google 找一下怎么开启

8.(主机) 修复同步带来的路径问题

wget https://raw.githubusercontent.com/riscv/riscv-poky/priv-1.10/scripts/sysroot-relativelinks.py

chmod +x sysroot-relativelinks.py

./sysroot-relativelinks.py sysroot

这里下载链接已经失效了，我将我前面下载下来的脚本提供出来

https://download.csdn.net/download/zz531987464/11133746

直接下载下来按照上面的命令运行即可。

9.(主机) 主机上配置 Qt ，可以直接下载 Qt 源码或者去 Qt 的 Git 库下载对应版本的模块，我这里采用第一种方式
源码地址如下: https://www1.qt.io/offline-installers/ ，选择下载 Linux/macOS 对应的 tar.xz 文件 ，解压，命令行切换到 Qt 源码根目录，输入如下配置命令:

./configure -release -opengl es2 -device linux-rasp-pi3-g++  -device-option CROSS_COMPILE=~/raspi/gcc-linaro-6.3.1-2017.05-x86_64_arm-linux-gnueabihf/bin/arm-linux-gnueabihf- -sysroot ~/raspi/sysroot -opensource -confirm-license -make libs -prefix /usr/local/qt5pi -extprefix ~/raspi/qt5pi -hostprefix ~/raspi/qt5 -no-use-gold-linker -no-gbm -skip qtlocation -skip qtscript      -skip qtwebengine -v

1. 64 位主机采用 -device-option CROSS_COMPILE=~/raspi/tools/arm-bcm2708/gcc-linaro-arm-linux-gnueabihf-raspbian-x64/bin/arm-linux-gnueabihf- ，32 位主机采用 -device-option CROSS_COMPILE=~/raspi/tools/arm-bcm2708/gcc-linaro-arm-linux-gnueabihf-raspbian/bin/arm-linux-gnueabihf-
2. 对于 5.9.1 或更高版本的 Qt，添加 -no-use-gold-linker 选项，我上面已经加了
3. 这里有一个 Bug，所以需要加上 -no-gbm ，否则 Qt 编译会出错
4. 不编译 qtlocation 和 qtscript 模块，这两个模块编译时也会出错
5. 注意，如果不是树莓派3, 则选择对应的 device 选项: inux-rasp-pi-g++ for RPi, linux-rasp-pi2-g++ for RPi2 and linux-rasp-pi3-g++ for RPi3.
6. 上面的命令中，-extprefix ~/raspi/qt5pi 指定了 Qt 交叉编译库存放位置，-hostprefix ~/raspi/qt5 指定了Qt 编译的可执行工具存放的位置，比如 qmake

make -j4

make install

10.(主机) 部署 Qt 库到树莓派 ，同步 Qt 库到先前创建的文件夹

rsync -avz qt5pi [email protected]:/usr/local

11.(树莓派) 树莓派更新库依赖索引文件
注意: 由于最新版本的 raspbian 镜像已经自带 qt5 库文件了，所以为了避免混淆，我们设为 00-qt5pi.conf ，这样 qt 程序会首先依赖我们编译的库，而不是镜像自带的库

echo /usr/local/qt5pi/lib | sudo tee /etc/ld.so.conf.d/00-qt5pi.conf

sudo ldconfig

12.(树莓派) 修复 EGL 库 ，使用硬件 GPU ，而不是 mesa 实现的 OpenGL

在当前版本中，/opt/vc/lib/目录下的libEGL.so和libGLESv2.so变更为libbrcmEGL.so和libbrcmGLESv2.so

sudo mv /usr/lib/arm-linux-gnueabihf/libEGL.so.1.0.0 /usr/lib/arm-linux-gnueabihf/libEGL.so.1.0.0_backup

sudo mv /usr/lib/arm-linux-gnueabihf/libGLESv2.so.2.0.0 /usr/lib/arm-linux-gnueabihf/libGLESv2.so.2.0.0_backup

sudo ln -s /opt/vc/lib/libEGL.so /usr/lib/arm-linux-gnueabihf/libEGL.so.1.0.0

sudo ln -s /opt/vc/lib/libGLESv2.so /usr/lib/arm-linux-gnueabihf/libGLESv2.so.2.0.0

13.(树莓派) 添加遗失的 openGL 库的 软链接

(注意：在新版的树梅派镜像中，/opt/vc/lib/目录下的libEGL.so和libGLESv2.so变更为libbrcmEGL.so和libbrcmGLESv2.so，所以我们下面创建软链接的时候需要注意)

sudo ln -s /opt/vc/lib/libEGL.so /opt/vc/lib/libEGL.so.1 或 sudo ln -s /opt/vc/lib/libbrcmEGL.so /opt/vc/lib/libEGL.so.1

sudo ln -s /opt/vc/lib/libGLESv2.so /opt/vc/lib/libGLESv2.so.2 或 sudo ln -s /opt/vc/lib/libbrcmGLESv2.so /opt/vc/lib/libGLESv2.so.2

14.(主机) Qt例程测试 ，在主机交叉编译测试程序并传输到树莓派

cd qtbase/examples/opengl/qopenglwidget

~/raspi/qt5/bin/qmake

make

scp qopenglwidget [email protected]:/home/pi

15.(树莓派) 树莓派运行程序，完美

cd ~

chmod +x ./qopenglwidget

./qopenglwidget

可以看到当前qt bin程序运行成功

配置QT creator 本地编译环境

     0. 首先下载QT Creator IDE qt-opensource-linux-x64-5.9.8.run

1. Tools -> Build & Run -> Compilers
   手动添加编译器 C 和 C++ 各一个，如果是 64 位机器，还是使用 ~/raspi/gcc-linaro-6.3.1-2017.05-x86_64_arm-linux-gnueabihf/bin/arm-linux-gnueabihf-gcc
   32 位主机同理

2. Tools -> Build & Run -> Debugger 手动添加调试器gdb-multiarch，路径为主机上的路径/usr/bin/gdb-multiarch,没有这个软件的话直接在主机上sudo apt-get install gdb-multiarch安装即可，在Kit中的Debugger选择gdb-multiarch                       有调试需要的话，还需要在树莓派端安装/usr/bin/gdbserver，我们可以通过在主机上交叉编译 gdb-*.*.tar.xz源码包然后提取里面的gdbserver即可                                                                                                                                                             a). tar xvf gdb-8.1.tar.xz ,然后进入该源码目录下交叉编译                                                                                                       b). ./configure --host= arm-linux-gnueabihf                                                                                                                               c). make即可                                                                                                                                                                             d). 然后我们进入到gdb/gdbserver目录下，编译gdbserver，直接make，会在当前目录下生成gdbserver，然后我们拷贝该bin文件到树莓派的/usr/bin/目录下即可。

3. Tools -> Build & Run -> Qt Versions 手动添加我们前面编译好的 Qt 版本，我们需要指定的是 qmake 的路径，我这里的路径是 ~/raspi/qt5/bin/qmake

4. Tools -> Devices 手动添加 generic linux 设备，需要指定树莓派的 IP 地址，用户名和密码。在工程pro文件最后添加按安装到树莓派的路径 target.path = /home/pi
   INSTALLS += target

5. Tools -> Build & Run -> Kits 手动添加新的套件，需要指定设备，qt 版本以及编译器和调试器，这都是我们前面设置好了的

6. 从 Qt 例程里随便挑选一个，选择我们的 kits ，点击 “Run”，然后看到远程的树莓派直接运行程序了，并且可以添加断点实现调试功能

总结以下Qt Creator的配置有以下几点：

交叉编译工具gcc g++的配置

qmake需要指定

构建套件时需要指定上面的交叉编译工具和qmake,其他的调试等配置可以不设置，使用release编译出来后scp到板子上即可。

下面给出其他板子rk3288的设置截图，树梅派类似设置即可

QT无法输入中文的解决方法：

/usr/lib/x86_64-linux-gnu/qt5/plugins/platforminputcontexts目录下的libfcitxplatforminputcontextplugin.so拷贝到

/opt/Qt5.9.8/5.9.8/gcc_64/plugins/platforminputcontexts

/opt/Qt5.9.8/Tools/QtCreator/lib/Qt/plugins/platforminputcontexts

的两个目录下即可