Platform independent builds with Cmake

2 minute read

Related: Easy install Cmake

A wide variety of programming languages are used by engineers and scientists. You can tie them all together (C, C++, C#, Cuda, Fortran, etc.) in a platform-independent and simple way using Cmake. Alternatives to Cmake include SCONS and Autotools.

Basic CMake example

Let’s take a single-file C++ program, like a science/engineering researcher might use. You will probably be linking the Math library at least, and Boost for flexible command-line input of numerous parameters. You might like to turn on additional compiler warnings to help avoid common coding pitfalls. Finally, you want to allow your colleagues on a wide variety of computers and operating systems to compile easily.

To do all of the above easily, Cmake has a simple syntax. Let’s consider the example CMakeLists.txt line by line.

Explanation of simple Cmake file line-by-line

cmake_minimum_required(VERSION 2.8.12)

This line is required; version 2.8.12 is included in Ubuntu 14.04 and other systems of the past few years. Cmake 2.8.12 is new enough for most small projects.

Distro CMake default
Ubuntu 14.04 2.8.12
Ubuntu 16.04 3.5.1

CMake language(s) selection

project(zakharov CXX)

Naming your project can help auto-install if you decide to someday. CXX is required to enable the hooks for the language(s) you used. The most frequently used include

tag language
C# C#
Fortran Fortran

CMake compiler options

add_compile_options(-mtune=native -Wall -Wextra -Wpedantic -fexceptions -Warray-bounds)
use specialized optimizations for your particular CPU
-Wall -Wextra -Wpedantic -Warray-bounds
turn on warnings for common programming mistakes
more detailed debug info with no speed penalty–enabled by default on Clang.
add_executable(zakh zakh.cpp)
the exe file that will be created on compile, run with ./zakh.
the files making up “zakh”

This project requires C++11 features, so if someone has an extremely old compiler not supporting C++11 they’ll get an error.

find_package(Boost REQUIRED COMPONENTS system filesystem program_options)
target_link_libraries(zakh ${Boost_LIBRARIES})

The last two Boost lines are boiler-plate. The first line reflects that I use

directory manipulation
advanced command-line parsing
typically included when using Boost.

Compiling a simple project with Cmake

It’s convenient to create a separate directory, typically bin/ under your main code directory. You can certainly use options to use a single directory for everything, but it can be cleaner to use the defaults. Let’s say your main code directory is ~/code/zakharov, then do

mkdir bin
cd bin
cmake ..

Let’s say you edit the code. All you do from the bin/ directory is


for almost any subsequent changes

Leave a Comment