ECMPackageConfigHelpers — Extra CMake Modules 6.28.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.