C++ och CMake — bröder för alltid, del II

I den föregående delen av denna underhållande berättelse talades det om organisationen av en header-bibliotek inom ramen för CMake-byggsystemet.

Denna gång lägger vi till ett kompilera-bibliotek, och pratar om hur moduler ska kopplas samman.

Som tidigare, för de som inte kan vänta, kan ni omedelbart gå till det uppdaterade arkivet och utforska allt med egna händer.

Innehåll

1. Dela
2. Härska

Dela

Det första steget för att nå vårt höga mål är att dela den utvecklade mjukvaran i universella isolerade block, som är enhetliga sett ur användarens perspektiv.

I den första delen beskrev vi en sådan standardblock - ett projekt med en header-bibliotek. Nu lägger vi till ett kompilera-bibliotek i vårt projekt.

För detta kommer vi att flytta implementeringen av funktionen myfunc till en separat .cpp-fil:

diff --git a/include/mylib/myfeature.hpp b/include/mylib/myfeature.hpp
index 43db388..ba62b4f 100644
--- a/include/mylib/myfeature.hpp
+++ b/include/mylib/myfeature.hpp
@@ -46,8 +46,5 @@ namespace mylib

         ~  see mystruct
      * /
-    inline bool myfunc (mystruct)
-    {
-        return true;
-    }
+    bool myfunc (mystruct);
 }
diff --git a/src/mylib/myfeature.cpp b/src/mylib/myfeature.cpp
new file mode 100644
index 0000000..abb5004
--- /dev/null
+++ b/src/mylib/myfeature.cpp
@@ -0,0 +1,9 @@
+#include 
+
+namespace mylib
+{
+    bool myfunc (mystruct)
+    {
+        return true;
+    }
+}

Därefter definierar vi kompilera-biblioteket (myfeature), som kommer att bestå av den fil som ficks från föregående steg. .cppDet nya biblioteket behöver uppenbarligen redan existerande headers, och för att tillhandahålla detta kan och bör vi koppla det till den befintliga målet mylib. Kopplingen mellan dem är offentlig, vilket innebär att allt som kopplas till målet myfeature, automatiskt kommer att få med sig den målet mylib (läs mer om kopplingsmetoder).

diff --git a/CMakeLists.txt b/CMakeLists.txt
index 108045c..0de77b8 100644
--- a/CMakeLists.txt
+++ b/CMakeLists.txt
@@ -64,6 +64,17 @@ target_compile_features(mylib INTERFACE cxx_std_17)

 add_library(Mylib::mylib ALIAS mylib)

+###################################################################################################
+##
+##      Kompilera-bibliotek
+##
+###################################################################################################
+
+add_library(myfeature src/mylib/myfeature.cpp)
+target_link_libraries(myfeature PUBLIC mylib)
+
+add_library(Mylib::myfeature ALIAS myfeature)
+

Sedan gör vi så att det nya biblioteket också installeras i systemet:

@@ -72,7 +83,7 @@ add_library(Mylib::mylib ALIAS mylib)

 install(DIRECTORY include/mylib DESTINATION include)

-install(TARGETS mylib EXPORT MylibConfig)
+install(TARGETS mylib myfeature EXPORT MylibConfig)
 install(EXPORT MylibConfig NAMESPACE Mylib:: DESTINATION share/Mylib/cmake)

 include(CMakePackageConfigHelpers)

Det är viktigt att notera att för målet myfeature, liksom för mylib en pseudonym med prefixet Mylib::. Detsamma anges för båda målen när de exporteras för installation i systemet. Detta möjliggör enhetlig hantering av målen under alla bindningsscheman.

Efter detta återstår det att koppla samman modul-tester med det nya biblioteket (funktionen myfunc har flyttats från headern, så nu behöver vi länka):

diff --git a/test/CMakeLists.txt b/test/CMakeLists.txt
index 5620be4..bc1266c 100644
--- a/test/CMakeLists.txt
+++ b/test/CMakeLists.txt
@@ -4,7 +4,7 @@ add_executable(mylib-unit-tests test_main.cpp)
 target_sources(mylib-unit-tests PRIVATE mylib/myfeature.cpp)
 target_link_libraries(mylib-unit-tests
     PRIVATE
-        Mylib::mylib
+        Mylib::myfeature
         doctest::doctest
 )

Rubriker (Mylib::mylib) behöver nu inte kopplas separat, för som redan nämnts, kopplas de automatiskt ihop med biblioteket (Mylib::myfeature).

Och vi lägger till några detaljer för att säkerställa mätningar av täckningen med det nyligen tillkomna biblioteket:

@@ -15,11 +15,16 @@ if(MYLIB_COVERAGE AND GCOVR_EXECUTABLE)
     target_compile_options(mylib-unit-tests PRIVATE --coverage)
     target_link_libraries(mylib-unit-tests PRIVATE gcov)

+    target_compile_options(myfeature PRIVATE --coverage)
+    target_link_libraries(myfeature PRIVATE gcov)
+
     add_custom_target(coverage
         COMMAND
             ${GCOVR_EXECUTABLE}
-                --root=${PROJECT_SOURCE_DIR}/include/
-                --object-directory=${CMAKE_CURRENT_BINARY_DIR}
+                --root=${PROJECT_SOURCE_DIR}/
+                --filter=${PROJECT_SOURCE_DIR}/include
+                --filter=${PROJECT_SOURCE_DIR}/src
+                --object-directory=${PROJECT_BINARY_DIR}
         DEPENDS
             check
     )

Man kan lägga till fler bibliotek, körbara filer och så vidare. Det spelar ingen roll hur de är kopplade till varandra inom projektet. Det viktiga är bara vilka mål som är gränssnittet för vår modul, det vill säga de som är exponerade.

Härska

Nu har vi standardmoduler och vi kan kontrollera dem: skapa en struktur av valfri komplexitet av dem, installera dem i systemet eller länka dem samman inom en enda byggsystem.

Installation i systemet

Ett alternativ för att använda modulen är att installera vår modul i systemet.

cmake --build path/to/build/directory --target install

Efter detta kopplas den in i vilket annat projekt som helst med kommandot find_package.

find_package(Mylib 1.0 REQUIRED)

Koppling som en under-modul

Ett annat alternativ är att koppla mappen med vårt projekt till ett annat projekt som en under-modul med kommandot add_subdirectory.

Användning

Bindningsmetoderna är olika, men resultatet är detsamma. I båda fallen kommer målen som använder vår modul att vara tillgängliga i projektet Mylib::myfeature och Mylib::mylib, som kan användas till exempel så här:

add_executable(some_executable some.cpp sources.cpp)
target_link_libraries(some_executable PRIVATE Mylib::myfeature)

I vårt specifika fall biblioteket Mylib::myfeature måste kopplas in när det är nödvändigt att länka med biblioteket libmyfeature. Om det räcker med headerfiler, bör då biblioteket användas Mylib::mylib.

CMake-mål kan vara knepiga, till exempel avsedda endast för att vidarebefordra vissa egenskaper, beroenden och så vidare. Arbetet med dem sker på ett enhetligt sätt.

Det som krävdes att uppnå.

Källa: habr.com