前言
一、Windows 下QT环境搭建
二、在 Builroot 下编译QT应用
- 1.Buildroot下构建QT工程
- 2.移植源码
- 3.编译工程
三、使用交叉编译工具链编译QT
- 1.准备工作
- 2.使用编译工具包进行交叉编译
- - 1.编译OpenSSL
  - 2.编译SQLite
  - 3.编译QT
  - 4.使用qmake编译 QT 应用
四、上机测试
- 1.将可执行文件复制到开发板上进行测试
- 2.配置环境变量
- 3.添加权限并执行程序
五、其他问题及解决方法
- 编译SDK时可能出现的问题：

前言

寒假有个在Rockchip RV1126上使用QT开发图形可视化的需求，接到板子之后一边学习QT一边尝试在开发板上部署 QT 应用，暑假的时候已经编译过 SDK （因为这个埋了个大坑），最后发现，如果编译正确的SDK没有问题的话，问题也确实解决一半了。
实现的方法有两种：1、直接在 Builroot 下编译QT应用、2、使用交叉编译工具链编译QT
实践证明两种方法都是可行的，如果只是单纯部署QT应用的话，建议用1，流程简单，如果要做QT应用开发的话，个人建议用2，流程虽然复杂，但是方便后面开发（折腾），各位看官视己情况选择，下面正式开始。

一、Windows 下QT环境搭建

如果你的电脑还没有安装QT Creator的话，请参考： Windows10下QT creator 安装教程
推荐一个QT学习课程：《Qt 5.9 C++开发指南》2021完整版

QT项目文件结构：

二、在 Builroot 下编译QT应用

参考官方文档：docs/Linux/ApplicationNote/Rockchip_Developer_Guide_Linux_Qt_CN.pdf
我的SDK下载地址：Firefly 资料下载

没有文档可以点击这里下载给我加点积分（狗头）；
开玩笑的啦，其实我最讨厌下载东西还要积分啥的（苦笑）百度云链接提取码：j6xo

我的SDK编译环境是搭建在 WSL （安装教程）下的（首次编译耗时…保守点两个星期，还涉及后面的交叉编译），这个环境搭建教程后续可能会出（大概是我换电脑的时候）：）

注意！！！一定要编译对应你们开发板的SDK，完整地编译，不然后面的后面甚至出现不报错但是没有文件生成的错误！我拿到过两个都是rv1109/rv1126的SDK的，但是里面的文件会有所不同，细节导致成败！

1.Buildroot下构建QT工程

在 Buildroot 中添加Qt工程，下面介绍添加进Buildroot的方法。
在 SDK/buildroot/package/rockchip/ 目录下，新建你的工程文件夹（QT Creator创建的项目名称，我的项目名称是TextEditor，下文提到的项目名称都是指这个），在文件夹中添加两个文件， Config.in 和项目
文件名.mk 。

Config.in文件内容如下：

config BR2_PACKAGE_TEXTEDITORbool "TextEditor"helpcgy qt demo

项目名称.mk的内容如下：

################################################################################
#
# TextEditor
#
################################################################################TEXTEDITOR_VERSION = 1.0
TEXTEDITOR_SITE = $(TOPDIR)/../app/TextEditor
TEXTEDITOR_SITE_METHOD = localTEXTEDITOR_LICENSE = Apache V2.0
TEXTEDITOR_LICENSE_FILES = NOTICE
define TEXTEDITOR_CONFIGURE_CMDS
cd $(@D); $(TARGET_MAKE_ENV) $(HOST_DIR)/bin/qmake
endef
define TEXTEDITOR_BUILD_CMDS
$(TARGET_MAKE_ENV) $(MAKE) -C $(@D)
endefdefine TEXTEDITOR_INSTALL_TARGET_CMDS
$(INSTALL) -D -m 0755 $(@D)/TextEditor $(TARGET_DIR)/usr/bin/TextEditor
endef
$(eval $(generic-package))

2.移植源码

在添加Buildroot后，你需要把你的工程资源文件夹添加到SDK中去编译，下面介绍添加源码的方法。
在SDK/app/目录下建立你的项目文件夹，在建立的项目文件夹中新建项目名.pro 文件，内容如下：

QT       += core guigreaterThan(QT_MAJOR_VERSION, 4): QT += widgetsCONFIG += c++11# The following define makes your compiler emit warnings if you use
# any Qt feature that has been marked deprecated (the exact warnings
# depend on your compiler). Please consult the documentation of the
# deprecated API in order to know how to port your code away from it.
DEFINES += QT_DEPRECATED_WARNINGS# You can also make your code fail to compile if it uses deprecated APIs.
# In order to do so, uncomment the following line.
# You can also select to disable deprecated APIs only up to a certain version of Qt.
#DEFINES += QT_DISABLE_DEPRECATED_BEFORE=0x060000    # disables all the APIs deprecated before Qt 6.0.0SOURCES += \main.cpp \mainwindow.cppHEADERS += \mainwindow.hFORMS += \mainwindow.ui# Default rules for deployment.
qnx: target.path = /tmp/$${TARGET}/bin
else: unix:!android: target.path = /opt/$${TARGET}/bin
!isEmpty(target.path): INSTALLS += targetRESOURCES += \res.qrcRC_ICONS += AppIcon.ico

然后将刚才介绍的QT资源文件（.h、.cpp、.ui、.qrc）都复制到这个目录下面，别遗漏了图片或者视频或其他资源文件夹

3.编译工程

make TextEditor-rebuild

可能出现错误：

rockchip rv1126 rv1109 facial gate/host/bin/qmake: No such file or directory

这里我编译的时候出现了找不到qmake的错误，将上文中的 Config.in 文件中$(HOST_DIR)/bin/qmake更改成SDK下的buildroot/output/firefly_rv1126_rv1109/host/bin/qamke，问题解决；
如果找不到这个文件，你可以选择：1. 去找到正确的SDK重新编译；2.跳到第三小节使用交叉工具链编译QT。

没有报错编译通过的话，会在SDK/buildroot/output/rockchip_rv1126_rv1109_facial_gate/target/usr/bin/目录下生成可执行文件（文件名是你项目的名称）。

三、使用交叉编译工具链编译QT

参考：Linux Qt5.9.X版本下的交叉编译(openssl + sqlite)

如果在不想折腾这个的话，可以直接跳到最后一步

1.准备工作

1、GCC编译官网下载：
Linaro Releases
GCC编译包：gcc-linaro-6.5.0-2018.12-x86_64_arm-linux-gnueabihf.tar.xz
备注：这个编译包看个人的开发环境而定，我这里以该编译工具包为例

这一步，其实在SDK的prebuilts/gcc/linux-x86/arm目录下有编译工具包，不过需要注意的是用linaro不是arm，很不幸我弄错了，希望你们别踩坑。
2.OpenSSL官网下载：
官方下载地址，OpenSSL以下面为例：
3.SQLite官网下载
官方下载地址，这里选择Source Code下的sqlite-autoconf-xxxxxxx.tar.gz(版本随意)
4.QT5官网下载
官方下载地址，以下图为例：

Tip: 在WSL下，可以在官网右键目标压缩包复制下载地址，可以直接下载到本地，例如QT：
wget https://download.qt.io/archive/qt/5.9/5.9.4/single/qt-everywhere-opensource-src-5.9.4.tar.xz

将下载的三个安装包分别解压：

tar -zxvf openssl-1.0.0.tar.gz
tar -zxvf sqlite-autoconf-3370200.tar.gz
tar -xvf qt-everywhere-opensource-src-5.9.4.tar.xz

Tip： 如果想要解压到指定目录，可以在命令行后面加上参数 -C 目标文件夹

准备工作 Complete，下面开始交叉编译。

2.使用编译工具包进行交叉编译

1.编译OpenSSL

在解压后的OpenSSL目录下执行以下命令，opennssl_build_path为安装路径，自行修改：

./Configure linux-armv4 no-asm shared --prefix=opennssl_build_path

修改OpenSSL目录下的Makefile文件，62行：
修改CC、AR、RANLIB、NM、MAKEDEPPROG参数，将其修改成上文中编译工具包的路径，如下图所示是我的路径，MAKEDEPPROG的路劲和CC的一样
：

OpenSSL目录下Makefile文件62行开始：

注意！！！这些路径一定要设置正确！不然编译QT步骤时，运行build.sh脚本时会出现错误。

最后执行命令进行编译：

make -j4
make install

可能出现的错误：

解决方法，将这个/usr/bin/pod2man删掉，再编译：

rm /usr/bin/pod2man

编译安装好，进去你所安装的目录下，执行以下命令检查是否交叉编译成功：

file ./lib/libcrypto.so.1.0.0

成功会打印出以下信息：

./lib/libcrypto.so.1.0.0: ELF 64-bit LSB shared object, x86-64, version 1 (SYSV), dynamically linked, BuildID[sha1]=4d397b8e162dd9553787aa0cf733e82f27d2db6a, not stripped

Tip： 建议编译安装路径设置成绝对路径，相对路径可能会出现路径错误的问题：）

2.编译SQLite

同上，在解压后的SQLite目录下执行以下命令，sqlite_build_path为安装路径，gcc_path为GCC编译器路径，自行修改：


./configure --prefix=sqlite_build_path --host=arm-linux-gnueabihf CC=gcc_path/arm-linux-gnueabihf-gcc

然后SQLite目录下执行以下命令：

make -j4
make install

成功后显示：

----------------------------------------------------------------------
Libraries have been installed in:/home/ethan/sqlite_build/libIf you ever happen to want to link against installed libraries
in a given directory, LIBDIR, you must either use libtool, and
specify the full pathname of the library, or use the '-LLIBDIR'
flag during linking and do at least one of the following:- add LIBDIR to the 'LD_LIBRARY_PATH' environment variableduring execution- add LIBDIR to the 'LD_RUN_PATH' environment variableduring linking- use the '-Wl,-rpath -Wl,LIBDIR' linker flag- have your system administrator add LIBDIR to '/etc/ld.so.conf'See any operating system documentation about shared libraries for
more information, such as the ld(1) and ld.so(8) manual pages.
----------------------------------------------------------------------/usr/bin/mkdir -p '/home/ethan/sqlite_build/bin'/bin/bash ./libtool   --mode=install /usr/bin/install -c sqlite3 '/home/ethan/sqlite_build/bin'
libtool: install: /usr/bin/install -c sqlite3 /home/ethan/sqlite_build/bin/sqlite3/usr/bin/mkdir -p '/home/ethan/sqlite_build/include'/usr/bin/install -c -m 644 sqlite3.h sqlite3ext.h '/home/ethan/sqlite_build/include'/usr/bin/mkdir -p '/home/ethan/sqlite_build/share/man/man1'/usr/bin/install -c -m 644 sqlite3.1 '/home/ethan/sqlite_build/share/man/man1'/usr/bin/mkdir -p '/home/ethan/sqlite_build/lib/pkgconfig'/usr/bin/install -c -m 644 sqlite3.pc '/home/ethan/sqlite_build/lib/pkgconfig'
make[1]: Leaving directory '/home/ethan/sqlite-autoconf-3370200'

3.编译QT

进入解压QT的目录下，新建build.sh文件，opennssl_build_path为OpenSSL安装路径，sqlite_build_path为SQLite安装路径，qt_build_path为将要安装的QT目录，自行修改内容如下：

#!/bin/sh
OPENSSL_LIBS='-Lopennssl_build_path/lib -lssl -lcrypto'
./configure -prefix qt_build_path \
-opensource \
-debug \
-confirm-license \
-xplatform linux-arm-gnueabi-g++ \
-pch \
-linuxfb \
-no-opengl \
-shared \
-no-iconv \
-no-xcb \
-sqlite \
-qt-zlib \
-openssl-linked -I opennssl_build_path/include -L opennssl_build_path/lib \
-recheck-all

然后移动到解压QT目录执行以下命令：

cd qtbase/mkspecs/linux-arm-gnueabi-g++

修改qmake.conf文件，内容如下，openssl_build_path为OpenSSL安装路径，sqlite_build_path为SQLite安装路径，compiler_path为编译器路径，自行修改：

#
# qmake configuration for building with arm-linux-gnueabi-g++
#MAKEFILE_GENERATOR      = UNIX
CONFIG                 += incremental
QMAKE_INCREMENTAL_STYLE = sublibinclude(../common/linux.conf)
include(../common/gcc-base-unix.conf)
include(../common/g++-unix.conf)QT_QPA_DEFAULT_PLATFORM=linuxfb
QMAKE_INCDIR += sqlite_build_path/include openssl_build_path/include
QMAKE_LIBDIR += sqlite_build_path/lib openssl_build_path/lib# modifications to g++.conf
#根据自己的GCC编译器路径来定
QMAKE_CC                = compiler_path/arm-linux-gnueabihf-gcc
QMAKE_CXX               = compiler_path/arm-linux-gnueabihf-g++
QMAKE_LINK              = compiler_path/arm-linux-gnueabihf-g++
QMAKE_LINK_SHLIB        = compiler_path/arm-linux-gnueabihf-g++# modifications to linux.conf
QMAKE_AR                = compiler_path/arm-linux-gnueabihf-ar cqs
QMAKE_OBJCOPY           = compiler_path/arm-linux-gnueabihf-objcopy
QMAKE_NM                = compiler_path/arm-linux-gnueabihf-nm -P
QMAKE_STRIP             = compiler_path/arm-linux-gnueabihf-strip
load(qt_config)

修改完成后，回到解压QT的目录，执行以下命令：

chmod +x build.sh
./builsh.sh

可能会出现的错误：

ERROR: Feature 'openssl-linked' was enabled, but the pre-condition '!features.securetransport && libs.openssl' failed.

解决方法：
出现这个错误说明你的OpenSSL没有安装成功，请回到OpenSSL安装步骤检查你的Makefile文件各个参数的路径有没有问题，不关版本的事情

脚本运行成功后，会打印出以下信息：

Note: Also available for Linux: linux-clang linux-iccNote: When linking against OpenSSL, you can override the default
library names through OPENSSL_LIBS.
For example:OPENSSL_LIBS='-L/opt/ssl/lib -lssl -lcrypto' ./configure -openssl-linkedNote: No wayland-egl support detected. Cross-toolkit compatibility disabled.Qt is now configured for building. Just run 'make'.
Once everything is built, you must run 'make install'.
Qt will be installed into '/home/ethan/qt_build'.Prior to reconfiguration, make sure you remove any leftovers from
the previous build.

看到以上信息证明运行成功，执行编译命令：

make -j4
make install

编译安装成后，控制台会打印以下结果：

make[2]: Leaving directory '/home/ethan/qt-everywhere-opensource-src-5.9.4/qttranslations/translations'
make[1]: Leaving directory '/home/ethan/qt-everywhere-opensource-src-5.9.4/qttranslations'
cd qtdoc/ && ( test -e Makefile || /home/ethan/qt-everywhere-opensource-src-5.9.4/qtbase/bin/qmake -o Makefile /home/ethan/qt-everywhere-opensource-src-5.9.4/qtdoc/qtdoc.pro ) && make -f Makefile install
make[1]: Entering directory '/home/ethan/qt-everywhere-opensource-src-5.9.4/qtdoc'
cd doc/ && ( test -e Makefile || /home/ethan/qt-everywhere-opensource-src-5.9.4/qtbase/bin/qmake -o Makefile /home/ethan/qt-everywhere-opensource-src-5.9.4/qtdoc/doc/doc.pro ) && make -f Makefile install
make[2]: Entering directory '/home/ethan/qt-everywhere-opensource-src-5.9.4/qtdoc/doc'
make[2]: Nothing to be done for 'install'.
make[2]: Leaving directory '/home/ethan/qt-everywhere-opensource-src-5.9.4/qtdoc/doc'
make[1]: Leaving directory '/home/ethan/qt-everywhere-opensource-src-5.9.4/qtdoc'

4.使用qmake编译 QT 应用

参考：WSL2环境下交叉编译QT工程，开发板成功运行（全过程详解）

1.将你的QT creator 创建的项目文件夹直接复制到WSL下面；
2.删除后缀为.pro.user文件（防止出错，我没删也没报错）；
3.在项目文件夹下面执行执行命令，qt_build_path为你刚才QT安装设置的路径：
```
qt_buid_path/qmake
```
4.上一步成功后会在该目录下生成Makefile文件，执行命令编译项目：
```
make
```

编译成功后会在该目录下生成可执行文件。

Tip： 在资源管理器地址栏中输入：\\wsl$ 可直接打开WSL系统文件夹

四、上机测试

1.将可执行文件复制到开发板上进行测试

怎么传输式各位看官觉得啥方便就用啥，小小白：ssh使用scp传输文件、adb传输文件、串口传输文件

2.配置环境变量

进入rv1126命令行，执行以下命令：

export QT_QPA_FB_DRM=1
export QT_QPA_PLATFORM=linuxfb:rotation=0

不设置可能会出现错误：

This application failed to start because it could not find or load the Qt platform plugin "eglfs"
in "".Available platform plugins are: linuxfb, minimal, offscreen, vnc.Reinstalling the application may fix this problem.
Aborted (core dumped)

3.添加权限并执行程序

chmod +x TextEditor
./TextEditor

实现效果图：
在 Builroot 下编译：

交叉编译工具编译QT后使用qmake编译：

大功告成！

五、其他问题及解决方法

编译SDK时可能出现的问题：

1.用户身份问题

you should not run configure as root (set FORCE_UNSAFE_CONFIGURE=1 in environment to bypass this

解决方法：

export FORCE_UNSAFE_CONFIGURE=1

参考：编译错误you should not run configure as root (set FORCE_UNSAFE_CONFIGURE=1 in environment to bypass this

rv1109/rv1126 编译并部署QT项目（详解）相关推荐

【一】AI Studio 项目详解【(一)VisualDL工具、环境使用说明、脚本任务、图形化任务、在线部署及预测】PARL
相关文章 [一]-环境配置+python入门教学 [二]-Parl基础命令 [三]-Notebook.&pdb.ipdb 调试 [四]-强化学习入门简介 [五]-Sarsa&Qlear ...
Twain的学习记录和基于Qt的相关开源项目详解
Twain学习记录和基于Qt的开源项目详解 twpp-qml 适用于 C++11 及更高版本的便携式.仅标头 TWAIN 框架. 原项目作者使用Qtwidget基于Twain静态传输一张图片我基于h ...
【JavaWeb篇】快速上手Tomcat|实战项目详解
作者主页:橙子! 主页系列专栏:JavaWeb基础教程系列精彩回顾:HTTP协议详解文章目的:Web服务器TomCat的使用以及配置问题文章目录前言 1.Web服务器 2.Tomcat简介 ...
Eclipse编译运行Native代码步骤详解
Eclipse编译运行Native代码步骤详解标签: android jni层 android jni步骤 android jni接口转自: http://blog.csdn.net/ ...
VS中使用Qt方法详解
在 Qt Creator 中可以使用 MSVC 编译工具对 Qt 项目进行编译.若有人比较习惯于使用 Visual Studio,或某些项目必须使用 Visual Studio,也可以在 Visual ...
Gartner2019年十大安全项目详解
(文章来源https://www.sec-un.org/gartner2019年十大安全项目详解/ ) 1. 概述 2019年2月11日,Gartner一改过去在年度安全与风险管理峰会上发表10大安全 ...
初识QT（十二）——VS中使用Qt方法详解
在 Qt Creator 中可以使用 MSVC 编译工具对 Qt 项目进行编译.若有人比较习惯于使用 Visual Studio,或某些项目必须使用 Visual Studio,也可以在 Visual ...
Gartner：2018年十大安全项目详解
Gartner 2018年十大安全项目详解 Last Modified By Bennyye @ 2018-11-20 1 概述 2018年6月份,一年一度的Gartner安全与风险管理峰会上 ...
tensorRT 部署 YOLOV5模型详解
tensorRT 部署 YOLOV5模型详解第一步: 下载tensorRT库 https://developer.nvidia.com/nvidia-tensorrt-8x-download 欢迎使 ...

rv1109/rv1126 编译并部署QT项目（详解）

目录

前言