CMake

CMake

Introduction

CMake est un générateur de système de build multiplateforme et open source. Pour une documentation complète, visitez la page d'accueil de CMake et la page de documentation de CMake. Le wiki de la communauté CMake référence également des guides et des recettes utiles.

CMake est maintenu et pris en charge par Kitware et développé en collaboration avec une communauté productive de contributeurs.

Licence

CMake est distribué sous la licence BSD à 3 clauses approuvée par l'OSI. Voir Copyright.txt pour plus de détails.

Construire CMake

Plateformes prises en charge

• Microsoft Windows

• Apple macOS

• Linux

• GratuitBSD

• OpenBSD

• Solaris

• AIX

D'autres systèmes d'exploitation de type UNIX peuvent également fonctionner immédiatement, sinon le portage de CMake sur cette plate-forme ne devrait pas poser de problème majeur. Veuillez publier sur le forum CMake Discourse pour demander si d'autres ont eu de l'expérience avec la plateforme.

Construire CMake avec CMake

Vous pouvez créer CMake comme n'importe quel autre projet avec un système de construction basé sur CMake : exécutez un CMake déjà installé sur cette arborescence source avec votre générateur et vos options préférés. Ensuite, construisez-le et installez-le.

Pour créer la documentation, installez Sphinx et configurez CMake avec -DSPHINX_HTML=ON et/ou -DSPHINX_MAN=ON pour activer le générateur "html" ou "man". Ajoutez -DSPHINX_EXECUTABLE=/path/to/sphinx-build si l'outil n'est pas trouvé automatiquement.

Pour exécuter la suite de tests, exécutez ctest dans le répertoire de construction CMake après la construction. Consultez le Guide de test CMake pour plus de détails.

Construire CMake à partir de zéro

UNIX/Mac OSX/MinGW/MSYS/Cygwin

Vous devez disposer d'un compilateur C++ (prenant en charge C++11) et d'un make installé. Exécutez le script bootstrap que vous trouvez dans le répertoire source de CMake. Vous pouvez utiliser l'option --help pour voir les options prises en charge. Vous pouvez utiliser l'option --prefix= pour spécifier un répertoire d'installation personnalisé pour CMake. Une fois l’opération terminée avec succès, exécutez make et make install .

Par exemple, si vous souhaitez simplement compiler et installer CMake à partir des sources, vous pouvez compiler directement dans l'arborescence des sources :

 $ ./bootstrap && make && sudo make install

Ou, si vous envisagez de développer CMake ou d'exécuter la suite de tests, créez une arborescence de construction distincte :

 $ mkdir construire && cd construire
$ ../bootstrap && faire

Fenêtres

Il existe deux manières de créer CMake sous Windows :

1. Compilez avec MSVC à partir de VS 2015 ou version ultérieure. Vous devez télécharger et installer une version binaire de CMake. Vous pouvez obtenir ces versions sur la page de téléchargement de CMake. Suivez ensuite les instructions ci-dessus pour créer CMake avec CMake.

2. Bootstrap avec MinGW sous MSYS2. Téléchargez et installez MSYS2. Installez ensuite les outils de build requis :

    $ pacman -S --nécessaire git base-devel mingw-w64-x86_64-gcc

   et bootstrap comme ci-dessus.

Signaler des bogues

Si vous avez trouvé un bug :

1. Si vous disposez d'un correctif, veuillez lire le document CONTRIBUTING.rst.

2. Sinon, veuillez publier sur le forum CMake Discourse et poser des questions sur les comportements attendus et observés pour déterminer s'il s'agit vraiment d'un bug.

3. Enfin, si le problème n'est pas résolu par les étapes ci-dessus, ouvrez une entrée dans CMake Issue Tracker.

Contribuer

Voir CONTRIBUTING.rst pour les instructions pour contribuer.