How to Build, Install and Setting Qt Application/zh

English

1 Qt版本介绍

Qt针对不同型号的开发板，提供了不同的Qt版本，Qt支持的特性也不同，请参照下面的表格：

CPU名称	Qt版本	显示驱动	OpenGL支持	QtWebEngine支持	电容屏	对应开发板
S5P4418	Qt 5.9.1	EGLFS	Yes	Yes	多点触摸	NanoPi S2/NanoPi M2A/NanoPi Fire2/NanoPC T2/Smart4418
S5P6818	Qt 5.9.1	EGLFS	Yes	Yes	多点触摸	NanoPi M3/NanoPi Fire3/NanoPC T3
Allwinner H3	Qt 4.8.6	LinuxFB	No	No	单点触摸	NanoPi-Duo/NanoPi-M1-Plus/NanoPi-M1/NanoPi-NEO-Air/NanoPi-NEO-Core/NanoPi-NEO
Allwinner H5	Qt 4.8.6	LinuxFB	No	No	单点触摸	NanoPi-M1-Plus2/NanoPi-NEO-Core2/NanoPi-NEO-Plus2/NanoPi-NEO2
Amlogic S905	Qt 5.9.1	LinuxFB	No	No	单点触摸	NanoPi-K2

2 安装Qt交叉编译环境

(注意：推荐的PC操作系统为 Ubuntu 16.04 64位系统)
根据你所用开发板的CPU型号，点击下表中的链接，下载链接内的所有文件到本地:

CPU名称	Qt版本	编译器与QtSDK
S5P4418	Qt 5.9.1	点击下载
S5P6818	Qt 5.9.1	点击下载
Allwinner H3	Qt 4.8.6	点击下载
Allwinner H5	Qt 4.8.6	点击下载
Amlogic S905	Qt 5.9.1	点击下载

然后执行以下命令安装即可：

chmod 755 ./install.sh
sudo ./install.sh

3 交叉编译你的Qt应用程序

下面以下载并编译一个 QtE-Demo 为例，分别说明在各个平台编译一个 Qt应用程序的步骤：

3.1 S5P4418平台的编译

git clone https://github.com/friendlyarm/QtE-Demo
mkdir build && cd build
/usr/local/Trolltech/Qt-5.9.1-nexell32-x86tools/bin/qmake ../QtE-Demo/QtE-Demo.pro
make

3.2 S5P6818平台的编译

git clone https://github.com/friendlyarm/QtE-Demo
mkdir build && cd build
//usr/local/Trolltech/Qt-5.9.1-nexell64-x86tools/bin/qmake ../QtE-Demo/QtE-Demo.pro
make

3.3 Allwinner H3平台的编译

export PATH=/opt/FriendlyARM/toolchain/4.9.3/bin/:$PATH
git clone https://github.com/friendlyarm/QtE-Demo
mkdir build && cd build
/usr/local/Trolltech/QtEmbedded-4.8.6-arm/bin/qmake ../QtE-Demo/QtE-Demo-Qt4.pro
make

3.4 Allwinner H5平台的编译

cd 
export PATH=/opt/FriendlyARM/toolchain/4.9.3/bin/:$PATH
git clone https://github.com/friendlyarm/QtE-Demo
mkdir build && cd build
/usr/local/Trolltech/QtEmbedded-4.8.6-arm/bin/qmake ../QtE-Demo/QtE-Demo-Qt4.pro
make

3.5 Amlogic S905平台的编译

export PATH=/opt/FriendlyARM/toolchain/6.4-aarch64/bin/:$PATH
git clone https://github.com/friendlyarm/QtE-Demo
mkdir build && cd build
/usr/local/Trolltech/QtEmbedded-5.9.1-arch64/bin/qmake ../QtE-Demo/QtE-Demo.pro
make

4 在开发板上运行Qt程序

运行Qt程序之前，需要先设置环境变量，在开发板上执行以下命令即可：

Qt5，使用 setqt5env:

. /usr/bin/setqt5env

Qt4，使用 setqt4env:

. /usr/bin/setqt4env

例如运行上一章节编译的QtE-Demo:

./QtE-Demo -qws

5 在开发板上编译Qt应用程序

下面以下载并编译一个 QtE-Demo 为例，分别说明在各个平台编译一个 Qt应用程序的步骤，此方式目前仅支持S5P4418和S5P6818平台：

5.1 S5P4418平台的编译并运行

git clone https://github.com/friendlyarm/QtE-Demo
mkdir build && cd build
/usr/local/Trolltech/Qt-5.9.1-nexell32-armhftools/bin/qmake ../QtE-Demo/QtE-Demo.pro
make
. setqt5env
./QtE-Demo

5.2 S5P6818平台的编译并运行

git clone https://github.com/friendlyarm/QtE-Demo
mkdir build && cd build
/usr/local/Trolltech/Qt-5.9.1-nexell64-aarch64tools/bin/qmake ../QtE-Demo/QtE-Demo.pro
make
. setqt5env
./QtE-Demo

6 开机自动运行Qt程序

以运行上一章节中的 QtE-Demo 程序为例，假设它放在 /root 目录，则你可以编辑 /etc/rc.local 文件，确否有以下内容：

. /usr/bin/setqt5env
/root/QtE-Demo -qws&

如果是 Qt4，请将setqt5env改为setqt4env。

7 屏幕旋转

根据你所用开发板的CPU型号，点击下表中的链接，下载链接内的所有文件到本地:

CPU名称	Qt版本	屏幕旋转方法
S5P4418	Qt 5.9.1	export ROTATION=-90 . setqt5env ./YourApp 可设置角度值为: 0, 90, 180, -90
S5P6818	Qt 5.9.1	export ROTATION=-90 . setqt5env ./YourApp 可设置角度值为: 0, 90, 180, -90
Allwinner H3	Qt 4.8.6	. setqt4env export QWS_DISPLAY='Transformed:Rot90' ./YourApp 可设置角度值为: 0, 90, 180, 270
Allwinner H5	Qt 4.8.6	. setqt4env export QWS_DISPLAY='Transformed:Rot90' ./YourApp 可设置角度值为: 0, 90, 180, 270
Amlogic S905	Qt 5.9.1	. setqt5env export QT_QPA_PLATFORM=linuxfb:fb=/dev/fb0:rotation=90 ./YourApp 可设置角度值为: 0, 90, 180, 270

8 常见问题

8.1 编译程序出现错误 ../QtE-Demo/main.cpp:18:21: fatal error: QtWidgets: No such file or directory

解决办法：检查一下qmake所生成的Makefile，正常情况Qt5的包含路径指向的是 sysroot 的地址即 rootfs-s5p4418或rootfs-s5p6818，你需要/opt目录下是否存在这个目录，不存在的话就重新安装一下sdk。

8.2 如何隐藏控制台光标？

关闭光标

sudo echo 0 > /sys/class/graphics/fbcon/cursor_blink

恢复光标

sudo echo 1 > /sys/class/graphics/fbcon/cursor_blink

8.3 如何隐藏和显示鼠标光标?

使用Qt5 EGLFS运行程序时，通过QT_QPA_EGLFS_HIDECURSOR环境变量来控制鼠标光标的显示与隐藏, 设置为1时会隐藏光标，设置为0时会显示光标。

例如，在执行 setqt5env 脚本之后执行：

export QT_QPA_EGLFS_HIDECURSOR=0

即可显示光标。

8.4 如何延长开机logo的显示时间？

由于内核在启动时会将屏幕初始化为终端，从而导致开机logo图片在短暂显示后就被冲掉变成黑屏，这在量产时是不愿意看到的，
可通过重新配置并编译内核来解决这个问题：

Device Drivers --->
    Graphics support --->
        Console display dirver support --->
            < > Framebuffer Console support

禁用Framebuffer Console support 即可保持Logo的显示，直至Qt应用的运行。