Building for OS X

Version Requirements

Following are the minimum required versions of tools and libraries you need to build MathFu for OS X:

• OS X: Mavericks 10.9.1.
• Xcode: 5.0.1
• CMake: 2.8.12.1

Prerequisites

• Install Xcode.
• Install CMake.

Building with Xcode

Firstly, the Xcode project needs to be generated using CMake:

• Open a command line window.
• Go to the MathFu project directory.
• Use CMake to generate the Xcode project.

cd mathfu
cmake -G Xcode .

Then the project can be opened in Xcode and built:

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

Running Applications

Running in Xcode

Open Xcode select a build target and run it:

• Double-click on mathfu/MathFu.xcodeproj to open the project in Xcode.
• Select an application Scheme, for example "matrix_tests-->My Mac 64-bit", from the combo box to the right of the "Run" button.
• Click the "Run" button.

Running from the Command Line

To build:

• Open a command line window.
• Go to the MathFu project directory.
• Generate the Xcode project.
• Run xcodebuild.

For example:

cd mathfu
cmake -G Xcode .
xcodebuild

To run all benchmarks:

• Open a command line window.
• Go to the MathFu project directory.
• Run each benchmark binary in the benchmarks/ directory.

For example:

cd mathfu
for binary in ./benchmarks/Debug/*_benchmarks; do ${binary}; done

To run all unit tests:

• Open a command line window.
• Go to the MathFu project directory.
• Run each unit test binary in the unit_tests/ directory.

For example:

cd mathfu
for binary in ./unit_tests/Debug/*_tests; do ${binary}; done