| Installation Instructions | |
| ************************* | |
| Basic Installation | |
| ================== | |
| mkdir build | |
| cd build | |
| cmake .. | |
| make | |
| make install | |
| CMake configuration options can be set using the -D option. eg | |
| cmake .. -DCMAKE_INSTALL_PREFIX=/usr/local -DCMAKE_BUILD_TYPE=release | |
| Build Options | |
| ============= | |
| Set install prefix: | |
| -DCMAKE_INSTALL_PREFIX=<path> | |
| Set build type. This sets the standard compiler flags for the build | |
| type. | |
| -DCMAKE_BUILD_TYPE=debug or -DCMAKE_BUILD_TYPE=release | |
| Set compiler flags: | |
| -DCMAKE_CXX_FLAGS=<flags> or set CXXFLAGS environment variable | |
| Set linker flags: | |
| -DCMAKE_LD_FLAGS=<flags> or set LDFLAGS environment variable | |
| Optional Features | |
| ================= | |
| -D<FEATURE>=<ON|OFF> | |
| eg | |
| -DENABLE_SPLASH=ON -DBUILD_GTK_TESTS=OFF | |
| A list of all options can be display with the commmand: | |
| egrep '^ *(option|set.*STRING)' CMakeLists.txt | |
| Alternatively, the options can be edited by running "ccmake ." in the | |
| build directory. | |
| Cross Compiling | |
| =============== | |
| A toolchain file is required to specify the target specific compiler | |
| tools. Run cmake with the option: | |
| -DCMAKE_TOOLCHAIN_FILE=<Toolchain file> | |
| A sample toolchain for a 64-bit mingw build is shown below. Replace | |
| /path/to/win/root with the install prefix for the target environment. | |
| SET(CMAKE_SYSTEM_NAME Windows) | |
| SET(CMAKE_C_COMPILER x86_64-w64-mingw32-gcc) | |
| SET(CMAKE_CXX_COMPILER x86_64-w64-mingw32-g++) | |
| SET(CMAKE_RC_COMPILER x86_64-w64-mingw32-windres) | |
| SET(CMAKE_FIND_ROOT_PATH /usr/x86_64-w64-mingw32 /path/to/win/root ) | |
| set(CMAKE_FIND_ROOT_PATH_MODE_PROGRAM NEVER) | |
| set(CMAKE_FIND_ROOT_PATH_MODE_LIBRARY ONLY) | |
| set(CMAKE_FIND_ROOT_PATH_MODE_INCLUDE ONLY) | |