ecm(7)¶
Contents
Introduction¶
The Extra CMake Modules package, or ECM, adds to the modules provided by CMake,
including both ones used by find_package()
to find common software and ones
that can be used directly in CMakeLists.txt
files to perform common tasks.
In addition, it provides common build settings used in software produced by the KDE community.
While the driving force of this module is to reduce duplication in CMake scripts across KDE software, it is intended to be useful for any software that uses the CMake build system.
Usage¶
To use ECM, add the following to your CMakeLists.txt
:
find_package(ECM REQUIRED NO_MODULE)
set(CMAKE_MODULE_PATH ${ECM_MODULE_PATH})
(note that you may want to append ${ECM_MODULE_PATH}
to
CMAKE_MODULE_PATH
rather than discarding the existing value). You can then
just include the modules you require, or use find_package()
as needed. For
example:
include(ECMInstallIcons)
Developers of KDE software will often want to use the KDE standard settings provided by ECM; they can do the following:
find_package(ECM REQUIRED NO_MODULE)
set(CMAKE_MODULE_PATH ${ECM_MODULE_PATH})
include(KDEInstallDirs)
include(KDECompilerSettings)
include(KDECMakeSettings)
Note that any combination of the above includes can be used if you only want
some of the settings. Some of the functionality of
KDECMakeSettings
can also be selectively disabled.
Organization¶
ECM provides three different types of modules.
- Core modules provide helpful macros for use in project CMake scripts.
See
ecm-modules(7)
for more information. - Find modules extend the functionality of CMake’s
find_package()
command. Seeecm-find-modules(7)
for more information. - KDE modules provide common settings for software produced by KDE; much of this
may also be useful to other projects. See
ecm-kde-modules(7)
for more information.
The ${ECM_MODULE_DIR}
, ${ECM_FIND_MODULE_DIR}
and
${ECM_KDE_MODULE_DIR}
variables may be used instead of
${ECM_MODULE_PATH}
if you only need some of this functionality.
Development¶
The ecm-developer(7)
manual contains more information about
developing for Extra CMake Modules.
License¶
All code is licensed under the BSD 3-Clause license.
Links¶
- Home page: https://projects.kde.org/projects/kdesupport/extra-cmake-modules
- Mailing list: https://mail.kde.org/mailman/listinfo/kde-buildsystem
- IRC channel: #kde-devel on Freenode
- Git repository: https://projects.kde.org/projects/kdesupport/extra-cmake-modules/repository