从源代码编译 Bazel

Nightly · 9.0 · 8.6 · 8.5 · 8.4 · 8.3 · 8.2 · 7.7

本页介绍了如何从源代码安装 Bazel，并提供了 针对常见问题的问题排查提示。

如需从源代码构建 Bazel，您可以执行以下操作之一：

使用 Bazel 构建 Bazel

摘要

  1. 从 GitHub 发布页面或使用 Bazelisk获取最新的 Bazel 版本。

  2. 从 GitHub 下载 Bazel 的源代码 并将其解压缩到某个位置。 或者，您也可以从 https://github.com/bazelbuild/bazel 克隆源代码树

  3. 安装与引导相同的先决条件（请参阅 适用于类 Unix 系统的先决条件或 适用于 Windows 的先决条件）

  4. 使用 Bazel 构建 Bazel 的开发 build： bazel build //src:bazel-dev（或在bazel build //src:bazel-dev.exe Windows 上 ）。

    注意 ：许多规则集依赖于 Bazel 版本进行功能检测。 为了使其正常运行，该版本必须嵌入到二进制文件中。 使用以下命令构建 bazel-dev：

    bazel build --stamp --embed_label="X.Y.Z" //src:bazel-dev

    其中，X.Y.Z 是正在构建的 Bazel 版本（例如 8.6.0）。

  5. 生成的二进制文件位于 bazel-bin/src/bazel-dev （或在 Windows 上为 bazel-bin\src\bazel-dev.exe）。您可以将其复制到任意位置，并立即使用，无需进一步安装。

以下是详细说明。

第 1 步：获取最新的 Bazel 版本

目标：安装或下载 Bazel 的发布版本。确保您可以在终端中输入 bazel 来运行 它。

原因：如需从 GitHub 源代码树构建 Bazel，您需要预先存在的 Bazel 二进制文件。您可以从软件包管理器安装一个，也可以从 GitHub 下载一个。请参阅安装 Bazel。（或者，您可以从头开始构建（引导）。）

问题排查：

  • 如果您无法通过在终端中输入 bazel 来运行 Bazel，则可能是因为：

    • 您的 Bazel 二进制文件的目录不在 PATH 中。

      这不是什么大问题。您需要输入完整路径，而不是输入 bazel。

    • Bazel 二进制文件本身可能不称为 bazel（在 Unix 上）或 bazel.exe（在 Windows 上）。

      这不是什么大问题。您可以重命名二进制文件，也可以输入 二进制文件的名称而不是 bazel。

    • 二进制文件可能不可执行（在 Unix 上）。

      您必须运行 chmod +x /path/to/bazel，使二进制文件可执行。

第 2 步：从 GitHub 下载 Bazel 的源代码

如果您熟悉 Git，只需运行 git clone https://github.com/bazelbuild/bazel

否则：

  1. 以 zip 文件的形式下载最新的源代码 。

  2. 将内容解压缩到某个位置。

    例如，在主目录下创建一个 bazel-src 目录，然后将内容 解压缩到该目录。

第 3 步：安装先决条件

安装与引导相同的先决条件（请参阅下文） - JDK、C++ 编译器、MSYS2（如果您在 Windows 上构建）等。

第 4a 步：在 Ubuntu Linux、macOS 和其他类 Unix 系统上构建 Bazel

如需了解 Windows 的说明，请参阅在 Windows 上构建 Bazel。

目标：运行 Bazel 以构建自定义 Bazel 二进制文件 (bazel-bin/src/bazel-dev)。

说明：

  1. 启动 Bash 终端

  2. cd 进入您解压缩（或克隆）Bazel 源代码的目录。

    例如，如果您在主目录下解压缩了源代码，请运行：

    cd ~/bazel-src

  3. 从源代码构建 Bazel：

    bazel build //src:bazel-dev

    或者，您可以运行 bazel build //src:bazel --compilation_mode=opt 以生成较小的二进制文件，但构建速度较慢。

    您可以使用 --stamp --embed_label=X.Y.Z 标志进行构建，以便为二进制文件嵌入 Bazel 版本，这样 bazel --version 就会输出给定的版本。

  4. 输出将位于 bazel-bin/src/bazel-dev（或 bazel-bin/src/bazel）。

第 4b 步：在 Windows 上构建 Bazel

如需了解类 Unix 系统的说明，请参阅 Ubuntu Linux、macOS 和其他类 Unix 系统。

目标：运行 Bazel 以构建自定义 Bazel 二进制文件 (bazel-bin\src\bazel-dev.exe)。

说明：

  1. 启动命令提示符（“开始”菜单 >“运行”>“cmd.exe”）

  2. cd 进入您解压缩（或克隆）Bazel 源代码的目录。

    例如，如果您在主目录下解压缩了源代码，请运行：

    cd %USERPROFILE%\bazel-src

  3. 从源代码构建 Bazel：

    bazel build //src:bazel-dev.exe

    或者，您可以运行 bazel build //src:bazel.exe --compilation_mode=opt 以生成较小的二进制文件，但构建速度较慢。

    您可以使用 --stamp --embed_label=X.Y.Z 标志进行构建，以便为二进制文件嵌入 Bazel 版本，这样 bazel --version 就会输出给定的版本。

  4. 输出将位于 bazel-bin\src\bazel-dev.exe（或 bazel-bin\src\bazel.exe）。

第 5 步：安装构建的二进制文件

实际上，无需安装任何内容。

上一步的输出是一个自包含的 Bazel 二进制文件。您可以将其复制到任何目录并立即使用。（如果该目录位于 您的 PATH 中，则非常有用，这样您就可以在任何位置运行“bazel”。）

从头开始构建 Bazel（引导）

您还可以从头开始构建 Bazel，而无需使用现有的 Bazel 二进制文件。

第 1 步：下载 Bazel 的源代码（分发归档文件）

（此步骤适用于所有平台。）

  1. 从 GitHub下载 bazel-<version>-dist.zip，例如 bazel-0.28.1-dist.zip。

    注意：

    • 有一个独立于架构的 分发归档文件。 没有特定于架构或特定于操作系统的分发归档文件。
    • 这些源代码与 GitHub 源代码树不同。您 必须使用分发归档文件来引导 Bazel。您无法 使用从 GitHub 克隆的源代码树。（分发归档文件包含 引导所需的生成源代码文件，这些文件不属于正常 Git 源代码树的 一部分。）

  2. 将分发归档文件解压缩到磁盘上的某个位置。

    您应验证 Bazel 的 发布密钥 3D5919B448457EE0 所做的签名。

第 2a 步：在 Ubuntu Linux、macOS 和其他类 Unix 系统上引导 Bazel

如需了解 Windows 的说明，请参阅在 Windows 上引导 Bazel。

2.1. 安装先决条件

  • Bash

  • zip、unzip

  • C++ 构建工具链

  • JDK 。需要版本 21。

  • Python。需要版本 3。

例如，在 Ubuntu Linux 上，您可以使用以下命令安装这些要求： 

sudo apt-get install build-essential openjdk-21-jdk python3 zip unzip

2.2. 在 Unix 上引导 Bazel

  1. 打开 shell 或终端窗口。

  2. cd 进入您解压缩分发归档文件的目录。

  3. 运行编译脚本：env EXTRA_BAZEL_ARGS="--tool_java_runtime_version=local_jdk" bash ./compile.sh。

编译后的输出会放入 output/bazel 中。这是一个自包含的 Bazel 二进制文件，没有嵌入的 JDK。您可以将其复制到任何位置，也可以直接使用 。为方便起见，请将此二进制文件复制到 PATH 中的目录（例如 /usr/local/bin Linux 上的）。

如需以可重现的方式构建 bazel 二进制文件，请在“运行编译脚本”步骤中设置 SOURCE_DATE_EPOCH 。

第 2b 步：在 Windows 上引导 Bazel

如需了解类 Unix 系统的说明，请参阅 在 Ubuntu Linux、macOS 和其他类 Unix 系统上引导 Bazel。

2.1. 安装先决条件

2.2. 在 Windows 上引导 Bazel

  1. 打开 MSYS2 shell。

  2. 设置以下环境变量：

    • BAZEL_VS 或 BAZEL_VC（它们不 相同）：设置为 Visual Studio 目录 (BAZEL_VS) 或 Visual C++ 目录 (BAZEL_VC) 的 路径。设置其中一个即可。

    • BAZEL_SH：MSYS2 bash.exe 的路径。请参阅以下 示例中的命令。

      请勿将其设置为 C:\Windows\System32\bash.exe。（如果您安装了适用于 Linux 的 Windows 子系统，则拥有该文件 。）Bazel 不支持 此版本的 bash.exe。

    • PATH：添加 Python 目录。

    • JAVA_HOME：设置为 JDK 目录。

    示例 （使用 BAZEL_VS）：

    export BAZEL_VS="C:/Program Files (x86)/Microsoft Visual Studio/2017/BuildTools"
export BAZEL_SH="$(cygpath -m $(realpath $(which bash)))"
export PATH="/c/python27:$PATH"
export JAVA_HOME="C:/Program Files/Java/jdk-21"

    或（使用 BAZEL_VC）：

    export BAZEL_VC="C:/Program Files (x86)/Microsoft Visual Studio/2017/BuildTools/VC"
export BAZEL_SH="$(cygpath -m $(realpath $(which bash)))"
export PATH="/c/python27:$PATH"
export JAVA_HOME="C:/Program Files/Java/jdk-21"

  3. cd 进入您解压缩分发归档文件的目录。

  4. 运行编译脚本：env EXTRA_BAZEL_ARGS="--tool_java_runtime_version=local_jdk" ./compile.sh

编译后的输出会放入 output/bazel.exe 中。这是一个自包含的 Bazel 二进制文件，没有嵌入的 JDK。您可以将其复制到任何位置，也可以直接使用 。为方便起见，请将此二进制文件复制到 您的 PATH 中的目录。

如需以可重现的方式构建 bazel.exe 二进制文件，请在“运行编译脚本”步骤中设置 SOURCE_DATE_EPOCH 。

您无需从 MSYS2 shell 运行 Bazel。您可以从 命令提示符 (cmd.exe) 或 PowerShell 运行 Bazel。