Skip to main content

local-development-setup

本地设置与开发​

仅限开发者信息

本节适用于为 itBuilder 做出贡献的开发者，或希望从源码构建和运行扩展的用户。

要为本地开发设置 itBuilder：

  1. 克隆仓库：

    git clone https://gitee.com/enation-inc/itbuilder.git
    cd itbuilder

  2. 安装依赖： itBuilder 使用 pnpm 作为包管理工具。

    pnpm install

  3. 以开发模式运行扩展： 你有两种主要方法：

    • 直接在 VS Code 中运行（推荐用于活跃开发）：

      • 在 VS Code 中打开克隆下来的 Roo-Code 文件夹。
      • 按下 F5（或在菜单中选择 运行 → 开始调试）。这会打开一个新的 VS Code 窗口（扩展开发主机），其中 itBuilder 正在运行。
      • 对 webview 代码（位于 webview-ui/ 下）的更改通常会实时更新。
      • 对核心扩展代码（位于 src/ 下）的更改通常需要重启扩展开发主机窗口。

    • 构建并安装 VSIX 包： 这种方法适用于测试打包后的扩展或分发开发版本。

      1. 构建 VSIX 文件：

        pnpm vsix

        一个 .vsix 文件（如 roo-cline-<version>.vsix）会被创建在 bin/ 目录下。

      2. 在 VS Code 中安装 VSIX：

        • 使用命令行：

          code --install-extension bin/roo-cline-<version>.vsix

          （将 <version> 替换为文件名中的实际版本号）。

        • 使用 VS Code 界面：

          • 打开扩展视图（Ctrl+Shift+X 或 Cmd+Shift+X）。
          • 点击扩展视图侧边栏中的“...”菜单（更多操作）。
          • 选择“从 VSIX 安装...”
          • 浏览并选择 bin/ 目录下生成的 .vsix 文件。
          VS Code 的从 VSIX 安装对话框

          使用 VS Code 的“从 VSIX 安装...”对话框安装开发版 VSIX。