Building for Linux

Version Requirements

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

• CMake: 2.8.12.1

Prerequisites

Prior to building, install the following components using the Linux distribution's package manager:

• CMake. You can also manually install packages from cmake.org.

For example, on Ubuntu:

sudo apt-get install cmake

Building

• Open a command line window.
• Go to the MathFu project directory.
• Generate Makefiles from the CMake project.
• Execute make to build the unit tests and benchmarks.

For example:

cd mathfu
cmake -G'Unix Makefiles' .
make

To perform a debug build:

cd mathfu
cmake -G'Unix Makefiles' -DCMAKE_BUILD_TYPE=Debug .
make

Build targets can be configured using options exposed in mathfu/CMakeLists.txt by using CMake's -D option. Build configuration set using the -D option is sticky across subsequent builds.

For example, if a build is performed using:

cd mathfu
cmake -G"Unix Makefiles" -DCMAKE_BUILD_TYPE=Debug .
make

to switch to a release build CMAKE_BUILD_TYPE must be explicitly specified:

cd mathfu
cmake -G"Unix Makefiles" -DCMAKE_BUILD_TYPE=Release .
make

Running Applications

Each benchmark binaries are located in the benchmarks/ directory and unit test binaries are located in the unit_tests/ directory.

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/*_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/*_tests; do ${binary}; done