macOS に Bazel をインストールする

問題を報告する ソースを表示

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

Bazel は、次のいずれかの方法で macOS にインストールできます。

Bazel には完了スクリプトが 2 つ用意されています。Bazel をインストールすると、次のことが可能になります。

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

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

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 以降がインストールされている必要があります。

App Store または Apple デベロッパー サイトから 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 フラグを指定すると、システムの $HOME/bin ディレクトリに Bazel がインストールされ、.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 の新しいリリースに更新するには、目的のバージョンをダウンロードしてインストールします。