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,内容如下所示:(重新编译,并生成部署目录)
