AliOS Things uCube是AliOS Things基于命令行的开发管理工具(命令简写为aos),主要功能包括:工程配置与编译、Image下载调试、应用开发框架、脚手架、组件安装管理、设备管理、代码审查、OTA工具功能以及与IDE集成功能。
uCube 基于 Python(支持Py 2.7和3)语言开发,需要有Python开发环境。如开发环境中尚未安装aos-cube,请通过pip install -U aos-cube
进行安装(需确保先安装了python和pip工具)。
使用
工具改善计划
从0.3.11之后的版本开始,安装aos-cube工具后,首次运行aos-cube命令时会有如下提示:
***Attention***:
==============================================================
In order to improve the user experience of this tool,
we want to collect some of your system information
(e.g. OS version, IP, shell used, aos-cube functionalities
most frequently used, etc.). All collected information
will be only be used in the user-experience improve plan,
and will be carefully and restrictly secured.
==============================================================
Do you want to participate in the activity?
Please type 'Y[es]' or 'N[o]': Y
该提示旨在提示用户参与工具改善计划,用户可自由选择,用户选择Yes后会有部分信息收集用于工具使用的统计和后续改善。建议用户选择Yes参与该计划。
查看版本和帮助
使用aos --version
查看aos-cube版本。 使用aos -h
查看aos-cube支持的命令。 使用aos <cmd> -h
查看命令的格式、选项和参数说明。 使用aos <cmd> <subcmd> -h
查看子命令(如有)的格式、选项和参数说明。
环境变量设置
用户拿到AliOS Things SDK后,开发前首先需设置“AOS_SDK_PATH”环境变量(指向aos源码根目录)。
创建应用
通过aos create project -b <board_name> -d <project_dir> -t <example_templete> <projectname>
创建应用工程,开始应用开发。
配置
切换到应用工程目录,执行aos make menuconfig
可进行可视化配置。同时,配置也可以通过修改应用工程中的aos_config.h文件进行。
更新工程元数据
当开发中修改了代码和配置,可以通过aos make update
进行工程元数据的更新。
工程构建
完成应用开发后,可以通过构建命令aos make
进行编译。关于使用aos make
执行构建请参考使用命令行工具开发。
烧录与调试
构建完成后,连接开发板到开发主机,首先将编译生成的镜像上传到开发板,然后启动调试器:
aos upload helloworld@developerkit
aos debug helloworld@developerkit
AliOS Things 2.1及其后续版本支持简化的烧录和调试命令行(需要aos-cube 0.3.x):
aos upload
aos debug
注意,命令行烧录和调试功能目前仅支持stm系列、esp32/esp8266等部分硬件平台。
串口监控
通过连接串口,查看应用输出和执行过程:
$ aos monitor <serial port> <baudrate>
SAL/MAL驱动开发
如果是进行SAL/MAL外设驱动开发,可以借助脚手架自动生成驱动框架,然后在对应的框架中完成驱动开发。
- 生成SAL驱动框架:
aos create saldriver -t <gprs|wifi|lte|nbiot|eth|other>
- 生成MAL驱动框架:
aos create maldriver -t <gprs|wifi|lte|nbiot|eth|other>
组件开发与管理
从3.1版本开始,AliOS Things支持组件话开发和管理。官方认证的组件发布在云端服务器,用户可以通过aos-cube命令进行组件的安装和管理。
组件查询
- 本地组件查询:
aos list comp
- 云端组件查询:
aos list comp -r -a
组件安装
- 从云端安装最新版本组件:
aos install comp <name>
- 从云端安装特定版本组件:
aos install comp <name=version>
- 多个组件安装:
aos install comp <name1> <name2> <name3>
- 从本地文件安装组件:
aos install comp -L <zip_or_rpm_file>
。本地组件文件,可以是通过aos pack
命令生成的ZIP文件,也可以是从AliOS Things组件官网下载的RPM文件。
组件卸载
- 单个组件卸载:
aos remove comp <name>
- 多组件卸载:
aos remove comp <name> [name2] [name3]
组件升级
- 查询可升级组件:
aos upgrade comp -c
- 组件升级:
aos upgrade comp <name1> <name2>
组件开发
- 使用脚手架生成组件框架:
aos create component -t <bus|dm|fs|gui|language|linkkit|network|peripherals|security|service|utility|wireless|generals> <compname>
- 根据需要增加源码和头文件,并修改对应的aos.mk文件。规范详见《组件规范》。
- 组件打包与分享:
aos pack <comp_dir>
- 打开组件示例工程:
aos open -b <board> <comp_name>
在文档使用中是否遇到以下问题
更多建议
匿名提交