projtec:cmake
Differences
This shows you the differences between two versions of the page.
Both sides previous revisionPrevious revisionNext revision | Previous revisionNext revisionBoth sides next revision | ||
projtec:cmake [2017/01/25 19:55] – [Utilisation d'une bibliothèque interne] orel | projtec:cmake [2017/11/23 08:40] – [Tests Unitaires] orel | ||
---|---|---|---|
Line 1: | Line 1: | ||
======CMake ====== | ======CMake ====== | ||
+ | |||
+ | * https:// | ||
+ | * https:// | ||
+ | * https:// | ||
==== Hello World ==== | ==== Hello World ==== | ||
Line 18: | Line 22: | ||
<code text CMakeLists.txt> | <code text CMakeLists.txt> | ||
cmake_minimum_required(VERSION 2.6) | cmake_minimum_required(VERSION 2.6) | ||
- | project(HelloWorld) | + | project(HelloWorld |
add_executable(hello hello.c) | add_executable(hello hello.c) | ||
</ | </ | ||
- | Pour générer un Makefile et compiler notre projet, il faut taper les commandes suivantes : | + | Pour générer un Makefile et compiler notre projet |
cmake . | cmake . | ||
- | make # ou make VERBOSE=ON | + | make clean ; make |
+ | | ||
+ | make help # pour voir la liste des cibles possibles | ||
+ | Pour compiler "en dehors des sources" | ||
+ | |||
+ | mkdir build | ||
+ | cd build | ||
+ | cmake .. | ||
+ | make | ||
+ | | ||
+ | Un des avantages de cette méthode est quelle permet de ne pas mélanger les fichiers générés par CMake et Make avec les fichiers sources. Du coup, il suffit de supprimer le répertoire //build// pour tout nettoyer. | ||
==== Un peu plus compliqué ==== | ==== Un peu plus compliqué ==== | ||
Line 61: | Line 75: | ||
cmake_minimum_required (VERSION 2.6) | cmake_minimum_required (VERSION 2.6) | ||
project (HelloWorld C) | project (HelloWorld C) | ||
+ | |||
+ | set(CMAKE_BUILD_TYPE DEBUG) | ||
+ | set(CMAKE_VERBOSE_MAKEFILE ON) | ||
+ | set(CMAKE_C_COMPILER gcc) | ||
set(CMAKE_C_FLAGS " | set(CMAKE_C_FLAGS " | ||
set(CMAKE_INSTALL_PREFIX " | set(CMAKE_INSTALL_PREFIX " | ||
+ | |||
add_executable(hello hello.c pouet.c) | add_executable(hello hello.c pouet.c) | ||
target_link_libraries(hello m) | target_link_libraries(hello m) | ||
install(TARGETS hello RUNTIME DESTINATION bin) | install(TARGETS hello RUNTIME DESTINATION bin) | ||
</ | </ | ||
+ | |||
+ | Notons que CMake scanne automatiquement les dépendances (sans faire néanmoins de preprocessing). Il en résulte que la dépendance sur //pouet.h// est ajouté implicitement. | ||
Ensuite, on fait... | Ensuite, on fait... | ||
cmake . | cmake . | ||
- | make | + | make |
- | make install | + | make install |
+ | | ||
| | ||
==== Utilisation d'une bibliothèque interne ==== | ==== Utilisation d'une bibliothèque interne ==== | ||
- | Considérons maintenant le projet {{projtec: | + | Considérons maintenant le projet {{projtec: |
< | < | ||
Line 89: | Line 111: | ||
</ | </ | ||
- | (...) | + | Ce projet contient un éxecutable //hello// qui utilise la bibliothèque interne //mylib// définit par un second |
- | + | ||
- | <code C hello.c> | + | |
- | </code> | + | |
- | #include < | + | |
- | #include " | + | |
- | #include "mylib.h" | + | |
- | + | ||
- | int main() { | + | |
- | printf(" | + | |
- | pouet(); | + | |
- | mylib_foo(); | + | |
- | mylib_bar(); | + | |
- | return 0; | + | |
- | } | + | |
- | + | ||
- | </code> | + | |
- | + | ||
- | Voici donc le fichier | + | |
<code text CMakeLists.txt> | <code text CMakeLists.txt> | ||
Line 114: | Line 118: | ||
set(CMAKE_C_FLAGS " | set(CMAKE_C_FLAGS " | ||
set(CMAKE_INSTALL_PREFIX " | set(CMAKE_INSTALL_PREFIX " | ||
+ | include_directories(mylib) | ||
+ | # link_directories(mylib) | ||
add_executable(hello hello.c pouet.c) | add_executable(hello hello.c pouet.c) | ||
- | target_link_libraries(hello m) | + | target_link_libraries(hello m mylib) |
install(TARGETS hello RUNTIME DESTINATION bin) | install(TARGETS hello RUNTIME DESTINATION bin) | ||
+ | add_subdirectory(mylib) | ||
+ | </ | ||
+ | |||
+ | |||
+ | <code text mylib/ | ||
+ | add_library(mylib mylib.c) | ||
+ | install(TARGETS mylib ARCHIVE DESTINATION lib) | ||
+ | install(FILES mylib.h DESTINATION include) | ||
</ | </ | ||
Line 125: | Line 139: | ||
make install | make install | ||
+ | On trouve alors dans le répertoire //install// les fichiers suivants : | ||
- | ==== Biblio ==== | + | < |
+ | ├── bin | ||
+ | │ └── hello | ||
+ | ├── include | ||
+ | │ └── mylib.h | ||
+ | └── lib | ||
+ | └── libmylib.a | ||
+ | </ | ||
- | * https:// | + | ==== Tests Dynamiques ==== |
- | * https:// | + | |
- | * https:// | + | |
+ | On ajoute à notre projet un sous-répertoire //tests// pour vérifier les fonctions de //mylib// ({{projtec: | ||
+ | |||
+ | < | ||
+ | ├── CMakeLists.txt | ||
+ | ├── hello.c | ||
+ | ├── mylib | ||
+ | │ ├── CMakeLists.txt | ||
+ | │ ├── mylib.c | ||
+ | │ └── mylib.h | ||
+ | ├── pouet.c | ||
+ | ├── pouet.h | ||
+ | └── tests | ||
+ | ├── CMakeLists.txt | ||
+ | ├── test-mylib-bar.c | ||
+ | └── test-mylib-foo.c | ||
+ | </ | ||
+ | |||
+ | Voici le fichier //CMake// pour compiler et exécuter les tests. Par defaut, pour chaque test, CMake vérifie que le programme termine normalement (pas de signal SEGV par exemple ) et que la valeur de retour vaut EXIT_SUCCESS (0). On peut également rajouter d' | ||
+ | |||
+ | <code text tests/ | ||
+ | include(CTest) | ||
+ | enable_testing() | ||
+ | |||
+ | add_executable(test-mylib-foo test-mylib-foo.c) | ||
+ | target_link_libraries(test-mylib-foo mylib) | ||
+ | |||
+ | add_executable(test-mylib-bar test-mylib-bar.c) | ||
+ | target_link_libraries(test-mylib-bar mylib) | ||
+ | |||
+ | add_test(test1 test-mylib-foo) | ||
+ | set_tests_properties(test1 PROPERTIES PASS_REGULAR_EXPRESSION " | ||
+ | add_test(test2 test-mylib-bar) | ||
+ | set_tests_properties(test2 PROPERTIES PASS_REGULAR_EXPRESSION " | ||
+ | |||
+ | </ | ||
+ | |||
+ | Pour lancer les tests : | ||
+ | make test | ||
+ | |||
+ | |||
+ | Pour aller un peu plus loin, on peut lancer des tests de varification de la mémoire (memcheck) : | ||
+ | |||
+ | make ExperimentalMemCheck | ||
+ | | ||
+ | Ces tests se base sur la varaible MEMORYCHECK_COMMAND qui est par défault sur / | ||
+ | |||
+ | Pour aller encore plus loin... | ||
+ | |||
+ | <code text tests/ | ||
+ | cmake_minimum_required(VERSION 3.0) | ||
+ | |||
+ | option(ENABLE_DEBUG "debug options" | ||
+ | if(ENABLE_DEBUG) | ||
+ | set(CMAKE_C_FLAGS " | ||
+ | set(CMAKE_LD_FLAGS " | ||
+ | else() | ||
+ | set(CMAKE_C_FLAGS " | ||
+ | endif() | ||
+ | |||
+ | add_executable(foo foo.c) | ||
+ | |||
+ | include(CTest) | ||
+ | enable_testing() | ||
+ | |||
+ | add_test(test1 ./foo 2) | ||
+ | add_test(test2 ./foo 5) | ||
+ | </ | ||
+ | |||
+ | cmake . -DENABLE_DEBUG=ON | ||
+ | make test | ||
+ | make ExperimentalCoverage | ||
+ | more Testing/ | ||
+ | | ||
+ | __Nota Bene__ : Est-ce la bonne façon de faire ? Ne fait-il pas mieux utiliser CMAKE_C_FLAGS_DEBUG avec CMAKE_BUILD_TYPE. | ||
+ | |
projtec/cmake.txt · Last modified: 2024/03/18 15:06 by 127.0.0.1