Организация сборки продуктов с помощью CMake

На работе мы используем CMake для сборки продуктов. При этом собираются различные конфигурации  (Release, Debug), с помощью разных компиляторов (msvc-2008, mingw-gcc-4.4.0, sparc-sunos-gcc-3.4.6, прочие компиляторы для различных устройств: iar, arm-gcc, vrxcc).

Примерная иерархия директорий со сборками выглядит так:

\---buildroot
    \---win32
        +---mingw-gcc-4.4.0
        |   +---Debug
        |   \---Release
        \---msvc-2008
            +---Debug_Dynamic
            +---Debug_Static
            +---Release_Dynamic
            \---Release_Static

Для поддержки такой иерархии написаны скрипты для автоматизации конфигурирования и сборки проекта.



Конфигурирование
При конфигурировании проекта указываем нужный Generator, CMAKE_TOOLCHAIN_FILE (если собирается под другую платформу). Если проект зависит от внешних компонент, то добавляются также параметры для поиска этих компонент: -DCMAKE_FOO_ROOT=/foo -DCMAKE_BAR_LIBRARY_DIR=/bar/lib.

Для того чтобы упростить конфигурирование проектов необходимо придерживаться определенных правил: использовать стандартные механизмы размещения заголовочных файлов, библиотек, исполняемых файлов, либо разработать свои правила.

Компиляция
Для компиляции мы используем опять же CMake, так как он позволяет собрать проект в любой конфигурации одной командой:

cmake --build win32\mingw-gcc-4.4.0\Debug

Единственное небольшое отличие при сборке msvc конфигураций, для сборки Release нужно это явно указать, так как CMake генерирует Solution в котором присутствует две конфигурации: Debug и Release, и по умолчанию всегда собирается  Debug конфигурация. Для явного указания конфигурации используется следующая команда:

cmake --build win32\msvc-2008\Release_Dynamic --config Release

Также, для того чтобы собрать какую-то цель, можно указать параметр --target:

cmake --build win32\msvc-2008\Release_Dynamic --config Release --target install

Естественно, CMake сам следит за зависимостями между целями и сам вызывает нужный native tool для выполнения цели.
Аналогичным образом, если у вас поддержка CTest, можно запускать тесты

cmake --build win32\msvc-2008\Release_Dynamic --config Release --target Experimental

Запустит тест и submit на CDash сервер.

Итого, для компиляции и выполнения различных целей у нас написан простенький скрипт на питоне, который рекурсивно обходит иерархию, находит файл  CMakeCache.txt - это признак того, что в данной директории сконфигурирована сборка - и запускает процесс сборки через CMake. Также, необходимо заметить, что если native tool не поддерживает задание конфигурации (например, MinGW MakeFiles), то этот параметр просто игнорируется.