本页面介绍了在 Ubuntu 上安装 Bazel 的方法。此外,它还会提供 Bazel 完成脚本和二进制文件安装程序的链接,前提是您将其作为备份选项使用(例如,如果您没有管理员访问权限)。
支持的 Ubuntu Linux 平台:
- 22.04 (LTS)
- 20.04 (LTS)
- 18.04 (LTS)
Bazel 应该兼容其他 Ubuntu 版本和 Debian“Strett”及更高版本,但未经测试,也无法保证能够正常运行。
使用以下方法之一在 Ubuntu 上安装 Bazel:
注意:对于基于 ARM 的系统,APT 代码库不包含 arm64
版本,并且没有可用的二进制安装程序。请使用 Bazelisk 或从源代码进行编译。
Bazel 附带两个完成脚本。安装 Bazel 后,您可以:
使用 Bazel 的 apt 代码库
第 1 步:将 Bazel 分发 URI 添加为软件包来源
注意:此步骤只需执行一次设置步骤,
sudo apt install apt-transport-https curl gnupg -y
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
这会在系统上安装 /usr/bin/bazel-1.0.0
作为 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。
sudo apt install default-jdk
使用二进制安装程序
通常,您应该使用 apt 代码库,但如果您对机器没有管理员权限或无法添加自定义代码库,则二进制安装程序会很有用。
您可以从 Bazel 的 GitHub 版本页面下载二进制安装程序。
安装程序包含 Bazel 二进制文件,并将其解压缩到 $HOME/bin
文件夹中。您需要手动安装一些其他库,Bazel 才能正常运行。
第 1 步:安装所需的软件包
Bazel 需要一个 C++ 编译器和 unzip / zip 文件才能正常运行:
sudo apt install g++ unzip zip
如果要使用 Bazel 构建 Java 代码,请安装 JDK:
sudo apt-get install default-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
文件使其永久保留。
使用 Bazel Docker 容器
我们在 gcr.io/bazel-public/bazel
发布为每个 Bazel 版本安装了 Bazel 的 Docker 容器。您可以按如下方式使用 Docker 容器:
$ docker pull gcr.io/bazel-public/bazel:<bazel version>
Docker 容器通过这些步骤构建。