本文档主要介绍如何使用BMC Studio插件。

使用前准备

下载BMC Studio插件。进入openUBMC应用市场，在“开发工具”模块中下载格式为.vsix的BMC Studio插件。
确保本地已安装VS Code(全称：Visual Studio Code，以下简称：VS Code)，且已经通过Remote插件连接到开发使用的Ubuntu/docker环境。

环境要求

BMC Studio需要在Ubuntu24环境上运行，使用前须先搭建环境，具体的搭建方法请参见环境准备，请用户根据使用的操作系统，参考“环境准备”对应章节进行环境搭建。例如：本地使用Window开发环境，请参考“Windows开发环境搭建”。

打开VS Code，参考下图步骤操作。
选择.vsix文件下载路径，安装插件。
说明：
选择前，请先确定.vsix文件存放的操作系统，Windows或wsl。
插件安装成功后，VS Code左侧工具栏中会出现ü图标。
也可以在开发环境中使用命令code --install-extension

单击VS Code左侧工具栏中的ü图标打开BMC Studio的插件。
插件将会自动对环境进行检测，查询是否安装BMC Studio和Qemu。
- 如果检测到未安装，界面按钮展示“一键安装工具”，执行以下步骤3~步骤6进行安装。
- 如果检测到已安装，界面按钮展示“开始使用”，则无需执行步骤3~步骤6安装操作。
  说明：
  如果当前安装的工具非最新版本，您可以单击界面上的“一键更新”升级工具版本，也可以直接使用当前的旧版本。
单击“一键安装工具”，弹出“使用协议”相关弹框。
勾选“同意《BMC软件许可协议》协议”，单击“继续安装”。插件将开始下载并安装您缺失的工具和依赖。安装时间根据网络情况，预计在1~10分钟不等。
（可选）如果下载时间过长，您可以在VS Code上方导航栏中选择“终端 > 新建终端”，在新建的终端中选择“输出”，右侧下拉框选择“Debug Logs”，打开日志查看是否报错，如果存在报错，请根据日志的实际情况处理。
安装成功后“一键安装工具”的按钮变为“开始使用”。
单击“开始使用”，即可启动BMC Studio。

BMC Stduio启动后，在VS Code中编辑CSR文件或任意BMC Studio工作空间内的MDS、资源协作接口、映射接口文件，保存后会触发插件进行模型检查。检查完成后，在控制台窗口会显示检查结果。