基于RK3576开发板的QT GUI例程

1. 方案简介

       EASY EAI Orin-Nano安装的是带有xfce桌面环境的Debian系统，因此在上面运行的Qt应用程序可被窗口管理器接管。如下图所示：

       而且RK3576的CPU性能也十分强大，因此Qt应用程序可直接在开发板上进行编译，这样能达到最优的兼容性。

2. 快速上手

       如果您初次阅读此文档，请阅读：《入门指南/源码管理及编程介绍/源码工程管理》，按需管理自己工程源码（注：此文档必看，并建议采用【远程挂载管理】方式，否则有代码丢失风险！！！）。

2.1  源码工程下载

       先在PC虚拟机定位到nfs服务目录，再在目录中创建存放源码仓库的管理目录：

 

cd ~/nfsroot
mkdir GitHub
cd GitHub

 

       再通过git工具，在管理目录内克隆远程仓库（需要设备能对外网进行访问）

 

git clone https://github.com/EASY-EAI/EASY-EAI-Toolkit-3576.git

 

  注：

* 此处可能会因网络原因造成卡顿，请耐心等待。

* 如果实在要在gitHub网页上下载，也要把整个仓库下载下来，不能单独下载本实例对应的目录。

2.2  开发环境搭建

       通过adb shell进入板卡开发环境，如下图所示。

       若未曾在此开发板上开发过Qt程序，需要先在开发板上安装以下几个软件包：

 

sudo apt-get update
sudo apt-get install qtbase5-dev

 

       通过以下命令，把nfs目录挂载上nfs服务器。

 

mount -t nfs -o nolock < nfs server ip >:< nfs path in server > /home/orin-nano/Desktop/nfs/

 

2.3  例程编译

       然后定位到nfs的挂载目录，再在目录中创建存放源码仓库的管理目录：

 

cd /home/orin-nano/Desktop/nfs/GitHub

 

       进入到对应的开发实例目录执行编译操作，具体命令如下所示：

 

cd EASY-EAI-Toolkit-3576/UiSolutions/QDemo
./build.sh

 

2.4  例程运行及效果

       执行下方命令，运行示例程序：

 

./Release/QDemo

 

       执行例程，桌面会弹出一个基于Qt库开发的应用窗口，效果如下所示。

3. 开发指南

3.1  Toolkit仓库介绍

3.2  示例文件&目录结构

3.2.1   开发实例介绍

        每个解决方案就是一个独立的项目，项目使用qmake构建自动编译部署。一个最简单的Qt项目至少要包含以下元素：build.sh、*.pro、main.cpp、mainWidget.ui、mainWidget.cpp、mainWidget.h，如下所示。

       具体介绍如下所示。

组成部分	描述
build.sh	编译脚本，用于管理生成可执行文件后的部署准备工作，用户可自定义shell命令
QDemo.pro	工程管理文件，用于组织整个工程结构，指导qmake生成Makefile。
QResource	用于存放贴图资源，样式表资源等。
resource.qrc	工程管理文件，用于组织管理贴图资源，样式表资源等。
QSrcCode	用于存放工程源代码。
api.pri	工程管理文件，用于组织管理“对easyeai-api再封装的子模块”相关源码。
common.pri	工程管理文件，用于组织管理“第三方子模块”或“业务逻辑”相关源码。
ui.pri	工程管理文件，用于组织管理“UI界面效果”相关源码。

3.3  *.pro和*.pri文件解析

3.3.1    *.pro文件：

       第一部分为输出配置，如下所示：

       配置信息如下所示。

配置项	描述
TARGET	输出文件名称
TEMPLATE	输出文件类型，app为可执行文件，lib为库文件

       第二部分为全局编译选项配置，如下所示：

配置项	描述
LIBS	全局链接库，通常是本Ubuntu系统提供的库
QMAKE_CXXFLAGS	全局C++编译参数，可传入一些宏或者C++编译配置

        第三部分为加载自定义子模块，如下所示：

       第四部分为加载资源管理，如下所示：

       第五部分为指定文件输出目录，如下所示：

3.3.2    api.pri文件：

       本工程文件是对我司的功能组件库的管理，若用户有“对我司的功能组件库进行再封装”的需求，则可通过本文件来管理。（针对当前方案进行：配置EASY EAI API头文件目录、库文件目录以及配置库链接参数）：

       配置信息如下所示。

配置项	描述
COMMONAPI_DIR	自定义的变量，指定好common接口的位置，维护起来更简洁。
ALGORITHM_DIR	自定义的变量，指定好algorithm接口的位置，维护起来更简洁。
INCLUDEPATH	QT默认变量，向工程指定头文件的查找路径。
HEADERS	QT默认变量，向工程添加需要编译的头文件。
SOURCES	QT默认变量，向工程添加需要编译的源文件。
LIBS	QT默认变量，指定对应的easyeai-api库文件以及其依赖的编译参数，不清楚该如何填写可以进入对应接口的api.cmake里查看，并且要注意引用的先后顺序关系。

3.3.3    common.pri文件：

       本工程文件是第三方的库的配置（针对当前方案进行：配置第三方头文件目录、库文件目录、配置第三方库链接参数以及配置源码目录）：

       配置信息如下所示。

配置项	描述
INCLUDEPATH	向工程指定头文件的查找路径
SOURCES	向工程添加需要编译的源文件
HEADERS	向工程添加需要编译的头文件

3.3.4    ui.pri文件：

       本工程文件是交互界面相关的源码文件配置，内容如下所示：

       配置项如下所示。

配置项	需求
SOURCES	向工程添加需要编译的源文件
HEADERS	向工程添加需要编译的头文件
FORMS	向工程添加Qt设计师产生的界面文件

3.4  build.sh编译脚本：

3.4.1   路径定位部分

       第一部分用于提取目录用于编译操作，内容如下所示：（进入build.sh脚本所在目录，并且提取当前目录绝对路径，提取当前目录名称）

3.4.2   编译参数部分

       第二部分清除操作，清除目录为Release，内容如下所示：（执行build.sh脚本时，带入了参数“clear”，则清空编译输出；带入了参数“all”，则重新编译）

3.4.3   编译操作

       第三部分，编译直接调用qmake，内容如下所示：（重新编译，并生成部署目录）

审核编辑 黄宇