Private
Public Access
2
0
Files
mraa/docs/building.md
Brendan Le Foll 93107a388c building.md: update cmake instructions
Signed-off-by: Brendan Le Foll <brendan.le.foll@intel.com>
2014-11-09 12:26:09 +00:00

1.5 KiB

Building libmraa

libmraa uses cmake in order to make compilation relatively painless. Cmake runs build out of tree so the recommended way is to clone from git and make a build/ directory.

You'll need swig version 3.0.1+, currently I'm using 8d226e39dc7a958013ff9ffd15e231ef206ba265 from the swig master branch. This is only required for javascript support and can be disabled with a cmake define (see below).

mkdir build
cd build
cmake ..
make

Our cmake configure has a number of options, cmake-gui or ccmake can show you all the options. The interesting ones are detailed below:

Few recommended options: Changing install path from /usr/local to /usr -DCMAKE_INSTALL_PREFIX:PATH=/usr

Building debug build: -DCMAKE_BUILD_TYPE=DEBUG

Using clang instead of gcc: -DCMAKE_C_COMPILER=/usr/bin/clang -DCMAKE_CXX_COMPILER=/usr/bin/clang

Building with an older version of swig (swig 2.0+) requires the disabling of javascript: -DBUILDSWIGNODE=OFF

Disabling python module building -DBUILDSWIGPYTHON=OFF

Building doc, this will require sphinx & doxygen -BUILDDOC=ON

Using coverity

Static analysis is routinely performed using coverity on libmraa's codebase. This is the procedure to submit a build to coverity. You'll need to install coverity-submit for your OS.

mkdir covbuild/ && cd covbuild
cmake -DBUILDDOC=OFF -DBUILDSWIG=OFF ..
cmake -DBUILDDOC=OFF -DBUILDSWIG=OFF ..
cov-build --dir cov-int make
tar caf mraa.tar..bz2 cov-int