cmake

This is the reference page for cmake generator. Go to Integrations/CMake if you want to learn how to integrate your project or recipes with CMake.

It generates a file named conanbuildinfo.cmake and declares some variables and methods.

Variables in conanbuildinfo.cmake

  • Package declared variables:

    For each requirement conanbuildinfo.cmake file declares the following variables. XXX is the name of the require in uppercase. e.g. “ZLIB” for zlib/1.2.8@lasote/stable requirement:

    NAME

    VALUE

    CONAN_XXX_ROOT

    Abs path to root package folder.

    CONAN_INCLUDE_DIRS_XXX

    Header’s folders

    CONAN_LIB_DIRS_XXX

    Library folders (default {CONAN_XXX_ROOT}/lib)

    CONAN_BIN_DIRS_XXX

    Binary folders (default {CONAN_XXX_ROOT}/bin)

    CONAN_SRC_DIRS_XXX

    Sources folders

    CONAN_LIBS_XXX

    Library names to link

    CONAN_DEFINES_XXX

    Library defines

    CONAN_COMPILE_DEFINITIONS_XXX

    Compile definitions

    CONAN_CXX_FLAGS_XXX

    CXX flags

    CONAN_SHARED_LINK_FLAGS_XXX

    Shared link flags

    CONAN_C_FLAGS_XXX

    C flags

  • Global declared variables:

    This generator also declares some global variables with the aggregated values of all our requirements. The values are ordered in the right order according to the dependency tree.

    NAME

    VALUE

    CONAN_INCLUDE_DIRS

    Aggregated header’s folders

    CONAN_LIB_DIRS

    Aggregated library folders

    CONAN_BIN_DIRS

    Aggregated binary folders

    CONAN_SRC_DIRS

    Aggregated sources folders

    CONAN_LIBS

    Aggregated library names to link

    CONAN_DEFINES

    Aggregated library defines

    CONAN_COMPILE_DEFINITIONS

    Aggregated compile definitions

    CONAN_CXX_FLAGS

    Aggregated CXX flags

    CONAN_SHARED_LINK_FLAGS

    Aggregated Shared link flags

    CONAN_C_FLAGS

    Aggregated C flags

  • User information declared variables:

    If any of the requirements is filling the user_info object in the package_info method a set of variables will be declared following this naming:

    NAME

    VALUE

    CONAN_USER_XXXX_YYYY

    User declared value

    Where XXXX means the name of the requirement in uppercase and YYYY the variable name. For example, if this recipe declares:

    class MyLibConan(ConanFile):
        name = "MyLib"
        version = "1.6.0"
    
        # ...
    
        def package_info(self):
            self.user_info.var1 = 2
    

    Other library requiring MyLib and using this generator will get:

    conanbuildinfo.cmake
     # ...
     set(CONAN_USER_MYLIB_var1 "2")
    

Macros available in conanbuildinfo.cmake

conan_basic_setup()

This is a helper and general purpose macro that uses all the macros below to set all the CMake variables according to the Conan generated variables. See the macros below for detailed information.

macro(conan_basic_setup)
    set(options TARGETS NO_OUTPUT_DIRS SKIP_RPATH KEEP_RPATHS SKIP_STD SKIP_FPIC)
Parameters:
  • TARGETS (Optional): Setup all the CMake variables by target (only CMake > 3.1.2). Activates the call to the macro conan_target_link_libraries().

  • NO_OUTPUT_DIRS (Optional): Do not adjust the output directories. Deactivates the call to the macro conan_output_dirs_setup().

  • SKIP_RPATH (Optional): [DEPRECATED] Use KEEP_RPATHS instead. Activate CMAKE_SKIP_RPATH variable in OSX.

  • KEEP_RPATHS (Optional): Do not adjust the CMAKE_SKIP_RPATH variable in OSX. Activates the call to the macro conan_set_rpath()

  • SKIP_STD (Optional): Do not adjust the C++ standard flag in CMAKE_CXX_FLAGS. Deactivates the call to the macro conan_set_std().

  • SKIP_FPIC (Optional): Do not adjust the CMAKE_POSITION_INDEPENDENT_CODE flag. Deactivates the call to the macro conan_set_fpic().

Note

You can also call each of the following macros individually instead of using the conan_basic_setup().

conan_check_compiler()

Checks that your compiler matches the one declared in settings.

This method can be disabled setting the CONAN_DISABLE_CHECK_COMPILER variable.

conan_output_dirs_setup()

Adjusts the bin/ and lib/ output directories.

conan_set_find_library_paths()

Sets CMAKE_INCLUDE_PATH and CMAKE_INCLUDE_PATH.

conan_global_flags()

Sets the corresponding variables to CMake’s include_directories() and link_directories().

conan_define_targets()

Defines the targets for each dependency (target flags instead of global flags).

conan_set_rpath()

Sets CMAKE_SKIP_RPATH=1 in the case of working in OSX.

conan_set_vs_runtime()

Adjusts the runtime flags /MD, /MDd, /MT or /MTd for Visual Studio.

conan_set_std()

Sets CMAKE_CXX_STANDARD and CMAKE_CXX_EXTENSIONS to the appropriate values.

conan_set_libcxx()

Adjusts the standard library flags (libc++`, libstdc++, libstdc++11) in CMAKE_CXX_FLAGS.

conan_set_find_paths()

Adjusts CMAKE_MODULE_PATH and CMAKE_PREFIX_PATH to the values of deps_cpp_info.build_paths.

Input variables for conanbuildinfo.cmake

CONAN_CMAKE_SILENT_OUTPUT

Default to: FALSE

Activate it to silence the Conan message output.

CONAN_DISABLE_CHECK_COMPILER

Default to: FALSE

Deactivates the check of the compiler done with the method conan_check_compiler().