Note: Bazel release 0.5.0 contains a bug in the compiler detection on macOS which requires Xcode and the iOS tooling to be installed (corresponding issue #3063). If you had Command Line Tools installed, you also need to switch to Xcode using
sudo xcode-select -s /Applications/Xcode.app/Contents/Developer.
Install Bazel on macOS (OS X) using one of the following methods:
Bazel comes with two completion scripts. After installing Bazel, you can:
JDK 8 can be downloaded from Oracle's JDK Page.
Look for “Mac OS X” under “Java SE Development Kit”. This will download a DMG image with an install wizard.
Installing Homebrew is a one-time setup:
/usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
brew install bazel
You are all set. You can confirm Bazel is installed successfully by running bazel version.
You can later upgrade to newer version of Bazel with brew upgrade bazel.
The binary installers are on Bazel's GitHub releases page.
The installer contains the Bazel binary and the required JDK. Some additional libraries must also be installed for Bazel to work.
Xcode can be downloaded from the Apple Developer Site (this link redirects to their App Store).
For objc_* and ios_* rule support, you must have Xcode 6.1 or later with iOS SDK 8.1 installed on your system.
Once XCode is installed you can trigger signing the license with the following command:
sudo gcc --version
Go to Bazel's GitHub releases page.
Download the binary installer bazel-0.5.0-installer-darwin-x86_64.sh. This installer contains the Bazel binary and the required JDK, and can be used even if a JDK is already installed.
Note that bazel-0.5.0-without-jdk-installer-darwin-x86_64.sh is a version of the installer without embedded JDK 8. Only use this installer if you already have JDK 8 installed.
Note that two other versions of the installer exist:
bazel-0.5.0-without-jdk-installer-darwin-x86_64.sh: version without embedded JDK 8. Only use this installer if you already have JDK 8 installed.bazel-0.5.0-jdk7-installer-darwin-x86_64.sh: last release compatible with JDK 7.Run the installer:
The --user flag installs Bazel to the $HOME/bin directory on your system and sets the .bazelrc path to $HOME/.bazelrc. Use the --help command to see additional installation options.
If you ran the Bazel installer with the --user flag as above, the Bazel executable is installed in your $HOME/bin directory. It's a good idea to add this directory to your default paths, as follows:
export PATH="$PATH:$HOME/bin"
You can also add this command to your ~/.bashrc file.
You are all set. You can confirm Bazel is installed successfully by running
bazel version
Once installed, you can upgrade to a newer version of Bazel with:
sudo apt-get upgrade bazel