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>

命令速查表