tree 68c6cdb24b93c5bb78cc87d7f8859be879630017
parent 5eb93828b77cdc8de85e8b361a085c07bf853811
author Shawn Pearce <sop@google.com> 1367023948 -0700
committer Shawn Pearce <sop@google.com> 1367403020 -0700

Build with Buck

Implement a new build system using Buck[1], Facebook's
open source clone of Google's internal build system.

  Pros:
  - Concise build language
  - Test and build output is concise
  - Test failures and stack traces show on terminal
  - Reliable incrementals; clean is unnecessary
  - Extensible with simple blocks of Python
  - Fast
      buck: clean: 0.452s, full 1m21.083s [*], no-op:  7.145s,
      mvn:  clean: 4.596s, full 2m53.776s,     no-op: 59.108s,

      [*] full build includes downloading all dependencies,
          time can vary due to remote server performance.

  Cons:
  - No Windows support
  - No native Maven Central support (added by macros)
  - No native GWT, Prolog, or WAR support (added by macros)
  - Bootstrap of buck requires Ant

Getting started:

  git clone https://github.com/facebook/buck.git
  cd buck
  ant

  Mac OS X:
  PATH="`pwd`/bin/buck:/System/Library/Frameworks/JavaVM.framework/Versions/Current/Commands:$PATH"

  Linux:
  PATH="`pwd`/bin/buck:$PATH"

Building:

  buck build :gerrit :api
  java -jar buck-out/gen/gerrit.war
  ls -lh buck-out/gen/{extension,plugin}-api.jar

Testing:

  $ time buck test --all -e slow  # skip slow tests
  0m19.320s

  $ time buck test --all          # includes acceptance tests
  5m17.517s

Documentation:

  time make: 57.0s ; time make -j7 9.9s
  time buck: 10.4s

Full Release:

  buck test --all && buck build :release
  java -jar buck-out/gen/release.war

[1] http://facebook.github.io/buck/

Change-Id: I40853b108bd8e153cefa0896a5280a9a5ff81655