本文档仅适用于AliOS Things 3.1及其后续版本,3.1之前版本请忽略。
本文将详细介绍AliOS Things 3.1支持的构建命令及其用途,帮助开发者快速掌握高级命令行构建功能。
AliOS Things 3.1代码可视化裁剪页面地址:https://aliosthings.iot.aliyun.com/aos/download。
关于工程配置请参考更多配置操作。
AliOS Things 2.1开始全面支持menuconfig配置系统,并将工程配置做为构建的必要步骤之一。与工程配置相关的命令包括:
- 根据用户指定的App、Board创建工程,并生成默认配置:
aos create project -b board -t templateapp -d destdir appname
其中-b 指定板子名称,必选。 -t 指定App模板,可选;若不指定,则使用最精简的templateapp作为模板。 -d 指定工程目录,可选;若不指定,则使用当前目录。
- 打开menuconfig菜单,允许用户在交互状态下自定义工程配置:
aos make menuconfig
- 列出当前可以用的预定义配置:
aos make list-defconfig
- 为当前工程加载预定义配置:
aos make <configname>_defconfig
更多关于预定义配置的说明请参考更多配置操作。
- 清除工程编译结果,恢复配置文件至初始状态(“aos make clean”仅清除编译结果)
aos make distclean
编译相关命令和参数
在完成工程配置后,编译命令简化为:
aos make
通过附加命令行参数的方式可以控制编译行为,实现高级编译功能:
aos make [VAR=value]
有效命令行参数包括:
- MBINS=[app|kernel]:分别生成App、Kernel镜像,详情请参见多bin特性。
- BUILD_TYPE=[debug|release|release_log]:控制构建类型:
- debug:编译时不优化(-O0)并启用日志
- release:编译时优化(-Os),不启用日志
- release_log:默认值,编译时优化,并启用日志
- IDE=[keil|iar]:生成指定工程并执行编译,仅支持Windows环境,详情请参见自动生成Keil MDK工程、自动生成IAR工程
- COMPILER=[armcc|iar|rvct]:使用指定编译器执行编译,仅支持Windows环境
- VERBOSE=1:编译时输出详细命令
- 更多命令行参数请查看
aos make help
创建组件相关命令和参数
在AliOS Things目录下,基于组件脚手架创建一个新的组件,命令如下:
aos create component -t <component_type> <component_name>
其中 component_type 表示组件类型,目前支持的类型有:
bus: 本地通讯协议
dm: 设备管理
fs: 文件系统
generals: 通用类
gui: 人机交互界面
language: 脚本引擎
network: IP网络协议栈
peripherals: 外设驱动
security: 安全
service: 应用组件
utility: 工具类
wireless: 无线类
component_name 表示组件名称。
如果组件内部带示例APP,可使用aos open
命令打开,调试组件功能。
aos open <component_name> -b <board_name>
其中 component_name 表示组件名称。 board_name 表示board名称。
其他命令
AliOS Things 3.1构建系统还支持以下命令:
- 查看帮助
aos make help
- 清除构建生成文件
# 清除构建生成文件,不包括配置文件
aos make clean
# 连同配置文件一同清除
aos make distclean
- 仅生成Keil、IAR工程,不执行编译
# 生成Keil工程
aos make export-keil
# 生成IAR工程
aos make export-iar
- 将aos_config.h的配置项同步到.config文件中
aos make update
如果用户安装了graphviz,执行该命令也会生成组件依赖文件comp_deps_topo.png。 如果没有安装graphviz,会提示
sh: 1: dot: not found
信息,但是不影响上述的同步操作。
更多命令和参数请以aos make help
为准。
在文档使用中是否遇到以下问题
更多建议
匿名提交