*此插件目前仅支持 Windows 系统使用
1. 使用
使用插件需要下载 OneOS-Cube,插件首次打开后会在 VSCode 右下角展示下载弹窗
点击"下载",开始下载 OneOS-Cube 工具,默认下载最新版本
下载完成后,如未在 VSCode 中打开任何项目则可以左侧资源管理器上方找到欢迎面板,点击"快速开始",打开快速开始页面,或点击"打开工程",打开本地 OneOS 源码工程
*插件中下载的 cube 工具包版本不是最新版本,点击依赖 cube 工具包的功能选项会提示
当未打开项目或打开项目非 OneOS 源码,则可在下方找到 ONEOS PROJECTS 面板,展开面板后点击"快速开始"按钮,打开快速开始页面
快速开始页面
点击"获取源码"(从 gitee 仓库拉取指定版本),详细步骤见 1.1
或打开"本地源码"(打开本地 OneOS 源码),详细步骤见 1.2
1.1 获取源码
如点击"获取源码",打开获取源码弹窗,选择目标 OneOS 版本,选择源码存放位置,点击立即创建,开始拉取源码
下载完成后会在新的 VSCode 窗口打开 OneOS 源码工程。
1.2 打开本地源码
选择本地 OneOS 源码后会在新的 VSCode 窗口打开 OneOS 源码工程
2. ONEOS PROJECTS 面板
成功安装 OneOS-ability 插件后,ONEOS PROJECTS 面板会被自动添加到 VSCode 资源管理器(Explore)中。
默认 ONEOS PROJECTS 面板会被收起,首次使用请手动展开即可。
ONEOS PROJECTS 面板是开发者使用本插件的主要区域。
3. 新建项目
点击 ONEOS PROJECTS 面板右侧加号,打开新建项目页面
新建项目页面
根据需求,依次选择"厂商","系列","型号"和"MCU"
点击"立即创建",创建项目
创建成功后,项目会出现在 ONEOS PROJECTS 面板中
4. 操作项目
打开 OneOS 源码工程后,ONEOS PROJECTS 面板中会展示 projects 目录下所有文件夹与文件。如果识别为项目文件夹,则在文件夹右侧展示 3 个按钮:"编译","清理"和"设置"
4.1 编译
点击编译,调用下载的 cube 工具,在 vscode 终端自动执行 cube 命令 oos build
4.2 清理
点击编译,调用下载的 cube 工具,在 vscode 终端自动执行 cube 命令 oos clean
4.3 设置
点击设置图标,打开 OneOS Config 页面,包含所有该项目 Kconfig 文件当中编写的配置项
修改完成后点击上方"保存",VSCode 提示保存成功后,在该项目目录中会生成.config 以及 oneos_config.h 文件
5. OneOS 组件包
点击下方状态栏 OneOS 组件包,打开 OneOS 组件包页面,包含仓库中组件分类信息
点击组件分类菜单,中间区域显示分类所包含的所有组件,右边区域显示组件分类描述
展开某组件下拉菜单,展示该组件提供的版本号,该组件的本地下载版本信息,右边区域显示对应组件描述信息
若本地不存在某一组件,点击对应添加按钮,进行组件及其依赖组件下载
下载后提示组件更新信息,页面对应组件的本地下载版本信息更新
关于 OneOS 的版本兼容问题:低于 3.2.0 版本的 OS 将无法使用软件包更新功能,打开 OneOS 组件包页展示页面如下: