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

一键安装 ​

欢迎使用 BMC Studio 一键安装视频操作指导，本视频将为您介绍自动安装步骤，助您轻松完成 BMC Studio 的安装。

使用前准备 ​

• 进入openUBMC应用市场，在“开发工具”模块中下载 BMC Studio 安装包（.zip格式），并将下载的安装包解压，获得.vsix文件。

• 确保本地已安装 VS Code(全称：Visual Studio Code，以下简称：VS Code)， 且已经通过 Remote 插件连接到开发使用的 Ubuntu/docker 环境。

环境要求 ​

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

安装插件 ​

• 通过 VS Code 安装插件。

  1. 打开 VS Code，参考下图步骤操作。

  2. 选择.vsix文件存放路径，安装插件。

     说明：
     

     选择前，请先确定.vsix文件存放的操作系统，Windows 或 wsl。

  3. 安装完成后重启 VS Code 生效。

• 在 WLS 开发环境中安装插件。

  根据实际情况在 Ubuntu 或 Linux 环境下，执行以下命令进行安装（“xxxxxx”表示.vsix文件的存放路径）。

  bash

  code --install-extension xxxxxx

安装和使用工具 ​

1. 在 VS Code 打开已安装的 BMC Studio 的插件。

2. 插件将会自动对环境进行检测，查询是否安装 BMC Studio 和 Qemu。

   • 如果检测到环境中未安装工具，请执行以下步骤3~步骤7安装和启动。

   • 如果检测到环境中已安装工具，插件将会自动启动 BMC Studio。

     说明：
     

     如果当前安装的工具非最新版本，您可以单击界面上的“一键更新”升级工具版本，也可以直接使用当前的旧版本。

3. 单击“一键安装工具”，弹出“使用协议”相关弹框。

4. 勾选“同意《BMC软件许可协议》协议”，单击“继续安装”。插件将开始下载并安装您缺失的工具和依赖。安装时间根据网络情况，预计在1~10分钟不等。

5. （可选）如果下载时间过长，您可以在 VS Code 上方导航栏中选择“终端 > 新建终端”，在新建的终端中选择“输出”，右侧下拉框选择“Debug Logs”，打开日志查看是否报错，如果存在报错，请根据日志的实际情况处理。

6. 安装成功后“一键安装工具”的按钮变为“开始使用”。

7. 单击“开始使用”，即可启动 BMC Studio。

插件实时模型检查 ​

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

插件双屏显示 ​

BMC Studio 插件支持双屏查看文件的能力。在打开一个 .sr 或 .json文件后，vscode 右上角会出现这个图标。点击该图标，即可启动 BMC Studio 双屏模式。 双屏模式中，插件会使用 BMC Studio 打开该 .sr 或 .json 文件，然后展示在插件页面里。

插件在线调试 ​

前置条件：

• BMC Studio 版本不低于1.2.0。

  BMC Studio 最新版本获取方法请参考BMC Studio安装指南。

• BMC Studio 插件版本不低于0.0.5。

  插件安装方法请参考安装插件。

• Qemu 已安装。

  开发环境初始化过程会安装 Qemu，无需手动安装。

在线调试：

在线调试的具体流程，请参考Qemu文档。

卸载插件 ​

安装了插件后，可以在 vscode 的扩展页面的“已安装”一栏中看到 BMC Studio 插件。按图中顺序点击。 点击图中的“卸载”按钮即可完成卸载。