LG

Outils pour utilisateurs

Outils du site

Piste :
prog:cmake

Différences

Ci-dessous, les différences entre deux révisions de la page.

Lien vers cette vue comparative

Les deux révisions précédentesRévision précédente
Prochaine révision		Révision précédente
prog:cmake [2024/04/05 11:21] – [Utiliser clang] : ajout du linker de clang rootprog:cmake [2025/12/11 10:36] (Version actuelle) – [Compilation] : précision sur les versions à installer de CMake root
Ligne 7: Ligne 7:
 ''sudo apt-get install libssl-dev''. ''sudo apt-get install libssl-dev''.
  
-Compilation+  * CMake préinstallé 
 + 
 +La compilation nécessite d'avoir un CMake d'installé.
  
 <code bash> <code bash>
 git clone https://gitlab.kitware.com/cmake/cmake git clone https://gitlab.kitware.com/cmake/cmake
 cd cmake cd cmake
-cmake -B build+cmake -B build -DCMAKE_USE_OPENSSL:BOOL=ON -DBUILD_TESTING:BOOL=OFF -DCMAKE_BUILD_TYPE=Release
 cmake --build build --parallel 16 cmake --build build --parallel 16
 sudo cmake --install build sudo cmake --install build
 </code> </code>
  
-La méthode de ''bootstrap'' n'est nécessaire que si on ne possède pas un cmake précompilé.+Suite des versions à installer : 3.6 > 3.13 > 3.31 > 4... 
 + 
 +  * Bootstrap 
 + 
 +La méthode ''bootstrap'' va télécharger un cmake précompilé, binaire qui peut ne pas être utilisable sur les vieilles distributions.
  
 [[https://www.scivision.dev/cmake-dev-build-tips/|Build CMake from dev sources]] {{ :prog:cmake:build_cmake_from_dev_sources_09_01_2023_15_51_22_.html |Archive du 01/03/2021 le 09/01/2023}} [[https://www.scivision.dev/cmake-dev-build-tips/|Build CMake from dev sources]] {{ :prog:cmake:build_cmake_from_dev_sources_09_01_2023_15_51_22_.html |Archive du 01/03/2021 le 09/01/2023}}
Ligne 43: Ligne 49:
 [[https://stackoverflow.com/questions/44284275/passing-compiler-options-cmake|Passing compiler options cmake]] {{ :prog:cmake:passing_compiler_options_cmake_-_stack_overflow_05_10_2022_11_12_25_.html |Archive du 31/05/2017 le 05/10/2022}} [[https://stackoverflow.com/questions/44284275/passing-compiler-options-cmake|Passing compiler options cmake]] {{ :prog:cmake:passing_compiler_options_cmake_-_stack_overflow_05_10_2022_11_12_25_.html |Archive du 31/05/2017 le 05/10/2022}}
 </WRAP> </WRAP>
 +
 +  * Effacer le cache et regénérer les CMakeLists.txt
 +
 +Il faut effacer le fichier ''CMakeCache.txt'' et le dossier ''CMakeFiles'' dans le dossier de compilation. Cela permet de conserver les binaires / fichiers objets déjà compilés.
 +
 +  * Options de debug de CMake
 +
 +Ajouter ''%%--warn-unitialized%%'' à la configuration pour vérifier si des variables CMake sont utilisées sans être initialisées.
  
   * Différences entre les générateurs   * Différences entre les générateurs
Ligne 52: Ligne 66:
 ''CMAKE_BUILD_TYPE'' est indispensable lors de la génération des CMakeLists.txt pour les générateurs mono-build. ''CMAKE_BUILD_TYPE'' est indispensable lors de la génération des CMakeLists.txt pour les générateurs mono-build.
  
-''%%--%%config'' est indispensable lors de la compilation pour les générateurs multi-build.+''%%--%%config'' est indispensable lors de la compilation pour les générateurs multi-build et l'utilisation de ''CMAKE_BUILD_TYPE'' est proscrit.
  
 ====Cross compilation pour Android==== ====Cross compilation pour Android====
Ligne 81: Ligne 95:
  
 <code cmake> <code cmake>
-add_library(Librairie sources.cpp sources.hpp CMakeLists.txt)+add_library(Librairie)
 add_library(NameSpace::Librairie ALIAS Librairie) add_library(NameSpace::Librairie ALIAS Librairie)
 set(Librairie_SRC ${CMAKE_CURRENT_SOURCE_DIR}/sources.cpp set(Librairie_SRC ${CMAKE_CURRENT_SOURCE_DIR}/sources.cpp
Ligne 180: Ligne 194:
 -DCMAKE_C_COMPILER=/usr/bin/clang -DCMAKE_CXX_COMPILER=/usr/bin/clang++ -DCMAKE_AR=/usr/bin/llvm-ar -DCMAKE_AS=/usr/bin/llvm-as -DCMAKE_RANLIB=/usr/bin/llvm-ranlib -DCMAKE_LINKER_TYPE=LLD -DCMAKE_C_COMPILER=/usr/bin/clang -DCMAKE_CXX_COMPILER=/usr/bin/clang++ -DCMAKE_AR=/usr/bin/llvm-ar -DCMAKE_AS=/usr/bin/llvm-as -DCMAKE_RANLIB=/usr/bin/llvm-ranlib -DCMAKE_LINKER_TYPE=LLD
 </code> </code>
 +
 +  * ''DWARF error: invalid or unhandled FORM value: 0x23''
 +
 +Ne pas spécifier ''CMAKE_LINKER_TYPE'' va entrainer cette erreur. [[https://github.com/llvm/llvm-project/issues/56994| C++17 leads to linker error with ld due to some strange debug info?]] {{ :prog:cmake:c_17_leads_to_linker_error_with_ld_due_to_some_strange_debug_info_issue_56994_llvm_llvm-project_5_31_2024_12_40_25_pm_.html |Archive du 08/08/2022 le 31/05/2024}}
 +
 +Sinon, il est aussi possible de mettre l'option de compilation ''-gdwarf-4'' pour les flags ''C'' et ''CXX''.
  
 ===FetchContent=== ===FetchContent===
Ligne 246: Ligne 266:
 </code> </code>
  
-====Cas spécifiques====+====Environnement de compilation et de sortie====
  
-===Exécuter une action qui n'est rattachée à aucun programme/target===+===Environnement de sortie===
  
-Il suffit de passer par une ''target'' intermédiaire.+<code cmake> 
 +if(WIN32) 
 +  set(OS "Windows") 
 +elseif(UNIX AND NOT APPLE) 
 +  set(OS "Linux/Unix") 
 +elseif(APPLE) 
 +  set(OS "macOS") 
 +else() 
 +  set(OS "Unknown") 
 +endif() 
 + 
 +if(CMAKE_SIZEOF_VOID_P EQUAL 8) 
 +  set(ARCHITECTURE "64-bit") 
 +elseif(CMAKE_SIZEOF_VOID_P EQUAL 4) 
 +  set(ARCHITECTURE "32-bit") 
 +else() 
 +  set(ARCHITECTURE "Unknown") 
 +endif() 
 +</code> 
 + 
 +====Exécution d'une commande==== 
 + 
 +===En passant par une nouvelle target===
  
 <code cmake> <code cmake>
-# On crée une target qui sera ajoutée à la commande make par défaut. +add_custom_target(clang_fmt ALL COMMAND xxxxxx)
-add_custom_target(clang_fmt ALL) +
-# On définir une commande à exécuter. +
-add_custom_command(TARGET clang_fmt COMMAND xxxxxx)+
 </code> </code>
  
-===Exécuter uniquement le préprocesseur===+===Associé une commande à une target existante===
  
-Il faut créer une target compilable en l'excluant de ''all''. Cela va créer des target intermédiaire, notamment ''xxx.cpp.i''. Il suffit alors de l'exécuter explicitement.+  * En passant par une target intermédiaire
  
 <code cmake> <code cmake>
-add_library(file_obj OBJECT EXCLUDE_FROM_ALL file.cpp) +add_custom_target(clang_fmt_dep COMMAND ...) 
-add_custom_target(file ALL COMMAND make file.cpp.i)+ 
 +add_dependencies(clang_fmt clang_fmt_dep)
 </code> </code>
  
-[[http://anadoxin.org/blog/generating-preprocessed-sources-in-cmake-projects.html|Generating preprocessed sources in CMake projects]] {{ :prog:cmake:generating_preprocessed_sources_in_cmake_projects_-_antek_s_tech_blog_2020-07-21_18_01_14_.html |Archive du 21/11/2018 le 21/07/2020}}+  * Sans passer par une target intermédiaire 
 + 
 +<code cmake> 
 +add_custom_command(TARGET clang_fmt PRE_BUILD COMMAND ...) 
 +</code> 
 + 
 +  * En passant par un fichier qui sera généré 
 + 
 +<code cmake> 
 +add_custom_command(OUTPUT file COMMAND ...) 
 + 
 +add_dependencies(clang_fmt file) 
 +</code> 
 + 
 +===Spécificité au générateur Visual Studio=== 
 + 
 +Normalement, une commande échoue si elle ne renvoie pas 0. 
 + 
 +Mais Visual Studio va également analyser la sortie standard. Si le contenu de la sortie standard est faussement considéré comme une erreur, il faut rediriger la sortie standard vers NUL. 
 + 
 +<code cmake> 
 +if(CMAKE_GENERATOR MATCHES "Visual Studio") 
 +  set(IGNORE_ERROR_IN_LOG ">" "NUL" "2>&1") 
 +else() 
 +  set(IGNORE_ERROR_IN_LOG "") 
 +endif() 
 + 
 +  add_custom_target(targ COMMAND ... ${IGNORE_ERROR_IN_LOG}) 
 +) 
 +</code> 
 + 
 +Ce problème peut se produire en lançant la commande ''python -m ensurepip'' car elle lance la sous-commande ''pip install'' et cette commande peut générer l'erreur : 
 + 
 +<code> 
 +"...\target.vcxproj" (default target) (5) -> 
 +(CustomBuild target) ->  
 +  CUSTOMBUILD : error : pip's dependency resolver does not currently take into account all the packages that are installed. This behaviour is the source of the following dependency conflicts. [...\target.vcxproj] 
 +  C:\Program Files\Microsoft Visual Studio\2022\Community\MSBuild\Microsoft\VC\v170\Microsoft.CppCommon.targets(254,5): error MSB8066: Custom build for '...\file.rule;...\target.rule;...\CMakeLists.txt' exited with code -1. [...\target.vcxproj] 
 + 
 +    15 Warning(s) 
 +    2 Error(s) 
 +</code>
  
 ===Dépendances dans un sous-dossier=== ===Dépendances dans un sous-dossier===
Ligne 324: Ligne 405:
   DESTINATION ${CMAKE_INSTALL_INCLUDEDIR}/${PROJECT_NAME}-${version})   DESTINATION ${CMAKE_INSTALL_INCLUDEDIR}/${PROJECT_NAME}-${version})
 </code> </code>
 +
 +====Divers====
 +
 +===Exécuter uniquement le préprocesseur===
 +
 +Il faut créer une target compilable en l'excluant de ''all''. Cela va créer des target intermédiaire, notamment ''xxx.cpp.i''. Il suffit alors de l'exécuter explicitement.
 +
 +<code cmake>
 +add_library(file_obj OBJECT EXCLUDE_FROM_ALL file.cpp)
 +add_custom_target(file ALL COMMAND make file.cpp.i)
 +</code>
 +
 +[[http://anadoxin.org/blog/generating-preprocessed-sources-in-cmake-projects.html|Generating preprocessed sources in CMake projects]] {{ :prog:cmake:generating_preprocessed_sources_in_cmake_projects_-_antek_s_tech_blog_2020-07-21_18_01_14_.html |Archive du 21/11/2018 le 21/07/2020}}
 +
  
 ====Tests==== ====Tests====
Ligne 445: Ligne 540:
    0x000000000000000f (RUNPATH)              Library rpath: [path1:path2:path3]    0x000000000000000f (RUNPATH)              Library rpath: [path1:path2:path3]
  
-Si les valeurs sont correctement remplies sous l'attribut ''RUNPATH'', il faut forcer l'utilisation de ''RPATH''. Ajouter au linker l'option ''%%-Wl,--disable-new-dtags%%''.+Si les valeurs sont correctement remplies sous l'attribut ''RUNPATH'', il faut forcer l'utilisation de ''RPATH''. Ajouter au linker l'option ''%%-Wl,--disable-new-dtags%%''. Sous Linux, cette option est globalement nécessaire si on compile avec une ''CMAKE_PREFIX_PATH'' qui contient plusieurs paths (comme l'indique la ligne précédente).
  
 <code cmake> <code cmake>
Ligne 471: Ligne 566:
 [[https://stackoverflow.com/questions/9298278/cmake-print-out-all-accessible-variables-in-a-script|CMake: Print out all accessible variables in a script]] {{ :prog:cmake:cmake_print_out_all_accessible_variables_in_a_script_-_stack_overflow_18_08_2022_14_09_34_.html |Archive du 15/02/2012 le 18/08/2022}} [[https://stackoverflow.com/questions/9298278/cmake-print-out-all-accessible-variables-in-a-script|CMake: Print out all accessible variables in a script]] {{ :prog:cmake:cmake_print_out_all_accessible_variables_in_a_script_-_stack_overflow_18_08_2022_14_09_34_.html |Archive du 15/02/2012 le 18/08/2022}}
  
-  * Afficher toutes les étapes, line par line, d'un run ''CMake'' (configuration uniquement)+  * Afficher toutes les étapes, ligne par ligne, d'un run ''CMake'' (configuration uniquement)
  
 Ajouter l'option ''%%--%%trace-expand''. Ajouter l'option ''%%--%%trace-expand''.
prog/cmake.1712308887.txt.gz · Dernière modification : de root