文档中心
BMC Studio安装指南
更新时间： 2026/03/18
在Gitcode上查看源码

本文档主要介绍 BMC Studio 的环境搭建以及安装指导。

openUBMC Studio可以通过openUBMC应用市场获取

安装openUBMC Studio ​

系统要求 ​

在安装openUBMC Studio之前，请确保您的系统满足以下要求：

  • 操作系统：Windows 10 或更高版本（64位）
  • 内存：建议8GB或以上
  • 磁盘空间：至少2GB可用空间
  • 网络：需要网络连接以下载依赖和访问社区资源

下载安装包 ​

  1. 访问openUBMC Studio下载链接
  2. 下载安装包到本地

说明：
建议从官方渠道下载安装包，以确保软件的安全性和完整性。

执行安装程序 ​

  1. 双击打开下载的exe安装包

  2. 根据安装向导提示进行操作：

    • 同意许可协议
    • 选择是否从vscode迁移插件（如果之前安装过VSCode，可选择迁移已有插件）

  3. 点击“安装”按钮，等待安装完成

  4. 安装完成后，点击"完成"退出安装向导

说明：
安装过程中如果遇到杀毒软件拦截，请选择允许或添加到信任列表。

环境初始化配置 ​

首次启动openUBMC Studio时，需要进行环境初始化配置。初始化配置将帮助您设置开发环境、配置检查规则等，确保工具能够正常运行。

启动引导页面 ​

  1. 首次启动openUBMC Studio，界面将显示初始化引导页面。

  2. 根据引导页面的提示，逐步完成以下配置：

    • 登录到社区
    • 配置BMC开发环境
    • 配置conan
    • 配置检查规则集

  3. 点击“完成”按钮，完成初始化配置。

说明：
初始化配置完成后，如果完成过一次完整配置则不再弹出，可随时通过欢迎页面重新触发。
环境初始化完成后，一般不需要频繁配置。

附录：2025版本BMC Studio安装指南 ​

环境准备 ​

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

    说明：

    如果本地环境已搭建完成，可跳过此操作。

  • 操作过程中可能需要使用 git 和 bingo 工具，请确保本地已安装。

运行环境 ​

操作系统：Ubuntu 24.04。

安装方式 ​

本文提供三种安装 BMC Studio 的方式：“自动升级与安装”、“通过 apt 源手动安装仓颉工具链和 BMC Studio”、“通过应用市场安装”。

自动升级与安装 ​

目前通过 manifest 初始化工作环境时，会自动安装 BMC Studio，具体操作方法可以参考Ubuntu开发环境搭建。

如果本地已存在 BMC Studio 工具，可执行以下命令将工具升级到最新版本。

bash
bingo upgrade

通过 apt 源手动安装仓颉工具链和 BMC Studio ​

  1. 执行以下命令检查本地是否已配置 apt 源：

    bash
    sudo apt update
apt policy openubmc-bingo

    • 如果出现以下输出，表示 apt 源已配置完成，可直接执行步骤 5。

    • 如果未出现以下输出，表示未配置 apt 源，请执行步骤 2-步骤 5。

      bash
      openubmc-bingo:
Installed: 0.0.1
Candidate: 0.0.1
Version table:
0.0.1 500
500 https://openubmc-apt-repo.obs.cn-north-4.myhuaweicloud.com/Ubuntu noble/main amd64 Packages

  2. 下载 GPG 公钥

    1. 安装 gnupg。

      bash
      sudo apt update && sudo apt install gnupg

    2. 安装 GPG 公钥。

      • （方式一）直接下载 GPG 文件安装

        1. 指定下载公钥的位置。

          bash
          sudo mkdir -p /etc/apt/keyrings

        2. 下载 GPG 文件。

          bash
          wget -O- https://openubmc-apt-repo.obs.cn-north-4.myhuaweicloud.com/Ubuntu/gpg_key.public | sudo gpg --dearmor -o /etc/apt/keyrings/openubmc.gpg

      • （方式二）通过公钥服务器下载

        1. 指定下载公钥的位置。

          bash
          sudo mkdir -p /etc/apt/keyrings

        2. 下载 GPG 文件。

          bash
          gpg --keyserver keyserver.ubuntu.com --recv-keys BF3B2D407FDEDEA0DC91CC9412640FBCB175287A
gpg --export BF3B2D407FDEDEA0DC91CC9412640FBCB175287A | sudo tee /etc/apt/keyrings/openubmc.gpg >/dev/null

  3. 配置 apt 源。

    bash
    echo "deb [arch=amd64 signed-by=/etc/apt/keyrings/openubmc.gpg] https://openubmc-apt-repo.obs.cn-north-4.myhuaweicloud.com/Ubuntu/ noble main" | sudo tee /etc/apt/sources.list.d/openubmc.list

  4. 验证APT配置。

    bash
    sudo apt update
apt policy bmc-studio

  5. 安装仓颉依赖包和 BMC-Studio deb 包。

    bash
    apt remove bmc-studio
apt install cangjie-runtime
apt install bmc-studio

通过应用市场安装 ​

  1. 进入 openUBMC应用市场，在“开发工具”模块下。选择“BMC Studio”。

  2. 在 BMC Studio 下载页面，单击右侧“立即下载”按钮，将 BMC Studio 软件包下载到本地。

  3. 根据该页面的安装指引安装 BMC Studio 即可。

启动 BMC Studio ​

  • 如果您有 BMC Studio 插件，直接点击插件即可在 VS Code 中启动 BMC Studio。

  • 如果您有 bingo ，执行以下命令，即可启动 BMC Studio 。（此方法需要 bingo 版本大于等于0.5.238）

    bash
    bingo studio

    • 如果您使用的是 wsl 系统，可以直接在浏览器中看到 BMC Studio 的前端页面。

    • 如果您使用的不是 wsl 系统，需要在浏览器中手动输入后端日志显示的该地址（视您的系统环境而定）

  • 如果您想使用 BMC Studio 本身的启动方式，请参考以下命令。

    bash
    /usr/share/bmc_studio/bmc_studio.sh start
/usr/share/bmc_studio/bmc_studio.sh start backend

常用命令 ​

  • 通过 bingo 执行的常用命令：

    • 启动 BMC Studio：

      bash
      bingo studio

    • 停止 BMC Studio：

      bash
      bingo studio -stop

    • 重启 BMC Studio：

      bash
      bingo studio -restart

  • 通过 BMC Studio 执行的常用命令：

    • 启动 BMC Studio：

      bash
      /usr/share/bmc_studio/bmc_studio.sh start
/usr/share/bmc_studio/bmc_studio.sh start backend

    • 停止 BMC Studio：

      bash
      /usr/share/bmc_studio/bmc_studio.sh stop

    • 重启 BMC Studio：

      bash
      /usr/share/bmc_studio/bmc_studio.sh restart

常见问题处理 ​

请参考BMC Studio FAQ。

上一篇Docker开发环境搭建
下一篇构建你的BMC