LiquidFun Build and Run Instructions
Building for OS X

LiquidFun releases contain a Xcode project to build the library and samples on OS X. The Xcode project has been generated using cmake, and is modified to remove any host-specific dependencies.

Before Building

  • Install Xquartz to run LiquidFun sample applications. Xquartz is required by freeglut
  • Reboot your machine. This sets the DISPLAY environment variable for Xquartz which enables sample applications to run correctly.

Building with Xcode

  • Double-click on liquidfun/Box2D/Box2D.xcodeproj to open the project in Xcode.
  • Select "Product-->Build" from the menu.

Executing a Sample

  • Select a sample Scheme, for example "Testbed-->My Mac 64-bit" from the combo box to the right of the "Run" button.
  • Click the "Run" button.

Building using cmake

When working directly with the source, you can generate the Xcode project using cmake. cmake version 2.8.12.1 or above is required to build this project on OS X 10.9 (Mavericks). For example, the following generates the Xcode project in the liquidfun/Box2D directory.

cd liquidfun/Box2D
cmake -G"Xcode"

Running Unit Tests

Developers modifying the LiquidFun library can verify that it still working correctly by executing the provided unit tests.

Use the run_tests.sh script to execute unit tests:

./liquidfun/Box2D/Unittests/run_tests.sh