Building on Mac OS X

This is a step by step guide for building Heron on Mac OS (10.10 and 10.11).

Step 1 - Install brew, if already not installed

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

Step 2 - Install the required libraries

brew install automake brew install cmake

Step 3 - Set the following environment variables

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

Step 4 - Install Bazel

curl -O -L https://github.com/bazelbuild/bazel/releases/download/0.1.2/bazel-0.1.2-installer-darwin-x86_64.sh chmod +x bazel-0.1.2-installer-darwin-x86_64.sh ./bazel-0.1.2-installer-darwin-x86_64.sh --user

Step 5 - Make sure Bazel bin is in the PATH

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

Step 6 - Get the latest version of heron

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

Step 7 - Configure Heron for build

./bazel_configure.py

If the configure scripts fails with missing dependencies, brew can be used to install the 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 build the packages below the bazel-bin/scripts/packages/ directory.