在 macOS 上安裝 Bazel

回報問題 查看來源

本頁面說明如何在 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 Store 或 Apple Developers 網站下載 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” cannot beopened」錯誤，導致開發人員無法通過驗證，就需要使用 curl 從終端機重新下載安裝程式，詳情請參閱上方的步驟 2。

步驟 4：設定環境

如果您使用上述 --user 旗標執行 Bazel 安裝程式，則 Bazel 執行檔會安裝在 HOME/bin 目錄中。建議您將此目錄新增至預設路徑，如下所示：

export PATH="PATH:HOME/bin"

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

大功告成！如要確認 Bazel 安裝成功，請執行下列指令：

bazel --version

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