emake用户手册

概述

emake是EwayOS对外发布的开发接口(SDK)的一部分,负责自动生成、配置C++工程。emake基于Ubuntu 14.04 - Desktop操作系统,IDE使用Qt Creator 4.0.2。

安装

EwaySDK.run为SDK安装包,下载到本地后,运行命令sudo chmod +x EwaySDK.run添加安装包的可执行权限,然后运行命令sudo ./EwaySDK.run执行安装。

使用

安装成功后在任意目录打开终端,输入emake即可运行emake。

用法:emake [选项1] 值1 [选项2] 值2 …

成功生成后使用Qt Creator打开工程文件夹中的.pro工程文件。

选项

  • -t 指定生成工程类型,支持取值为fapp,flib和slib。

  • fapp: 生成Function应用程序工程,可运行在操作系统为Ubuntu14.04的电脑上,通过有线或wifi连接MoRo上运行的HighLevelAI及LowLevelAI,可获取Sensor的数据,调用FuncInterface相关接口发送命令控制机器人运动及调用他人的FunctionLib库。

    此类程序不需要上传到MoRo上运行。

  • flib: 生成FunctionLib工程,此工程生成为一个MoRo Function动态库,Function库可被其它Function程序加载,加载后可获取Sensor的数据,调用FuncInterface相关接口发送命令控制机器人运动及调用他人的FunctionLib库。

    Function库需要通过WebUI上的Applications页面上传到MoRo上运行。

  • slib: 生成SensorLib工程,此项目生成为一个Sensor的Element动态库,Sensor Element库可被Sensor程序加载,加载后可向HighLevelAI申请feature,根据多个Element的链接关系,加载其他Element;各Element调用相关算法,获取、计算、传输Sensor数据。

    Sensor Element库需拷贝至MoRo上Sensor的安装路径下运行。

  • -n 指定生成工程的名称,名称必须以字母开头,中间不可出现除字母及数字之外字符。

  • -i 设置MoRo的IP地址(依据实际网络配置)

  • -v 显示emake版本号

  • -h 显示emake帮助信息

  • -u 升级emake

示例

emake -t fapp -n DemoFapp -i 192.168.6.50

生成名为DemoFapp的fapp类型工程,MoRo IP为192.168.6.50

emake -t flip -n DemoFlib

生成名为DemoFlib的flib类型工程

emake -t slib -n DemoSlib

生成名为DemoSlib的slib类型工程

编写程序

emake生成的项目一般包含一个.h头文件,一个.cpp源代码文件,一个.pro工程文件,应用程序还有一个main.cpp文件。其中.pro文件为Qt Creator工程文件,.h文件及.cpp文件为主要编程区域。工程中使用的具体接口请参阅FunctionSDK和SensorSDK使用说明书。 注意:请不要删除任何emake自动生成的代码。