CMake is a cross-platform open-source meta-build system which can build, test and package software. It can be used to support multiple native build environments including make, Apple’s xcode and Microsoft Visual Studio.

This repository includes some example modern CMake configurations which I have picked up when exploring it’s usage for various projects. The examples are laid out in a tutorial like format. The first examples are very basic and slowly increase in complexity drawing on previous examples to show more complex use cases.

These examples have been tested on Ubuntu 16.04 but should work under any Linux system that supports CMake v3.5+.

This branch works with the CMake version 3.5 onwards.

• For examples that use CMake version 2.x see the branch v2-style-includes.

• For examples that use CMake version 3.0 see the branch v3.0-minimum

The basic requirements for most examples are:

• CMake v3.5+

• A c++ compiler (defaults to gcc)

• make

Installation on Ubuntu

$ sudo apt-get install build-essential
$ sudo apt-get install cmake

Docker

docker run -it matrim/cmake-examples:3.5.1
cd ~
git clone https://github.com/ttroy50/cmake-examples.git code
cd code
./test.sh

There are many CMake tutorials and examples online. The list below includes links to some of these which I have found helpful in my CMake journey.

• Modern CMake Slides

• rix0r Modern CMake Blog

• Official CMake Tutorial

• Official CMake Wiki

• CMake Useful Variables

• Derek Molloy - Intro to CMake

• Modular C++ Projects

• Common CMake Anti-Patterns

• Using clang static analyser with CMake

• Static Analysis with CDash - Includes some info about using CppCheck with CMake

• CMake Tips

• John Lamp - CMake Tutorial

• Conan Documentation