このページでは、macOS に Bazel をインストールして環境を設定する方法について説明します。
macOS に 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 以降がシステムにインストールされている必要があります。
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
フラグは、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 の新しいリリースに更新するには、目的のバージョンをダウンロードしてインストールします。