layout: documentation title: Windows

Building Bazel on Windows

Windows support is highly experimental. Known issues are marked with label “Windows” on github issues.

We currently support only 64 bit Windows 7 or higher and we compile Bazel as a msys2 binary.

To bootstrap Bazel on Windows, you will need:

  • Java JDK 8 or later
  • Visual Studio (Community Edition is okay)
  • msys2 (need to be installed at C:\tools\msys64\).
  • Several msys2 packages. Use the pacman command to install them: pacman -S gcc git curl zip unzip zlib-devel

To build Bazel:

  • Open the msys2 shell.
  • Clone the Bazel git repository as normal.
  • Set the environment variables:
export JAVA_HOME="$(ls -d C:/Program\ Files/Java/jdk* | sort | tail -n 1)"
export BAZEL_SH=c:/tools/msys64/usr/bin/bash.exe

  • Run ``compile.sh`` in Bazel directory.

  • If all works fine, bazel will be built at ``output\bazel.exe``.

Using Bazel on Windows

Bazel currently supports building C++ targets and Java targets on Windows.

Build C++

To build C++ targets, you will need:

  • Visual Studio
    We are using MSVC as the native C++ toolchain, so please ensure you have Visual Studio installed with the Visual C++ components (which is NOT the default installation type of Visual Studio).

  • Python 2.7
    Currently, we use python wrapper scripts to call the actual MSVC compiler, so please make sure Python is installed and its location is added into PATH. It's also a good idea to set BAZEL_PYTHON environment variable to tell Bazel where python is.
    For example: export BAZEL_PYTHON=C:/Python27/python.exe

Bazel will auto-configure the location of Visual Studio and Python at the first time you build any target. If you need to auto-configure again, just run bazel clean then build a target.

If everything is set up, you can build C++ target now! However, since MSVC toolchain is not default on Windows yet, you should use flag --cpu=x64_windows_msvc to enable it like this:

$ bazel build --cpu=x64_windows_msvc examples/cpp:hello-world
$ ./bazel-bin/examples/cpp/hello-world.exe
$ bazel run --cpu=x64_windows_msvc examples/cpp:hello-world

Build Java

Building Java targets works well on Windows, no special configuration is needed. Just try:

$ 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
$ bazel run examples/java-native/src/main/java/com/example/myproject:hello-world