macOS への Bazel のインストール

Nightly · 9.1 · 9.0 · 8.6 · 8.5 · 8.4 · 8.3 · 8.2 · 8.1

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

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

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

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_* ルールをサポートするには、Xcode 6.1 以降と iOS SDK 8.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 をご覧ください。

ステップ 4: 環境を設定する

上記のように --user フラグを指定して Bazel インストーラを実行すると、Bazel 実行可能ファイルが HOME/bin ディレクトリにインストールされます。 このディレクトリをデフォルト パスに追加することをおすすめします。手順は次のとおりです。

export PATH="PATH:HOME/bin"

このコマンドは、~/.bashrc、~/.zshrc、~/.profile ファイルに追加することもできます。

設定が完了しました。次のコマンドを実行して、Bazel が正常にインストールされたことを確認できます。

bazel --version

Bazel の新しいリリースに更新するには、目的のバージョンをダウンロードしてインストールします。