相约 2023 年 BazelCon 将于 10 月 24 日至 25 日在 Google 慕尼黑举办!报名现已开放! 了解详情

在 macOS 上安装 Bazel

报告问题 查看源代码

本页面介绍如何在 macOS 上安装 Bazel 和设置环境。

您可以使用以下方法之一在 macOS 上安装 Bazel:

Bazel 有两个完成脚本。安装 Bazel 后,您可以:

使用 Home 媒体资源安装

第 1 步:在 macOS 上安装 Home 媒体资源

安装 Homerew(一次性步骤):

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

第 2 步:通过 Homerew 安装 Bazel

按照以下步骤通过 Homerew 安装 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_* 规则,您必须在系统上安装 iOS 8.1 Xcode 6.1 或更高版本。

App StoreApple 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,请下载并安装所需的版本。