ソースから Bazel をコンパイルする

問題を報告する ソースを表示 ナイトリー · 7.4 . 7.3 · 7.2 · 7.1 · 7.0 · 6.5

このページでは、ソースから Bazel をインストールする方法と、一般的な問題のトラブルシューティングのヒントについて説明します。

ソースから Bazel をビルドするには、次のいずれかを行います。

Bazel を使用して Bazel をビルドする

概要

  1. GitHub リリース ページから、または Bazelisk を使用して、最新の Bazel リリースを入手します。

  2. GitHub から Bazel のソースをダウンロードして、どこかに展開します。または、https://github.com/bazelbuild/bazel からソースツリーの git クローンを作成することもできます。

  3. ブートストラップの場合と同じ前提条件をインストールします(UNIX のようなシステムの場合またはWindows の場合をご覧ください)。

  4. Bazel: bazel build //src:bazel-dev(Windows では bazel build //src:bazel-dev.exe)を使用して Bazel のデベロッパー ビルドをビルドします。

  5. 生成されたバイナリは 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 を実行します。

それ以外の場合は以下のとおりです。

  1. 最新のソースを ZIP ファイルとしてダウンロードします。

  2. コンテンツをどこかに抽出します。

    たとえば、ホーム ディレクトリの下に bazel-src ディレクトリを作成し、そこに展開します。

ステップ 3: 前提条件をインストールする

ブートストラップ(下記を参照)と同じ前提条件(JDK、C++ コンパイラ、MSYS2(Windows でビルドする場合)など)をインストールします。

ステップ 4a: Ubuntu Linux、macOS、その他の Unix 系システムで Bazel をビルドする

Windows の手順については、Windows で Bazel をビルドするをご覧ください。

目標: Bazel を実行して、カスタム Bazel バイナリ(bazel-bin/src/bazel-dev)をビルドします。

手順:

  1. Bash ターミナルを起動する

  2. cd を実行して、Bazel のソースを抽出(またはクローンを作成)したディレクトリに移動します。

    たとえば、ソースをホーム ディレクトリに展開した場合は、次のコマンドを実行します。

    cd ~/bazel-src
    
  3. ソースから Bazel をビルドします。

    bazel build //src:bazel-dev
    

    または、bazel build //src:bazel --compilation_mode=opt を実行して小さいバイナリを生成することもできますが、ビルド速度は遅くなります。

    --stamp --embed_label=X.Y.Z フラグを使用してビルドし、バイナリの Bazel バージョンを埋め込むと、bazel --version が指定されたバージョンを出力します。

  4. 出力は 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)をビルドします。

手順:

  1. コマンド プロンプトを起動します([スタート] メニュー > [ファイル名を指定して実行] > [cmd.exe])。

  2. cd を実行して、Bazel のソースを抽出(またはクローンを作成)したディレクトリに移動します。

    たとえば、ソースをホーム ディレクトリに展開した場合は、次のコマンドを実行します。

    cd %USERPROFILE%\bazel-src
    
  3. ソースから Bazel をビルドします。

    bazel build //src:bazel-dev.exe

    または、bazel build //src:bazel.exe --compilation_mode=opt を実行して小さいバイナリを生成することもできますが、ビルド速度が遅くなります。

    --stamp --embed_label=X.Y.Z フラグを使用してビルドし、バイナリの Bazel バージョンを埋め込むと、bazel --version が指定されたバージョンを出力します。

  4. 出力は bazel-bin\src\bazel-dev.exe(または bazel-bin\src\bazel.exe)にあります。

ステップ 5: ビルドされたバイナリをインストールする

実際には、インストールする必要はありません。

前のステップの出力は、自己完結型の Bazel バイナリです。任意のディレクトリにコピーしてすぐに使用できます。(このディレクトリが PATH にあると、どこでも「bazel」を実行できるため便利です)。


Bazel をゼロからビルドする(ブートストラップ)

既存の Bazel バイナリを使用せずに、Bazel をゼロからビルドすることもできます。

ステップ 1: Bazel のソース(ディストリビューション アーカイブ)をダウンロードする

(この手順はすべてのプラットフォームで同じです)。

  1. bazel-0.28.1-dist.zip など、GitHub から bazel-<version>-dist.zip をダウンロードします。

    注意:

    • アーキテクチャに依存しない単一のディストリビューション アーカイブがあります。アーキテクチャ固有または OS 固有のディストリビューション アーカイブはありません。
    • これらのソースは GitHub ソースツリーと同じではありません。ディストリビューション アーカイブを使用して Bazel を起動する必要があります。GitHub からクローンを作成したソースツリーは使用できません。(ディストリビューション アーカイブには、ブートストラップに必要な生成されたソースファイルが含まれています。これは通常の Git ソースツリーの一部ではありません)。
  2. ディスクのどこかにディストリビューション アーカイブを解凍します。

    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 をブートストラップする

  1. シェルまたはターミナル ウィンドウを開きます。

  2. cd は、ディストリビューション アーカイブを解凍したディレクトリに置き換えます。

  3. コンパイル スクリプト 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. 前提条件をインストールする

  • MSYS2 シェル

  • 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 をブートストラップする

  1. MSYS2 シェルを開きます。

  2. 次の環境変数を設定します。

    • BAZEL_VS または BAZEL_VC(同じではない): Visual Studio ディレクトリ(BAZEL_VS)または Visual C++ ディレクトリ(BAZEL_VC)のパスに設定します。いずれか 1 つを設定すれば十分です。
    • BAZEL_SH: MSYS2 bash.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"
    
  3. cd は、ディストリビューション アーカイブを解凍したディレクトリに置き換えます。

  4. コンパイル スクリプト 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 から実行できます。