瑞芯微(EASY EAI)RV1126B QT GUI例程方案

1. 方案简介

本方案为最简单的UI开发示例，已为用户初步构建一个基本的应用工程；准备好我司的easyeai-api链接调用；准备好UI的开发环境。其目的在于方便用户马上进行带有界面交互的产品开发，无须关心工程组建。

2. 快速上手

2.1 开发环境准备

如果您初次阅读此文档，请阅读《入门指南/开发环境准备/Easy-Eai编译环境准备与更新》，并按照其相关的操作，进行编译环境的部署。

在PC端Ubuntu系统中执行run脚本，进入EASY-EAI编译环境，具体如下所示。

cd ~/develop_environment ./run.sh 2204

2.2 源码下载以及例程编译

在EASY-EAI编译环境下创建存放源码仓库的管理目录：

cd /opt mkdir EASY-EAI-Toolkit cd EASY-EAI-Toolkit

通过git工具，在管理目录内克隆远程仓库

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

注：

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

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

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

cd EASY-EAI-Toolkit-1126B/UiSolutions/QDemo/ ./build.sh

注：

* 由于依赖库部署在板卡上，因此交叉编译过程中必须保持/mnt挂载。

若编译过程中出现以下报错：

则需要【在板卡上】执行以下命令，安装Qt库

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

安装完成后再次回到EASY-EAI编译环境中进行编译操作。

2.3 例程运行

通过串口调试或ssh调试，进入板卡后台，定位到例程部署的位置，如下所示：

cd /userdata/UiSolu

运行例程命令如下所示：

./qSolu-QDemo

2.4 运行效果

运行打印：

液晶显示屏上会显示如下画面：

点击“欢迎”按钮，可以显示/隐藏提示语。

2.5 开机启动

首先进入板卡后台，执行以下命令，在板卡上创建一个给本例程使用的应用目录：myapp

mkdir -p /userdata/apps/myapp cd /userdata/apps/myapp

然后去到/userdata/UiSolu目录中，把本【例程所需要的】全部文件，包含：编译结果，配置文件，模型等。部署到刚刚新建的myapp目录中。

cp /userdata/UiSolu/* -r

* /userdata/UiSolu/下的内容，是由Qt工程的build.sh脚本生成。

最后在板卡上创建一个run.sh脚本来管控用户所有需要的应用即可，《入门指南/应用程序开机自启动》会详细描述run.sh脚本该如何编写。

3. QtCreator配置

3.1 运行qtcreator

在EASY-EAI编译环境中的任意位置，通过下方命令，后台打开qtcreator：

qtcreator &

注：若虚拟机配置较低，打开qtcreator可能要等待10几秒。

3.2 打开Qt工程

若QtCreator无法设置成中文界面，可以在EASY-EAI编译环境中执行下方命令，然后重启QtCreator即可。

sudo apt-get update sudo apt-get install qttranslations5-l10n

3.3 配置远程调试参数

注：进行远程调试前，首先要用build.sh脚本把相关的资源拷贝到【开发板】相对应的目录上，否则会因缺少文件导致运行异常。

3.4 远程运行Qt应用

3.5 调试打印输出&远程停止应用进程

3.6 修改应用编译输出位置

注：任何修改*.pro或者*.pri的操作，都要clean掉Makefile后，再重新编译。

4. 开发指南

4.1 Toolkit仓库介绍

4.2 示例文件&目录结构

4.2.1 开发实例介绍

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

具体介绍如下所示。

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

4.3.1 *.pro文件：

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

配置信息如下所示。

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

配置信息如下所示。

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

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

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

4.3.2 api.pri文件：

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

配置信息如下所示。

4.3.3 common.pri文件：

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

配置信息如下所示。

4.3.4 ui.pri文件：

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

配置项如下所示。

4.4 build.sh编译脚本：

4.4.1 路径定位部分

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

4.4.2 编译参数部分

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

4.4.3 编译操作

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