Wie richte ich ein CMake-Projekt korrekt ein?

Question

Während es leicht ist, Informationen über die Oberfläche zu finden, wie man CMake benutzt, scheint es sehr schwierig zu finden, wie man CMake korrekt benutzt. Wie sollten in einem CMake-Projekt von anständiger Größe (eine ausführbare Datei, eine oder mehrere statische Bibliotheken, die von dieser ausführbaren Datei verwendet werden, eine oder mehrere externe Abhängigkeiten, die von den statischen Bibliotheken verwendet werden) die Ordner und CMakeList.txt-Dateien bestellt werden? Welche CMakeList.txt-Dateien sollten welche Befehle haben?

Answer 1

Eine gute Möglichkeit, zu lernen, wie CMake effektiv zu nutzen, ist in anderen Projekten suchen. LLVM und seine Teilprojekte sind ein gutes Beispiel.

Im Allgemeinen konvertieren gute Codierpraktiken in gute CMake-Praktiken. Sie wollen Modularität, einen klaren Stil und Flexibilität.

Ein Beispiel hierfür könnte sein, Regeln für die Erstellung Ihrer ausführbaren Datei im Verzeichnis src zu haben, und dieses Ziel dann im Stammprojektordner zu verwenden. Etwas wie folgt aus:

-my_proj 
| 
----CMakeLists.txt //contains directives for top-level dependencies and linking, includes subfolders 
----src 
    | 
    ----CMakeLists.txt //contains definition of your main executable target 
    ----internal_lib 
     | 
     ----CMakeLists.txt //contains definition of your internal static libraries 

my_proj/CMakeLists.txt

add_subdirectory(src) 
find_package (Threads REQUIRED) #find pthreads package 
target_link_libraries (my_exe my_lib ${CMAKE_THREAD_LIBS_INIT}) #link against pthreads and my_lib 

my_proj/src/CMakeLists.txt

add_subdirectory(internal_lib) 
add_executable(my_exe my_source1.cpp mysource2.cpp) 

my_proj/src/internal_lib/CMakeLists.txt

add_library(my_lib my_lib_source1.cpp my_lib_source2.cpp) 

Answer 2

Ich hoffe, this tutorial ist genau das, was Sie brauchen, um mit einer CMake-Konfiguration für ein einfaches Projekt zu beginnen, das eine ausführbare Datei und mehrere Bibliotheken enthält - werfen Sie einen Blick darauf! Ich finde die CMake von Beispiel ohnehin die beste Möglichkeit CMake die einfache Möglichkeit, zu lernen:

mittels CMake mit ausführbaren Dateien

add_executable(myapp main.c) 

mittels CMake mit statischen Bibliotheken

add_library(test STATIC test.c) 

Verwendung von CMake mit dynamischen Bibliotheken

add_library(test SHARED test.c) 

Einbinden von Bibliotheken mit CMake ausführbaren

add_subdirectory(libtest_project) 

add_executable(myapp main.c) 

target_link_libraries(myapp test)