CMake

Welcome to CMake, the cross-platform, open-source make system. CMake is used to control the software compilation process using simple platform and compiler independent configuration files. CMake generates native makefiles and workspaces that can be used in the compiler environment of your choice. CMake is quite sophisticated: it is possible to support complex environments requiring system configuration, pre-processor generation, code generation, and template instantiation.

You will find here not only documentation for CMake, but also for CPack and CTest.

CMake

Primary Resources - Look here first!

• Where can I download CMake?
• CMake Documentation
• Useful CMake Variables
• CMake Frequently asked questions
• CMake Mailing List

Development Topics

• Platform Dependent Issues
• Cross compiling with CMake
• Performance Tips
• RPATH handling with CMake
• Editors/IDEs with CMake support
• Generator Specific Information
• Documentation for previous CMake releases
• Fortran Issues
• Macros contributed by Users
• For CMake Hackers
• Module Maintainers
• Experiments With Lua

Tutorials

• A Simple CMake Example

• Cross-Platform Software Development Using CMake
  Tutorial that should get anybody up to speed with CMake

• How to write platform checks with CMake
  Describes how to implement platform or configure checks with CMake.

• How to find installed software with CMake
  Describes how to search for and then use software packages with CMake.

• How to find and use existing frameworks on OS X
  A quick example to help OS X users find frameworks automatically.

• How to build KDE4 software with cmake

• Qt with CMake
  Explains how to use CMake to build software with Qt4 and how to use it for Qt3 and KDE3 applications

• How to use CMake for building software with wxWidgets

• GNU style directory layout with CMake

• CMake with Eclipse
  Describes one way of setting up your project to work with Eclipse 3.3 and CDT 4.0, better know as Eclipse Europa.

• Replacing deprecated INSTALL_FILES, INSTALL_PROGRAMS, and INSTALL_TARGETS commands

Converters from other buildsystems to CMake

All converters listed here are not "complete", i.e. the generated CMake files are not 100% finished, in all cases some work is left for the developer.

• am2cmake (requires Ruby) Converts automake/autotools/libtool based projects to CMake, spezialiced in converting from KDE 3 to KDE 4, should also work for others. This one has been used for converting the KDE buildsystem to CMake.

• Alternative Automake2CMake (requires PHP) Converts KDevelop projects that use automake to CMake.

• qmake converter (requires Ruby) Converts projects that use Qt's qmake.

• gencmake (requires Ruby) Creates basic CMakeLists.txt files from looking at the existing files.

• vcproj2cmake.rb (requires Ruby) Creates CMakeLists.txt files by extracting info from Visual Studio project files.

Success Stories

• Articles about CMake

• What are some projects using CMake?

CTest

Tutorials

• Testing With CTest
  Introduces to testing with CTest, submitting dashboards, and using CMake to add tests to the test system.

• CTest Scripting
  Describes the scripting with CTest which can significantly simplify and automate testing and submitting dashboards.

• Generating Input Files For CTest
  Describe more in details the concepts behind testing with CTest and also explans how to use CTest without using CMake.

More Information

• Configuring CTest Submission Methods
• CTest Nightly, Experimental, Continuous, ...
• CTest:Coverage
• Media:CTest Running Modes.pdf
• CTest Frequently asked questions

CPack

Tutorials

• Packaging with CPack
  Introduction to CPack, installing and packaging of software.
• CPack Variables
  
• Supported package formats
  

More Information

• CPack Generator Information

---

CMake: [Welcome | Site Map]