Polly

Collection of CMake toolchain files and scripts.

mac	linux

Every toolchain defines compiler/flags and two variables:

• POLLY_TOOLCHAIN_NAME
• POLLY_TOOLCHAIN_TAG

First variable will be printed while processing file:

-- [polly] Used toolchain: Name of toolchain A
-- The CXX compiler identification is Clang 5.0.0
-- Check for working CXX compiler: /usr/bin/c++
-- [polly] Used toolchain: Name of toolchain A
-- Check for working CXX compiler: /usr/bin/c++ -- works
-- Detecting CXX compiler ABI info
-- [polly] Used toolchain: Name of toolchain A
-- Detecting CXX compiler ABI info - done
-- [polly] Used toolchain: Name of toolchain A
-- Configuring done
-- Generating done
-- Build files have been written to: ...

Second variable coincide with toolchain file name and can be used to define CMAKE_INSTALL_PREFIX like:

set(CMAKE_INSTALL_PREFIX "${PROJECT_SOURCE_DIR}/_install/${POLLY_TOOLCHAIN_TAG}")

In this case targets can coexist simultaneously:

 - Project\ -
            - CMakeLists.txt
            - sources\
            - documentation\
            - ...
            - _install\ -
                        - toolchain-A\
                        - toolchain-B\
                        - toolchain-C\
                        - ...

Note: This is a core idea of the tagged builds in hunter package manager.

Toolchains

• default
• libcxx
• clang-lto
• clang-libstdcxx
• custom-libcxx
• xcode
• osx-*
• gcc
• gcc-4-8
• Android
• android-ndk-*
• iOS
• ios
• ios-i386-armv7
• ios-nocodesign
• Raspberry Pi
• raspberrypi2-cxx11
• Clang tools
• analyze
• sanitize-address
• sanitize-leak
• sanitize-memory
• sanitize-thread
• Windows
• vs-12-2013-win64
• vs-12-2013
• vs-12-2013-xp
• cygwin
• mingw
• msys
• nmake-vs-12-2013-win64
• nmake-vs-12-2013

Usage

Just define CMAKE_TOOLCHAIN_FILE variable:

> cmake -H. -B_builds/clang-libstdcxx -DCMAKE_TOOLCHAIN_FILE=${POLLY_ROOT}/clang-libstdcxx.cmake -DCMAKE_VERBOSE_MAKEFILE=ON
-- [polly] Used toolchain: clang / GNU Standard C++ Library (libstdc++) / c++11 support
-- The CXX compiler identification is Clang 5.0.0
-- Check for working CXX compiler: /usr/bin/c++
-- [polly] Used toolchain: clang / GNU Standard C++ Library (libstdc++) / c++11 support
-- Check for working CXX compiler: /usr/bin/c++ -- works
-- Detecting CXX compiler ABI info
-- [polly] Used toolchain: clang / GNU Standard C++ Library (libstdc++) / c++11 support
-- Detecting CXX compiler ABI info - done
-- Configuring done
-- Generating done
-- Build files have been written to: /.../_builds/make-debug

Take a look at make output, you must see -stdlib=libstdc++ string:

> cmake --build _builds/clang_libstdcxx
/usr/bin/c++ -std=c++11 -stdlib=libstdc++ -o CMakeFiles/.../main.cpp.o -c /.../main.cpp

build.py

This is a python script that wrap cmake for you and automatically set:

• build directory for your toolchain. E.g. _builds/xcode, _builds/libcxx-Debug, _builds/nmake-Release
• local install directory. E.g. _install/vs-12-2013-x64, _install/libcxx
• start an IDE project (Xcode, Visual Studio) if option --open passed
• run ctest after the build done if option --test passed
• run cpack after the build done if option --pack passed
• create OS X/iOS framework if option --framework passed (can be used for broken iOS framework creation on CMake)

Example of usage (also see build.py --help):

• build Debug Xcode project:
  • build.py --toolchain xcode --config Debug (_builds/xcode)
• build and test Release Makefile project with libcxx:
  • build.py --toolchain libcxx --config Release --test (_builds/libcxx-Release)
• install Debug Xcode project:
  • build.py --toolchain xcode --config Debug --install (_builds/xcode, _install/xcode)

jenkins.py

Script read environment variables CONFIG/TOOLCHAIN and use them to start build.py script with --test argument. It can be useful for running matrix builds on jenkins server. Read wiki for details.

Examples

See examples. Please read coding style and agreements before start looking through examples (may explain a lot). Take a look at the Travis config files: mac and linux, it's quite self-explanatory.

Links

• Hunter package manager
• Installation on Jenkins
• Travis example: Mac OS X and Linux
• Table of toolchains available for Travis CI