在 Ubuntu 上安裝 Bazel

回報問題 查看來源

本頁說明在 Ubuntu 上安裝 Bazel 選項。 如有備用選項 (例如您沒有管理員存取權),也提供 Bazel 完成指令碼和二進位安裝程式的連結。

支援的 Ubuntu Linux 平台:

  • 22.04 (LTS)
  • 20.04 (LTS)
  • 18.04 (LTS)

Bazel 應與其他 Ubuntu 版本和 Debian「延展」 以上版本相容,但未經測試且不保證能夠正常運作。

使用下列其中一種方法在 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

這樣做會在系統中安裝 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。

sudo apt install default-jdk

使用二進位檔安裝程式

一般來說,您應該使用 apt 存放區,但如果您沒有電腦的管理員權限,或無法新增自訂存放區,則二進位安裝程式相當實用。

您可以從 Bazel 的 GitHub 版本頁面下載二進位安裝程式。

安裝程式包含 Bazel 二進位檔,並解壓縮至您的 $HOME/bin 資料夾。有些額外程式庫必須手動安裝才能讓 Bazel 正常運作。

步驟 1:安裝必要的套件

Bazel 需要 C++ 編譯器和解壓縮 / 壓縮才能運作:

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 安裝程式,系統會在 $HOME/bin 目錄中安裝 Bazel 執行檔。建議您將這個目錄新增至預設路徑,如下所示:

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

您也可以將這項指令新增至 ~/.bashrc~/.zshrc 檔案,讓檔案可以永久使用。

使用 Bazel Docker 容器

我們會在 gcr.io/bazel-public/bazel 中為每個 Bazel 版本安裝 Docker 容器並安裝 Bazel。您可以按照下列方式使用 Docker 容器:

$ docker pull gcr.io/bazel-public/bazel:<bazel version>

Docker 容器是透過這些步驟建構。