Windows での Bazel の使用

このページでは、Windows で Bazel を使用するためのベスト プラクティスについて説明します。インストール手順については、Windows に Bazel をインストールするをご覧ください。

既知の問題

Windows 関連の Bazel の問題には、GitHub で「team-Windows」ラベルが付けられています。未解決の問題については、こちらをご覧ください。

ベスト プラクティス

長いパスの問題を回避する

一部のツール（MSVC コンパイラなど）には、Windows での最大パス長の制限があります。この問題を回避するには、--output_user_root フラグを使用して、Bazel の短い出力ディレクトリを指定します。

たとえば、bazelrc ファイルに次の行を追加します。

startup --output_user_root=C:/tmp

8.3 形式のファイル名のサポートを有効にする

Bazel は、長いファイルパスの短い名前バージョンを作成しようとします。ただし、これを行うには、長いパスのファイルが存在するボリュームで 8.3 ファイル名のサポートを有効にする必要があります。次のコマンドを実行すると、すべてのボリュームで 8.3 名の作成を有効にできます。

fsutil 8dot3name set 0

シンボリック リンクのサポートを有効にする

一部の機能では、Windows で Bazel がファイル シンボリック リンクを作成できる必要があります。これには、デベロッパー モード（Windows 10 バージョン 1703 以降）を有効にするか、Bazel を管理者として実行します。これにより、次の機能が有効になります。

• --windows_enable_symlinks
• --enable_runfiles

簡単に実行できるように、bazelrc ファイルに次の行を追加します。

startup --windows_enable_symlinks
build --enable_runfiles

注: Windows でのシンボリック リンクの作成は負荷の高いオペレーションです。--enable_runfiles フラグを使用すると、大量のファイル シンボリック リンクが作成される可能性があります。この機能は、必要な場合にのみ有効にしてください。

Bazel の実行: MSYS2 シェル、コマンド プロンプト、PowerShell

推奨事項: コマンド プロンプト（cmd.exe）または PowerShell から Bazel を実行します。

2020 年 1 月 15 日現在、bash から Bazel を実行しないでください。MSYS2 シェル、Git Bash、Cygwin、その他の Bash バリアントのいずれからでも実行しないでください。Bazel はほとんどのユースケースで動作しますが、MSYS2 から Ctrl+C でビルドを中断するなど、一部の機能が動作しません。また、MSYS2 で実行する場合は、MSYS2 の自動パス変換を無効にする必要があります。無効にしないと、MSYS が Unix パス（//foo:bar など）のように見えるコマンドライン引数を Windows パスに変換します。詳しくは、こちらの StackOverflow の回答をご覧ください。

Bash（MSYS2）を使用せずに Bazel を使用する

Bash を使用しない bazel ビルド

1.0 より前の Bazel バージョンでは、一部のルールをビルドするために Bash が必要でした。

Bazel 1.0 以降では、次のいずれかでない限り、Bash なしで任意のルールをビルドできます。

• genrule。genrules は Bash コマンドを実行するため
• sh_binary ルールまたは sh_test ルール。これらは本質的に Bash を必要とするため
• ctx.actions.run_shell() または ctx.resolve_command() を使用する Starlark ルール

ただし、genrule は、ファイルのコピーやテキスト ファイルの書き込みなどの簡単なタスクによく使用されます。genrule を使用する代わりに（Bash によっては）、bazel-skylib リポジトリで適切なルールが見つかる場合があります。Windows でビルドする場合、これらのルールに Bash は必要ありません。

Bash を使用しない bazel テスト

1.0 より前のバージョンの Bazel では、bazel test を実行するために Bash が必要でした。

Bazel 1.0 以降では、次の場合を除き、Bash なしで任意のルールをテストできます。

• --run_under を使用する場合
• テストルール自体に Bash が必要（実行可能ファイルがシェル スクリプトであるため）

Bash なしで bazel run を使用する

1.0 より前のバージョンの Bazel では、bazel run を実行するために Bash が必要でした。

Bazel 1.0 以降では、次の場合を除き、Bash なしで任意のルールを実行できます。

• --run_under または --script_path を使用する場合
• テストルール自体に Bash が必要（実行可能ファイルがシェル スクリプトであるため）

shバイナリと sh* ルール、および Bash なしの ctx.actions.run_shell() を使用する

sh_* ルールをビルドしてテストし、ctx.actions.run_shell() と ctx.resolve_command() を使用する Starlark ルールをビルドしてテストするには、Bash が必要です。これは、プロジェクト内のルールだけでなく、プロジェクトが依存する（推移的にも）外部リポジトリ内のルールにも適用されます。

今後、Linux 用 Windows サブシステム（WSL）を使用してこれらのルールをビルドするオプションが提供される可能性がありますが、現在のところ、Bazel-on-Windows サブチームの優先事項ではありません。

環境変数の設定

Windows コマンド プロンプト（cmd.exe）で設定した環境変数は、そのコマンド プロンプト セッションでのみ設定されます。新しい cmd.exe を開始するたびに、変数の設定を行う必要があります。cmd.exe の起動時に常に変数を設定するには、[Control Panel > System Properties > Advanced > Environment Variables...] ダイアログ ボックスの [ユーザー変数] または [システム変数] に変数を追加します。

Windows でビルドする

MSVC で C++ をビルドする

MSVC で C++ ターゲットをビルドするには、次のものが必要です。

• Visual C++ コンパイラ。

• （省略可）BAZEL_VC と BAZEL_VC_FULL_VERSION 環境変数。

  Bazel は、システム上の Visual C++ コンパイラを自動的に検出します。特定の VC インストールを使用するように Bazel に指示するには、次の環境変数を設定します。

  Visual Studio 2017 と 2019 の場合は、BAZEL_VC のいずれか 1 つを設定します。また、BAZEL_VC_FULL_VERSION を設定することもできます。

  • BAZEL_VC Visual C++ Build Tools のインストール ディレクトリ

    set BAZEL_VC=C:\Program Files (x86)\Microsoft Visual Studio\2017\BuildTools\VC
    

  • BAZEL_VC_FULL_VERSION（省略可）Visual Studio 2017 および 2019 の場合のみ、Visual C++ Build Tools の完全なバージョン番号。複数のバージョンがインストールされている場合は、BAZEL_VC_FULL_VERSION で Visual C++ Build Tools の正確なバージョンを選択できます。それ以外の場合は、Bazel が最新バージョンを選択します。

    set BAZEL_VC_FULL_VERSION=14.16.27023
    

  Visual Studio 2015 以前の場合は、BAZEL_VC を設定します。（BAZEL_VC_FULL_VERSION はサポートされていません。）

  • BAZEL_VC Visual C++ Build Tools のインストール ディレクトリ

    set BAZEL_VC=C:\Program Files (x86)\Microsoft Visual Studio 14.0\VC
    

• Windows SDK。

  Windows SDK には、Bazel 自体を含め、Windows アプリケーションのビルドに必要なヘッダー ファイルとライブラリが含まれています。デフォルトでは、インストールされている最新の Windows SDK が使用されます。BAZEL_WINSDK_FULL_VERSION を設定して Windows SDK バージョンを指定することもできます。10.0.10240.0 などの Windows 10 SDK の完全な番号を使用するか、8.1 を指定して Windows 8.1 SDK を使用できます（Windows 8.1 SDK のバージョンは 1 つのみです）。指定された Windows SDK がインストールされていることを確認してください。

  要件: これは VC 2017 と 2019 でサポートされています。スタンドアロンの VC 2015 ビルドツールは Windows SDK の選択をサポートしていません。完全な Visual Studio 2015 のインストールが必要です。そうしないと、BAZEL_WINSDK_FULL_VERSION は無視されます。

  set BAZEL_WINSDK_FULL_VERSION=10.0.10240.0
  

すべてが設定されていれば、C++ ターゲットをビルドできます。

サンプル プロジェクトのいずれかからターゲットをビルドしてみてください。

bazel build //examples/cpp:hello-world
bazel-bin\examples\cpp\hello-world.exe

デフォルトでは、ビルドされたバイナリは x64 アーキテクチャをターゲットとしています。別のターゲット アーキテクチャを指定するには、ターゲット アーキテクチャの --cpu ビルド オプションを設定します。 * x64（デフォルト）: --cpu=x64_windows またはオプションなし * x86: --cpu=x64_x86_windows * ARM: --cpu=x64_arm_windows * ARM64: --cpu=arm64_windows

たとえば、ARM アーキテクチャのターゲットをビルドするには、次のコマンドを実行します。

bazel build //examples/cpp:hello-world --cpu=x64_arm_windows

ダイナミック リンク ライブラリ（DLL ファイル）をビルドして使用するには、こちらの例をご覧ください。

コマンドラインの長さの制限: Windows コマンドラインの長さの制限に関する問題を回避するには、--features=compiler_param_file を使用してコンパイラ パラメータ ファイル機能を有効にします。

Clang で C++ をビルドする

0.29.0 以降、Bazel は LLVM の MSVC 互換コンパイラ ドライバ（clang-cl.exe）を使用したビルドをサポートしています。

要件: Clang でビルドするには、LLVM と Visual C++ Build Tools の両方をインストールする必要があります。コンパイラとして clang-cl.exe を使用する場合でも、Visual C++ ライブラリにリンクする必要があるためです。

Bazel はシステム上の LLVM のインストールを自動的に検出できます。また、BAZEL_LLVM を使用して LLVM のインストール場所を Bazel に明示的に伝えることもできます。

• BAZEL_LLVM LLVM のインストール ディレクトリ

  set BAZEL_LLVM=C:\Program Files\LLVM

C++ をビルドするための Clang ツールチェーンを有効にするには、いくつかの状況があります。

• bazel 0.28 以前: Clang はサポートされていません。

• --incompatible_enable_cc_toolchain_resolution なし: ビルドフラグ --compiler=clang-cl で Clang ツールチェーンを有効にできます。

• --incompatible_enable_cc_toolchain_resolution を使用する場合: BUILD file（最上位の BUILD ファイルなど）にプラットフォーム ターゲットを追加する必要があります。

  platform(
      name = "x64_windows-clang-cl",
      constraint_values = [
          "@platforms//cpu:x86_64",
          "@platforms//os:windows",
          "@bazel_tools//tools/cpp:clang-cl",
      ],
  )
  

  その後、次のいずれかの方法で Clang ツールチェーンを有効にできます。

  • 次のビルドフラグを指定します。

  --extra_toolchains=@local_config_cc//:cc-toolchain-x64_windows-clang-cl --extra_execution_platforms=//:x64_windows-clang-cl
  

  • WORKSPACE ファイルでプラットフォームとツールチェーンを登録します。

  register_execution_platforms(
      ":x64_windows-clang-cl"
  )
  
  register_toolchains(
      "@local_config_cc//:cc-toolchain-x64_windows-clang-cl",
  )
  

  --incompatible_enable_cc_toolchain_resolution フラグは、今後の Bazel リリースでデフォルトで有効になる予定です。そのため、2 番目の方法で Clang のサポートを有効にすることをおすすめします。

Java をビルドする

Java ターゲットをビルドするには、次のものが必要です。

• Java SE Development Kit

Windows では、Bazel は java_binary ルール用に 2 つの出力ファイルをビルドします。

• .jar ファイル
• JVM の環境を設定してバイナリを実行できる .exe ファイル

サンプル プロジェクトのいずれかからターゲットをビルドしてみてください。

  bazel build //examples/java-native/src/main/java/com/example/myproject:hello-world
  bazel-bin\examples\java-native\src\main\java\com\example\myproject\hello-world.exe

Python をビルドする

Python ターゲットをビルドするには、次のものが必要です。

• Python インタープリタ

Windows では、Bazel は py_binary ルール用に 2 つの出力ファイルをビルドします。

• 自己解凍型 zip ファイル
• 自己解凍型 zip ファイルを引数として Python インタプリタを起動できる実行可能ファイル

実行可能ファイル（拡張子は .exe）を実行するか、自己解凍型 ZIP ファイルを引数として Python を実行します。

サンプル プロジェクトのいずれかからターゲットをビルドしてみてください。

  bazel build //examples/py_native:bin
  bazel-bin\examples\py_native\bin.exe
  python bazel-bin\examples\py_native\bin.zip

Bazel が Windows で Python ターゲットをビルドする方法について詳しくは、こちらの設計ドキュメントをご覧ください。