在 Ubuntu 上安装 Bazel

报告问题查看源代码每夜 build · 7.4 . 7.3 · 7.2 · 7.1 · 7.0 · 6.5

本页介绍了在 Ubuntu 上安装 Bazel 的选项。它还提供了指向 Bazel 补全脚本和二进制安装程序的链接，以便您在需要时将其用作备用选项（例如，如果您没有管理员访问权限）。

支持的 Ubuntu Linux 平台：

20.04（LTS）
18.04（LTS）

Bazel 应与其他 Ubuntu 版本和 Debian“stretch”及更高版本兼容，但尚未经过测试，无法保证一定能正常运行。

使用以下任一方法在 Ubuntu 上安装 Bazel：

建议：使用 Bazelisk
使用我们的自定义 APT 仓库
使用二进制安装程序
从源代码编译 Bazel

注意：对于基于 ARM 的系统，APT 代码库不包含 arm64 版本，也没有可用的二进制安装程序。使用 Bazelisk 或从源代码进行编译。

Bazel 带有两个完成脚本。安装 Bazel 后，您可以执行以下操作：

访问 bash 补全脚本
安装 zsh 补全脚本

第 1 步：将 Bazel 发行版 URI 添加为软件包源

使用 Bazel 的 apt 代码库

注意：这是一次性设置步骤。

sudo apt install apt-transport-https curl gnupg
curl -fsSL https://bazel.build/bazel-release.pub.gpg | gpg --dearmor >bazel-archive-keyring.gpg
sudo mv bazel-archive-keyring.gpg /usr/share/keyrings
echo "deb [arch=amd64 signed-by=/usr/share/keyrings/bazel-archive-keyring.gpg] https://storage.googleapis.com/bazel-apt stable jdk1.8" | sudo tee /etc/apt/sources.list.d/bazel.list

仅出于旧版原因保留组件名称“jdk1.8”，与支持或包含的 JDK 版本无关。Bazel 版本与 Java 版本无关。更改“jdk1.8”组件名称会破坏代码库的现有用户。

第 2 步：安装并更新 Bazel

sudo apt update && sudo apt install bazel

安装完成后，您可以通过常规系统更新升级到较新版本的 Bazel：

sudo apt update && sudo apt full-upgrade

bazel 软件包始终会安装最新的稳定版 Bazel。除了最新版本之外，您还可以安装特定的旧版 Bazel，例如：

sudo apt install bazel-1.0.0

这会将 Bazel 1.0.0 作为 /usr/bin/bazel-1.0.0 安装到您的系统上。如果您需要使用特定版本的 Bazel 构建项目（例如，因为它使用 .bazelversion 文件明确说明应使用哪个 Bazel 版本进行构建），这可能会很有用。

（可选）您可以通过创建符号链接将 bazel 设置为特定版本：

sudo ln -s /usr/bin/bazel-1.0.0 /usr/bin/bazel
bazel --version  # 1.0.0

第 3 步：安装 JDK（可选）

Bazel 将捆绑的专用 JRE 作为其运行时，因此您无需安装任何特定版本的 Java。

不过，如果您想使用 Bazel 构建 Java 代码，则必须安装 JDK。

# Ubuntu 16.04 (LTS) uses OpenJDK 8 by default:
sudo apt install openjdk-8-jdk
# Ubuntu 18.04 (LTS) uses OpenJDK 11 by default:
sudo apt install openjdk-11-jdk

使用二进制安装程序

通常，您应使用 apt 软件包库，但如果您没有机器上的管理员权限或无法添加自定义软件包库，二进制安装程序会很有用。

二进制安装程序可从 Bazel 的 GitHub 版本页面下载。

安装程序包含 Bazel 二进制文件，并将其提取到 $HOME/bin 文件夹中。您必须手动安装一些额外的库，Bazel 才能正常运行。

第 1 步：安装所需的软件包

Bazel 需要 C++ 编译器和 unzip / zip 才能正常运行：

sudo apt install g++ unzip zip

如果您想使用 Bazel 构建 Java 代码，请安装 JDK：

# Ubuntu 16.04 (LTS) uses OpenJDK 8 by default:
sudo apt-get install openjdk-8-jdk
# Ubuntu 18.04 (LTS) uses OpenJDK 11 by default:
sudo apt-get install openjdk-11-jdk

第 2 步：运行安装程序

接下来，从 GitHub 上的 Bazel 版本页面下载名为 bazel-version-installer-linux-x86_64.sh 的 Bazel 二进制安装程序。

按如下方式运行该脚本：

chmod +x bazel-version-installer-linux-x86_64.sh
./bazel-version-installer-linux-x86_64.sh --user

--user 标志会将 Bazel 安装到您系统上的 $HOME/bin 目录，并将 .bazelrc 路径设置为 $HOME/.bazelrc。使用 --help 命令查看其他安装选项。

第 3 步：设置环境

如果您按上述方法运行了带有 --user 标志的 Bazel 安装程序，则 Bazel 可执行文件将安装到 $HOME/bin 目录中。建议您将此目录添加到默认路径，如下所示：

export PATH="$PATH:$HOME/bin"

您还可以将此命令添加到 ~/.bashrc 或 ~/.zshrc 文件中，使其永久有效。