| CMake Tutorial | |
| ************** | |
| Introduction | |
| ============ | |
| The CMake tutorial provides a step-by-step guide that covers common build | |
| system issues that CMake helps address. Seeing how various topics all | |
| work together in an example project can be very helpful. | |
| Steps | |
| ===== | |
| .. include:: source.txt | |
| |tutorial_source| | |
| Each step has its own subdirectory containing code that may be used as a | |
| starting point. The tutorial examples are progressive so that each step | |
| provides the complete solution for the previous step. | |
| .. toctree:: | |
| :maxdepth: 2 | |
| A Basic Starting Point | |
| Adding a Library | |
| Adding Usage Requirements for a Library | |
| Adding Generator Expressions | |
| Installing and Testing | |
| Adding Support for a Testing Dashboard | |
| Adding System Introspection | |
| Adding a Custom Command and Generated File | |
| Packaging an Installer | |
| Selecting Static or Shared Libraries | |
| Adding Export Configuration | |
| Packaging Debug and Release | |
| .. | |
| Whenever a step above is renamed or removed, leave forwarding text in | |
| its original document file, and list it below to preserve old links | |
| to cmake.org/cmake/help/latest/ URLs. | |
| .. toctree:: | |
| :maxdepth: 1 | |
| :hidden: |