本頁說明如何在 macOS 上安裝 Bazel,並設定環境。
您可以使用下列其中一種方法在 macOS 上安裝 Bazel:
Bazel 提供了兩個完成指令碼。安裝 Bazel 後,您可以執行下列操作:
- 存取 bash 完成指令碼
- 安裝 Zsh 完成指令碼
使用二進位檔安裝程式進行安裝
您可以在 Bazel 的 GitHub 版本頁面中找到二進位檔安裝程式。
安裝程式包含 Bazel 二進位檔。此外,您必須安裝某些額外的程式庫,Bazel 才能正常運作。
步驟 1:安裝 Xcode 指令列工具
如果您不想使用 ios_*
規則,只需使用 xcode-select
安裝 Xcode 指令列工具套件即可:
xcode-select --install
否則,如要支援 ios_*
規則,您必須在系統上安裝 Xcode 6.1 或以上版本,並安裝 iOS SDK 8.1。
從 App Store 或 Apple Developer 網站下載 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,請下載並安裝所需版本。
使用 Homebrew 進行安裝
步驟 1:在 macOS 上安裝 Homebrew
安裝 Homebrew (一次性步驟):
/bin/bash -c "$(curl -fsSL \
https://raw.githubusercontent.com/Homebrew/install/master/install.sh)"
步驟 2:透過 Homebrew 安裝 Bazel
透過 Homebrew 安裝 Bazel 套件,如下所示:
brew install bazel
大功告成!您可以執行下列指令,確認 Bazel 安裝成功:
bazel --version
安裝完成後,您可以使用以下指令升級至較新版本的 Bazel:
brew upgrade bazel