ECMPackageConfigHelpers — Extra CMake Modules 5.80.0 documentation

# ECMPackageConfigHelpers

Helper macros for generating CMake package config files.

`write_basic_package_version_file()` is the same as the one provided by the CMakePackageConfigHelpers module in CMake; see that module’s documentation for more information.

    ecm_configure_package_config_file(<input> <output>
        INSTALL_DESTINATION <path>
        [PATH_VARS <var1> [<var2> [...]]
        [NO_SET_AND_CHECK_MACRO]
        [NO_CHECK_REQUIRED_COMPONENTS_MACRO])

This behaves in the same way as configure_package_config_file() from CMake 2.8.12, except that it adds an extra helper macro: find_dependency(). It is highly recommended that you read the documentation for CMakePackageConfigHelpers for more information, particularly with regard to the PATH_VARS argument.

Note that there is no argument that will disable the find_dependency() macro; if you do not require this macro, you should use `configure_package_config_file` from the CMakePackageConfigHelpers module.

CMake 3.0 includes a CMakeFindDependencyMacro module that provides the find_dependency() macro (which you can `include()` in your package config file), so this file is only useful for projects wishing to provide config files that will work with CMake 2.8.12.

## Additional Config File Macros

    find_dependency(<dep> [<version> [EXACT]])

find_dependency() should be used instead of find_package() to find package dependencies. It forwards the correct parameters for EXACT, QUIET and REQUIRED which were passed to the original find_package() call. It also sets an informative diagnostic message if the dependency could not be found.

Since pre-1.0.0.