本页面介绍了如何在 macOS 上安装 Bazel 并设置环境。
您可以使用以下任一方法在 macOS 上安装 Bazel:
Bazel 附带两个补全脚本。安装 Bazel 后,您可以:
使用 Homebrew 安装
第 1 步:在 macOS 上安装 HomeBra
安装 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 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 版本,请下载并安装所需的版本。