macOS への Bazel のインストール

このページでは、macOS に Bazel をインストールして環境を設定する方法について説明します。

macOS に Bazel をインストールするには、次のいずれかの方法を使用します。

• 推奨: Bazelisk を使用する
• Homebrew を使用する
• バイナリ インストーラを使用する
• ソースから Bazel をコンパイルする

Bazel には、2 つの補完スクリプトが付属しています。Bazel をインストールすると、次のことができます。

• bash 補完スクリプトにアクセスする
• zsh 補完スクリプトをインストールします。

Homebrew を使用したインストール

ステップ 1: macOS に Homebrew をインストールする

Homebrew をインストールします（1 回限りの手順）。

/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_* ルールをサポートするには、iOS SDK 8.1 がシステムにインストールされた Xcode 6.1 以降が必要です。

Xcode を App Store または Apple Developer サイトからダウンロードします。

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 をご覧ください。

export PATH="PATH:HOME/bin"

bazel --version