CMake: Difference between revisions
From KitwarePublic
Jump to navigationJump to search
(move Developer Topics to top) |
(categorize "more information," put important parts up top, Success Stories section) |
||
| Line 7: | Line 7: | ||
==CMake == | ==CMake == | ||
=== Primary Resources - Look here first! === | |||
* Where can I [http://www.cmake.org/HTML/Download.html download CMake]? | |||
* [http://www.cmake.org/HTML/Documentation.html CMake Documentation] | |||
* [[CMake Useful Variables|Useful CMake Variables]] | |||
* [[CMake FAQ|CMake Frequently asked questions]] | |||
* [http://www.cmake.org/mailman/listinfo/cmake CMake Mailing List] | |||
=== Development Topics=== | === Development Topics=== | ||
* [[CMake:Install Commands|Using the CMake INSTALL() command]] | * [[CMake:Install Commands|Using the CMake INSTALL() command]] | ||
* [[CMake Platform Dependent Issues|Platform Dependent Issues]] | * [[CMake Platform Dependent Issues|Platform Dependent Issues]] | ||
| Line 19: | Line 25: | ||
* [[CMake:For CMake Hackers|For CMake Hackers]] | * [[CMake:For CMake Hackers|For CMake Hackers]] | ||
* [[CMake:Module Maintainers|Module Maintainers]] | * [[CMake:Module Maintainers|Module Maintainers]] | ||
* [[CMake Released Versions|Documentation for previous CMake releases]] | |||
===Tutorials=== | ===Tutorials=== | ||
* [http://www.cmake.org/HTML/Examples.html A Simple CMake Example] | |||
* [http://www.linuxjournal.com/article/6700 Cross-Platform Software Development Using CMake]<br>Tutorial that should get anybody up to speed with CMake | * [http://www.linuxjournal.com/article/6700 Cross-Platform Software Development Using CMake]<br>Tutorial that should get anybody up to speed with CMake | ||
| Line 55: | Line 64: | ||
* [http://www.eskilson.se/vcproj2cmake.rb vcproj2cmake.rb (requires Ruby)] Creates CMakeLists.txt files by extracting info from Visual Studio project files. | * [http://www.eskilson.se/vcproj2cmake.rb vcproj2cmake.rb (requires Ruby)] Creates CMakeLists.txt files by extracting info from Visual Studio project files. | ||
=== | ===Success Stories=== | ||
* [[CMake:Articles|Articles about CMake]] | * [[CMake:Articles|Articles about CMake]] | ||
* What are some [[CMake Projects|projects using CMake]]? | * What are some [[CMake Projects|projects using CMake]]? | ||
==CTest== | ==CTest== | ||
Revision as of 15:10, 30 July 2007
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
- Using the CMake INSTALL() command
- Platform Dependent Issues
- Cross compiling with CMake
- Performance Tips
- Various Editors / IDEs support
- Generator Specific Information
- Macros contributed by Users
- For CMake Hackers
- Module Maintainers
- Documentation for previous CMake releases
Tutorials
- 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.
- Qt with CMake Explains how to use CMake to build software with Qt4 and how to use it for Qt3 and KDE3 applications
- Chicken Scheme - is a Scheme-to-C compiler which supports all major C compilers and OSs. Its extensively commented build system is easy to understand and demonstrates many non-trivial CMake features, e.g. how to generate source files and executables that are needed by the build itself, how to use ADD_CUSTOM_COMMAND to drive languages other than C/C++ and more.
- How to use CMake with Eclipse - Short Tutorial that describes one way of setting up your project to work with Eclipse 3.3 and CDT 4.0, Better know as Eclipse Europa. These instructions are written with OS X /Linux in mind but should be applicable to Windows Operating Systems
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. This one has been used for converting the KDE buildsystem to CMake. It's specialized in converting KDE 4 and KDE 3, but works also for other projects.
- 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
- 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.
More Information
