Building on Mac OS X

This is a step-by-step guide to building Heron on Mac OS X (versions 10.10 and 10.11).

Step 1 — Install Homebrew

If Homebrew isn’t yet installed on your system, you can install it using this one-liner:

$ /usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"

Step 2 — Install other required libraries

brew install automake
brew install cmake
brew install libtool

Step 3 — Set the following environment variables

$ export CC=/usr/bin/clang
$ export CXX=/usr/bin/clang++
$ echo $CC $CXX

Step 4 - Install Bazel

#}

wget -O /tmp/bazel.sh  https://github.com/bazelbuild/bazel/releases/download/0.3.1/bazel-0.3.1-installer-darwin-x86_64.sh
chmod +x /tmp/bazel.sh
/tmp/bazel.sh --user

Step 5 — Make sure the Bazel executable is on your PATH

$ export PATH="$PATH:$HOME/bin"

Step 6 — Fetch the latest version of Heron’s source code

$ git clone https://github.com/twitter/heron.git && cd heron

Step 7 — Configure Heron for building with Bazel

$ ./bazel_configure.py

If this configure script fails with missing dependencies, Homebrew can be used to install those dependencies.

Step 8 — Build the project

$ bazel build --config=darwin heron/...

Step 9 — Build the packages

$ bazel build --config=darwin scripts/packages:binpkgs
$ bazel build --config=darwin scripts/packages:tarpkgs

This will install Heron packages in the bazel-bin/scripts/packages/ directory.