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

环境准备 ​

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

  说明：
  

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

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

运行环境 ​

操作系统：Ubuntu 24.04。

安装方式 ​

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

自动升级与安装 ​

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

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

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。