CMake/Tutorials/SettingVariableGroups

From KitwarePublic
< CMake‎ | Tutorials
Revision as of 12:55, 21 September 2012 by Daviddoria (talk | contribs)
Jump to navigationJump to search
The printable version is no longer supported and may have rendering errors. Please update your browser bookmarks and please use the default browser print function instead.
cmake_minimum_required(VERSION 2.6)

# The idea of this demo is to show how to set a group of CMake variables together.
# A common use case is to allow easy enabling/disabling of a large set of targets, while
# maintaining manual individual target control. This is in contrast to a BUILD_ALL style variable,
# where targets are build if a corresponding variable to the target is set, OR the BUILD_ALL variable
# is set. The problem with this method is that if you want to set "all but one" of the targets to ON,
# it is not possible without manually setting all N-1 of the targets to OFF.

PROJECT(VariablePrefix)

# Add options to build specific targets
option(build_Green "green")
option(build_Blue "blue")

# Add options to allow enabling/disabling of a set of targets
option(TurnOnAll "all")
option(TurnOffAll "all")

# A function to get all user defined variables with a specified prefix
function (getListOfVarsStartingWith _prefix _varResult)
    get_cmake_property(_vars VARIABLES)
    string (REGEX MATCHALL "(^|;)${_prefix}[A-Za-z0-9_]*" _matchedVars "${_vars}")
    set (${_varResult} ${_matchedVars} PARENT_SCOPE)
endfunction()

# Mass toggle "commands". These variables (TurnOnAll and TurnOffAll) let you
# enable or disable all of the variables starting with "build_". This is an abuse
# of a CMake "variable" to be used as an instruction to issue a command once.
# For example, when TurnOnAll is set to ON and then configure is run, the following
# block is run once, and then TurnOnAll sets itself back to OFF.
if(TurnOnAll)
    getListOfVarsStartingWith("build_" matchedVars)
    foreach (_var IN LISTS matchedVars)
        message("Turn on ${item}")
        set(${_var} ON CACHE BOOL "test" FORCE) # "test" is here because I'm not sure how to preserve the docstring.
    endforeach()

    set(TurnOnAll OFF CACHE BOOL "test" FORCE)  # Set itself back to off, as this is a one time thing. "test" is here because I'm not sure how to preserve the docstring.
endif()

# In exactly the same manner, if TurnOffAll is set to ON, all of the variables starting with build_ are set to OFF.
if(TurnOffAll)
    getListOfVarsStartingWith("build_" matchedVars)
    foreach (_var IN LISTS matchedVars)
        message("Turn off ${item}")
        set(${_var} OFF CACHE BOOL "test" FORCE) # "test" is here because I'm not sure how to preserve the docstring.
    endforeach()

    set(TurnOffAll OFF CACHE BOOL "test" FORCE)  # Set itself back to off, as this is a one time thing. "test" is here because I'm not sure how to preserve the docstring.
endif()

# Of course turning on all variables at the same time as turning off all variables does not make sense.
if(TurnOnAllTargets AND TurnOffAllTargets)
  message(FATAL_ERROR "You cannot turn targets on and off at the same time!")
endif()

# Conditional executables
if(build_Green)
   ADD_EXECUTABLE(GreenLaser GroupVariables.cpp)
endif()

if(build_Blue)
   ADD_EXECUTABLE(BlueLaser GroupVariables.cpp)
   # other options here
endif()