C++ og CMake – brþdre for alltid, del II

C++ og CMake – brþdre for alltid, del II

I den forrige delen av denne fascinerende historien ble det snakket om organiseringen av en header-bibliotek innenfor CMake byggeverktĂžyet.

Denne gangen skal vi legge til et kompilert bibliotek, samt diskutere sammensetningen av moduler sammen.

Som fÞr kan de som ikke klarer Ä vente, gÄ direkte til det oppdaterte depotet og prÞve alt selv.


Innhold

  1. Del
  2. Styret

Del

Det fÞrste vi mÄ gjÞre for Ä oppnÄ vÄrt hÞye mÄl er Ä dele den utviklede programvaren i universelle isolerte blokker, som er ensartede fra brukerens synspunkt.

I fĂžrste del ble det beskrevet en slik standard blokk — et prosjekt med header-bibliotek. NĂ„ skal vi legge til et kompilert bibliotek i prosjektet vĂ„rt.

For dette skal vi flytte implementeringen av funksjonen myfunc til en egen .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

         ~  se 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;
+    }
+}

Deretter definerer vi det kompilert biblioteket (myfeature), som vil bestÄ av filen vi fikk fra forrige trinn. .cppDet nye biblioteket vil Äpenbart trenge de eksisterende headerne, og for Ä sÞrge for det, mÄ vi koble det til det eksisterende mÄlet mylib. Koblingen mellom dem er offentlig, hvilket betyr at alt som kobles til mÄlet myfeature, automatisk vil fÄ med seg ogsÄ mÄlet mylib (les mer om mÄter Ä knytte).

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)

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

Videre skal vi sÞrge for at det nye biblioteket ogsÄ blir installert 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 er viktig Ä merke seg at for mÄlet myfeature, som for mylib ble det opprettet et pseudonym med prefikset Mylib::. Det samme er angitt for begge mÄlene ved eksportering for installasjon i systemet. Dette gir en enhetlig mÄte Ä jobbe med mÄlene pÄ uansett koblingsskjema.

Etter dette gjenstÄr det Ä koble modulstestene til det nye biblioteket (funksjonen myfunc ble flyttet ut av overskriften, sÄ nÄ mÄ vi linke til den):

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
 )

Overskrifter (Mylib::mylib) trenger ikke lenger Ă„ bli inkludert separat, fordi, som allerede nevnt, de automatisk inkluderes sammen med biblioteket (Mylib::myfeature).

Og vi vil legge til et par nyanser for Ä sikre mÄling av dekning med hensyn til det nyankomne 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
     )

Det kan legges til flere biblioteker, kjÞrbare filer osv. Uansett hvordan de er knyttet sammen i prosjektet, er det kun det som er mÄlene som grensesnittet til modulen vÄr, altsÄ det som eksponeres offentlig.

Styret

NĂ„ har vi standard modulblokker, og vi kan styre dem: bygge dem til enhver kompleksitet, sett dem i systemet eller koble dem sammen i et enkelt byggesystem.

Installering i systemet

En av mĂ„tene Ă„ bruke modulen pĂ„ — installere modulen vĂ„r i systemet.

cmake --build vei/til/bygnings/katalog --target install

Etter dette kan den brukes i et annet prosjekt ved hjelp av kommandoen find_package.

find_package(Mylib 1.0 REQUIRED)

Kobling som undermodul

En annen mĂ„te — Ă„ koble mappen med prosjektet vĂ„rt til et annet prosjekt som en undermodul med kommandoen add_subdirectory.

Bruken

Koblingsmetodene er forskjellige, men resultatet er det samme. I begge tilfeller vil prosjektet som bruker modulen vÄr, ha tilgang til mÄlene. Mylib::myfeature og Mylib::mylib, som kan brukes, for eksempel, slik:

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

Spesifikt i vÄrt tilfelle mÄ biblioteket Mylib::myfeature knyttes nÄr man mÄ linke med biblioteket libmyfeature. Hvis det er nok overskrifter, er det bedre Ä bruke biblioteket Mylib::mylib.

CMake-mÄl kan vÊre lur, for eksempel beregnet kun for Ä videreformidle egenskaper, avhengigheter osv. Samtidig skjer arbeidet med dem pÄ en enhetlig mÄte.

Som var mÄlet.

Kilde: habr.com

KjĂžp pĂ„litelig hosting for nettsteder med DDoS-beskyttelse, VPS VDS-servere đŸ”„ KjĂžp pĂ„litelig hosting for nettsteder med DDoS-beskyttelse, VPS VDS-servere | ProHoster