在Ubuntu上安装Bazel

支持的Ubuntu Linux平台：

• 18.04 (LTS)
• 16.04 (LTS)

Bazel可能会在其他Ubuntu版本和Debian stretch及以上版本上正常运行，但是我们目前尚未在Bazel的CI上对其进行测试，因此无法保证。

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

• 使用Bazelisk（推荐）
• 使用我们的自定义APT存储库
• 使用二进制安装程序
• 从源代码编译Bazel

Bazel带有两个补全脚本。安装Bazel之后，您可以：

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

1 使用Bazel的apt存储库

1.1 将Bazel发行版URI添加为包源

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

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

组件名称“jdk1.8”仅出于遗留原因而保留，不再与受支持或包含的JDK版本相关。过去，当Bazel尚未捆绑私有JRE时，我们有两个发行版本，一个与JDK 7兼容，另一个与JDK 8兼容。但是，由于我们放弃了对Java 7的支持并开始捆绑私有运行时，因此Bazel发行版与Java版本无关。但是，更改“ jdk1.8”组件名称将破坏存储库的现有用户。

1.2 安装和更新Bazel

sudo apt update && sudo apt install bazel

安装完成后，您可以在常规系统更新中升级到更高版本的Bazel：

sudo apt update && sudo apt full-upgrade

bazel软件包将始终安装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

1.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

2 使用二进制安装程序

虽然我们通常建议使用apt储存库，但是如果您对计算机没有管理员权限或无法添加自定义储存库，则二进制安装程序会很有用。

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

安装程序包含Bazel二进制文件并将其解压缩到$HOME/bin文件夹中。必须手动安装一些其他库，Bazel才能工作。

2.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.2 运行安装程序

接下来，从GitHub上的Bazel releases页面下载名为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命令查看其他安装选项。

2.3 设置环境

如果使用上面的--user标志运行Bazel安装程序，Bazel可执行文件将安装在$HOME/bin目录中。最好将此目录添加到默认路径，如下所示：

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

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