How to Build, Install and Setting Qt Application/zh

From FriendlyELEC WiKi
Revision as of 08:04, 3 May 2018 by Tzs (Talk | contribs)

Jump to: navigation, search

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应用的运行。