在 macOS 上安裝 Bazel

回報問題 查看來源 Nightly · 8.3 · 8.2 · 8.1 · 8.0 · 7.6

本頁說明如何在 macOS 上安裝 Bazel,並設定環境。

您可以使用下列其中一種方法,在 macOS 上安裝 Bazel:

Bazel 隨附兩個完成指令碼。安裝 Bazel 後,您可以執行下列操作:

使用 Homebrew 安裝

步驟 1:在 macOS 上安裝 Homebrew

安裝 Homebrew (只需執行一次):

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

步驟 2:透過 Homebrew 安裝 Bazel

透過 Homebrew 安裝 Bazel 套件,方法如下:

brew install bazel

一切就緒!執行下列指令,確認 Bazel 是否已成功安裝:

bazel --version

安裝完成後,您可以使用下列指令升級至新版 Bazel:

brew upgrade bazel

使用二進位安裝程式安裝

二進位安裝程式位於 Bazel 的 GitHub 版本頁面

安裝程式包含 Bazel 二進位檔。此外,您也必須安裝其他程式庫,Bazel 才能正常運作。

步驟 1:安裝 Xcode 指令列工具

如果您不打算使用 ios_* 規則,只要使用 xcode-select 安裝 Xcode 指令列工具套件即可:

xcode-select --install

否則,如要支援 ios_* 規則,系統必須安裝 Xcode 6.1 以上版本和 iOS SDK 8.1。

App StoreApple 開發人員網站下載 Xcode。

安裝 Xcode 後,請執行下列指令,為所有使用者接受授權合約:

sudo xcodebuild -license accept

步驟 2:下載 Bazel 安裝程式

接著,從 GitHub 的 Bazel 版本頁面下載名為 bazel-<version>-installer-darwin-x86_64.sh 的 Bazel 二進位安裝程式。

在 macOS Catalina 以上版本 (macOS >= 11),由於 Apple 的新應用程式簽署規定,您需要使用 curl 從終端機下載安裝程式,並將版本變數替換為要下載的 Bazel 版本:

export BAZEL_VERSION=5.2.0
curl -fLO "https://github.com/bazelbuild/bazel/releases/download/$BAZEL_VERSION/bazel-$BAZEL_VERSION-installer-darwin-x86_64.sh"

在 macOS 發布流程支援簽署功能前,這項做法是暫時的替代方案 (#9304)。

步驟 3:執行安裝程式

執行 Bazel 安裝程式,如下所示:

chmod +x "bazel-$BAZEL_VERSION-installer-darwin-x86_64.sh"
./bazel-$BAZEL_VERSION-installer-darwin-x86_64.sh --user

--user 標記會將 Bazel 安裝至系統的 $HOME/bin 目錄,並將 .bazelrc 路徑設為 $HOME/.bazelrc。使用 --help 指令查看其他安裝選項。

如果使用 macOS Catalina 以上版本 (macOS >= 11),並收到「無法開啟『bazel-real』,因為系統無法驗證開發人員」錯誤訊息,請使用 curl 從終端機重新下載安裝程式,做為暫時解決方法;請參閱上方的步驟 2。

步驟 4:設定環境

如果您使用上述 --user 標記執行 Bazel 安裝程式,Bazel 可執行檔會安裝在 HOME/bin 目錄中。建議您將這個目錄新增至預設路徑,方法如下:

export PATH="PATH:HOME/bin"

您也可以將這項指令新增至 ~/.bashrc~/.zshrc~/.profile 檔案。

一切就緒!執行下列指令,確認 Bazel 是否已成功安裝:

bazel --version

如要更新為較新版本的 Bazel,請下載並安裝所需版本。