このページでは、ソースから Bazel をインストールする方法と、一般的な問題のトラブルシューティングのヒントについて説明します。
ソースから Bazel をビルドするには、次のいずれかを行います。
既存の Bazel バイナリなしでビルドします。これは、ブートストラップと呼ばれます。
Bazel を使用して Bazel をビルドする
概要
GitHub リリース ページから、または Bazelisk を使用して、最新の Bazel リリースを入手します。
GitHub から Bazel のソースをダウンロードして、どこかに展開します。または、https://github.com/bazelbuild/bazel からソースツリーの git クローンを作成することもできます。
ブートストラップの場合と同じ前提条件をインストールします(UNIX のようなシステムの場合またはWindows の場合をご覧ください)。
Bazel:
bazel build //src:bazel-dev
(Windows ではbazel build //src:bazel-dev.exe
)を使用して Bazel のデベロッパー ビルドをビルドします。生成されたバイナリは
bazel-bin/src/bazel-dev
(Windows の場合はbazel-bin\src\bazel-dev.exe
)にあります。任意の場所にコピーして、追加のインストールなしですぐに使用できます。
詳しい手順については後述します。
ステップ 1: 最新の Bazel リリースを入手する
目標: Bazel のリリース バージョンをインストールまたはダウンロードします。ターミナルで bazel
と入力して、実行できることを確認します。
理由: GitHub ソースツリーから Bazel をビルドするには、既存の Bazel バイナリが必要です。パッケージ マネージャーからインストールするか、GitHub からダウンロードできます。Bazel のインストールをご覧ください。(または、スクラッチからビルド(ブートストラップ)することもできます)。
トラブルシューティング:
端末で
bazel
と入力して Bazel を実行できない場合:Bazel バイナリのディレクトリが PATH に含まれていない可能性があります。
これは大きな問題ではありません。
bazel
ではなく、フルパスを入力する必要があります。Bazel バイナリ自体が
bazel
(Unix の場合)またはbazel.exe
(Windows の場合)と呼ばれていない可能性があります。これは大きな問題ではありません。バイナリの名前を変更するか、
bazel
の代わりにバイナリの名前を入力します。バイナリが実行可能ではない(Unix の場合)。
chmod +x /path/to/bazel
を実行して、バイナリを実行可能にする必要があります。
ステップ 2: GitHub から Bazel のソースをダウンロードする
Git に精通している場合は、git clone https://github.com/bazelbuild/bazel を実行します。
それ以外の場合は以下のとおりです。
コンテンツをどこかに抽出します。
たとえば、ホーム ディレクトリの下に
bazel-src
ディレクトリを作成し、そこに展開します。
ステップ 3: 前提条件をインストールする
ブートストラップ(下記を参照)と同じ前提条件(JDK、C++ コンパイラ、MSYS2(Windows でビルドする場合)など)をインストールします。
ステップ 4a: Ubuntu Linux、macOS、その他の Unix 系システムで Bazel をビルドする
Windows の手順については、Windows で Bazel をビルドするをご覧ください。
目標: Bazel を実行して、カスタム Bazel バイナリ(bazel-bin/src/bazel-dev
)をビルドします。
手順:
Bash ターミナルを起動する
cd
を実行して、Bazel のソースを抽出(またはクローンを作成)したディレクトリに移動します。たとえば、ソースをホーム ディレクトリに展開した場合は、次のコマンドを実行します。
cd ~/bazel-src
ソースから Bazel をビルドします。
bazel build //src:bazel-dev
または、
bazel build //src:bazel --compilation_mode=opt
を実行して小さいバイナリを生成することもできますが、ビルド速度は遅くなります。--stamp --embed_label=X.Y.Z
フラグを使用してビルドし、バイナリの Bazel バージョンを埋め込むと、bazel --version
が指定されたバージョンを出力します。出力は
bazel-bin/src/bazel-dev
(またはbazel-bin/src/bazel
)になります。
ステップ 4b: Windows で Bazel をビルドする
Unix ライクなシステムの手順については、Ubuntu Linux、macOS、その他の Unix ライクなシステムをご覧ください。
目標: Bazel を実行して、カスタム Bazel バイナリ(bazel-bin\src\bazel-dev.exe
)をビルドします。
手順:
コマンド プロンプトを起動します([スタート] メニュー > [ファイル名を指定して実行] > [cmd.exe])。
cd
を実行して、Bazel のソースを抽出(またはクローンを作成)したディレクトリに移動します。たとえば、ソースをホーム ディレクトリに展開した場合は、次のコマンドを実行します。
cd %USERPROFILE%\bazel-src
ソースから Bazel をビルドします。
bazel build //src:bazel-dev.exe
または、
bazel build //src:bazel.exe --compilation_mode=opt
を実行して小さいバイナリを生成することもできますが、ビルド速度が遅くなります。--stamp --embed_label=X.Y.Z
フラグを使用してビルドし、バイナリの Bazel バージョンを埋め込むと、bazel --version
が指定されたバージョンを出力します。出力は
bazel-bin\src\bazel-dev.exe
(またはbazel-bin\src\bazel.exe
)にあります。
ステップ 5: ビルドされたバイナリをインストールする
実際には、インストールする必要はありません。
前のステップの出力は、自己完結型の Bazel バイナリです。任意のディレクトリにコピーしてすぐに使用できます。(このディレクトリが PATH にあると、どこでも「bazel」を実行できるため便利です)。
Bazel をゼロからビルドする(ブートストラップ)
既存の Bazel バイナリを使用せずに、Bazel をゼロからビルドすることもできます。
ステップ 1: Bazel のソース(ディストリビューション アーカイブ)をダウンロードする
(この手順はすべてのプラットフォームで同じです)。
bazel-0.28.1-dist.zip
など、GitHub からbazel-<version>-dist.zip
をダウンロードします。注意:
- アーキテクチャに依存しない単一のディストリビューション アーカイブがあります。アーキテクチャ固有または OS 固有のディストリビューション アーカイブはありません。
- これらのソースは GitHub ソースツリーと同じではありません。ディストリビューション アーカイブを使用して Bazel を起動する必要があります。GitHub からクローンを作成したソースツリーは使用できません。(ディストリビューション アーカイブには、ブートストラップに必要な生成されたソースファイルが含まれています。これは通常の Git ソースツリーの一部ではありません)。
ディスクのどこかにディストリビューション アーカイブを解凍します。
Bazel のリリースキー 3D5919B448457EE0 によって作成された署名を確認する必要があります。
ステップ 2a: Ubuntu Linux、macOS、その他の Unix 系システムで Bazel をブートストラップする
Windows の手順については、Windows で Bazel を起動するをご覧ください。
2.1. 前提条件をインストールする
Bash
zip、unzip
C++ ビルド ツールチェーン
JDK。バージョン 21 が必要です。
Python。バージョン 2 と 3 がサポートされています。どちらか一方をインストールすれば十分です。
たとえば、Ubuntu Linux では、次のコマンドを使用してこれらの要件をインストールできます。
sudo apt-get install build-essential openjdk-21-jdk python zip unzip
2.2. Unix で Bazel をブートストラップする
シェルまたはターミナル ウィンドウを開きます。
cd
は、ディストリビューション アーカイブを解凍したディレクトリに置き換えます。コンパイル スクリプト
env EXTRA_BAZEL_ARGS="--tool_java_runtime_version=local_jdk" bash ./compile.sh
を実行します。
コンパイルされた出力は output/bazel
に配置されます。これは、JDK が埋め込まれていない自己完結型の Bazel バイナリです。任意の場所にコピーすることも、その場で使用することもできます。便宜上、このバイナリを PATH
にあるディレクトリ(Linux では /usr/local/bin
など)にコピーします。
bazel
バイナリを再現可能な方法でビルドするには、「コンパイル スクリプトを実行する」ステップで SOURCE_DATE_EPOCH
も設定します。
ステップ 2b: Windows で Bazel をブートストラップする
Unix ライクなシステムの手順については、Ubuntu Linux、macOS、その他の Unix ライクなシステムで Bazel を起動するをご覧ください。
2.1. 前提条件をインストールする
zip と unzip 用の MSYS2 パッケージ。MSYS2 シェルで次のコマンドを実行します。
pacman -S zip unzip patch
Visual C++ コンパイラ。Visual C++ コンパイラを Visual Studio 2015 以降の一部としてインストールするか、最新の Visual Studio 2017 用 Build Tools をインストールします。
JDK。バージョン 21 が必要です。
Python。バージョン 2 と 3 がサポートされています。どちらか一方をインストールすれば十分です。Windows ネイティブ バージョン(https://www.python.org からダウンロード可能)が必要です。MSYS2 で pacman を使用してインストールされたバージョンは機能しません。
2.2. Windows で Bazel をブートストラップする
MSYS2 シェルを開きます。
次の環境変数を設定します。
BAZEL_VS
またはBAZEL_VC
(同じではない): Visual Studio ディレクトリ(BAZEL_VS)または Visual C++ ディレクトリ(BAZEL_VC)のパスに設定します。いずれか 1 つを設定すれば十分です。BAZEL_SH
: MSYS2bash.exe
のパス。以下の例のコマンドをご覧ください。C:\Windows\System32\bash.exe
に設定しないでください。(Windows Subsystem for Linux をインストールした場合は、このファイルがあります)。Bazel はこのバージョンのbash.exe
をサポートしていません。PATH
: Python ディレクトリを追加します。JAVA_HOME
: JDK ディレクトリに設定します。
例(BAZEL_VS を使用):
export BAZEL_VS="C:/Program Files (x86)/Microsoft Visual Studio/2017/BuildTools" export BAZEL_SH="$(cygpath -m $(realpath $(which bash)))" export PATH="/c/python27:$PATH" export JAVA_HOME="C:/Program Files/Java/jdk-21"
または(BAZEL_VC を使用):
export BAZEL_VC="C:/Program Files (x86)/Microsoft Visual Studio/2017/BuildTools/VC" export BAZEL_SH="$(cygpath -m $(realpath $(which bash)))" export PATH="/c/python27:$PATH" export JAVA_HOME="C:/Program Files/Java/jdk-21"
cd
は、ディストリビューション アーカイブを解凍したディレクトリに置き換えます。コンパイル スクリプト
env EXTRA_BAZEL_ARGS="--tool_java_runtime_version=local_jdk" ./compile.sh
を実行します。
コンパイルされた出力は output/bazel.exe
に配置されます。これは、JDK が埋め込まれていない自己完結型の Bazel バイナリです。任意の場所にコピーすることも、その場で使用することもできます。利便性を考えて、このバイナリを PATH
にあるディレクトリにコピーします。
bazel.exe
バイナリを再現可能な方法でビルドするには、「コンパイル スクリプトを実行する」ステップで SOURCE_DATE_EPOCH
も設定します。
MSYS2 シェルから Bazel を実行する必要はありません。Bazel は、コマンド プロンプト(cmd.exe
)または PowerShell から実行できます。