Basel
Bazel 是 Google 开发的开源构建和测试工具。 它旨在管理具有复杂依赖关系的多语言和多平台的大型代码库。 Bazel 自动化了编译代码、链接依赖项、运行测试和部署工件的过程。
JetBrains Bazel 插件可能对您有用,但尚未准备好用于许多生产环境。 请将您遇到的任何问题报告到我们的 YouTrack 问题跟踪器。
安装 Bazel 插件
此功能依赖于 Bazel 插件,您需要安装并启用它。 更多信息请参阅 从 Marketplace 安装插件。
Bazel 支持基于通用的 Build Server Protocol (BSP) 实现,该协议将多种构建工具与 IDE 集成。 该协议作为一个单独的插件提供,与 JetBrains Bazel 插件一起自动安装。
按 Ctrl+Alt+S 打开设置,然后选择 。
打开 Marketplace 选项卡,找到 Bazel 插件,然后点击 安装。
重启 IDE 以激活插件。
打开项目
打开 Bazel 项目
请在欢迎屏幕上点击 打开。
或者,前往主菜单中的 。
在打开的对话框中,指定项目源的路径。
您可以在 构建 工具窗口中查看导入项目的过程:

打开 Bazel 项目目录将创建一个默认的项目视图文件 projectview .bazelproject ,该文件加载整个工作区。
打开项目子集
由于 Bazel 通常用于大规模项目,您可能希望打开项目子集以减轻 IDE 的负担。 Bazel 插件通常支持由 Google 实现的项目视图文件功能 。
在 项目 工具窗口(主菜单中的 Alt+1 或 )中,右键点击预定义的项目视图文件并选择 加载项目视图。

或者,在欢迎屏幕上点击 打开 或转到主菜单中的 并选择预定义的项目视图文件。
在文件更改时重新同步项目
当您更改 BUILD 、 WORKSPACE 、 MODULE.bazel 或其他构建定义文件时,IDE 会显示一个弹出窗口,其中包含更新已加载项目结构的按钮。 点击此图标以重新加载项目或按 Ctrl+Shift+O。

您还可以使用 Basel 工具窗口重新加载项目。
在主菜单中,前往 。
在 Basel 工具窗口中,点击
构建并重新同步项目 按钮。
构建并重新同步项目 选项还会在同步过程中运行完整构建。 这确保了所有生成的源依赖项可用。
构建、运行和调试项目
筛选和搜索目标
在 Basel 工具窗口中,您可以筛选可运行和可测试的目标。
在主菜单中,前往 。
点击
图标,或通过在搜索字段中键入搜索特定目标。

运行目标
在主菜单中,前往 。
双击目标树中的目标以触发默认操作:运行可运行目标或测试可测试目标。
构建目标
要构建特定目标,请转到主菜单中的 。
右键点击目标并选择 构建目标。
构建项目
在主菜单中,前往 或按 Ctrl+F9。
构建项目 操作构建所有目标。
设置运行配置
每当您运行 Bazel 目标时,插件会自动创建一个临时的 运行配置 ,您可以根据需要进行编辑。
在主菜单中,转到 或使用 IDE 窗口标题中的 运行小部件。

选择一个运行配置。
在右侧部分,根据需要更改设置。
运行测试
点击编辑器边栏中您要运行的测试旁边的
图标。
或者,在 Basel 工具窗口中右键点击目标并选择 使用 Bazel 测试。

Starlark 支持
Bazel 插件在 Starlark 文件中提供代码补全和导航功能:

调试 Starlark 代码
设置断点。
右键点击 Basel 工具窗口中的相应目标并选择 Starlark 调试。
