C++ ja CMake – vennad igavesti, osa II

Eelmisest osast Antud huvitavas loos räägitakse pealkirja teegi korraldamisest CMake’i süsteemide kogumise generaatori raames.

Seekord lisame sellele kompileeritava teegi ning arutame moodulite omavahelist koostööd.

Nagu enne, saavad need, kes ei suuda oodata, kohe minna uuendatud repository’le ja kõike enda kätega katsuda.

Sisukord

1. Eralda
2. Valitse

Eralda

Esimene samm meie kõrge eesmärgi saavutamiseks on arendatava tarkvara jagamine universaalseteks isoleeritud plokkideks, mis on kasutaja seisukohalt ühtsed.

Esimeses osas kirjeldati sellist standardsel plokki – pealkirja teek. Nüüd lisame oma projekti kompileeritava teegi.

Selleks viime funktsiooni myfunc erakordsesse .cpp-faili:

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

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

Seejärel määratleme kompileeritava teegi (myfeature), mis koosneb eelmisest sammust saadud .cpp-failist. Uus teek vajab ilmselgelt olemasolevaid pealkirju, ja selle tagamiseks tuleb see siduda olemasoleva sihiga mylib. Samuti on nende vahel side avalik, mis tähendab, et kõik, mis on sihiga ühendatud, saab automaatselt ka sihtmärgi myfeaturerohkem sidumise viisidest mylib (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)+################################################################################################### +## +## Kompileeritav teek +## +################################################################################################### + +add_library(myfeature src/mylib/myfeature.cpp) +target_link_libraries(myfeature PUBLIC mylib) + +add_library(Mylib::myfeature ALIAS myfeature) +).

Järgmiseks teeme nii, et uus teek installitaks ka süsteemi:

@@ -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)

Tuleb tähele panna, et sihiks

, nagu ka myfeature, как и для mylib oli pseudonüüm, millele on lisatud eesliide Mylib::. Sama on määratud mõlema eesmärgi jaoks nende eksportimise ajal süsteemi installimiseks. See võimaldab ühtset tööd eesmärkidega igasuguste sidumise skeemide puhul.

Pärast seda tuleb moodulitestide ühendamine uue raamatukoguga (funktsioon myfunc viidi pealkirjast välja, nii et nüüd tuleb linkida):

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
 )

Pealkirjad (Mylib::mylib) ei vaja enam eraldi lisada, kuna nagu juba öeldud, lisatakse need automaatselt koos raamatukoguga (Mylib::myfeature).

Ja lisame paar nüanssi, et tagada katte mõõtmine uue raamatukogu arvestamisel:

@@ -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
     )

Saame lisada rohkem raamatukogusid, käivitatavaid faile jne. Sel juhul pole oluline, kuidas nad omavahel projektis on seotud. Oluline on ainult see, millised eesmärgid on meie mooduli liides, st need, mis on nähtavad väljapoole.

Valitse

Nüüd on meil standardse moodul-blokkide kogum ja me saame nende üle valitseda: koostada neist mis tahes keerukusega struktuuri, paigaldades need süsteemi või omavahel seondades loogilises kokkuleppes.

Süsteemi paigaldamine

Üks võimalus mooduli kasutamiseks on meie mooduli paigaldamine süsteemi.

cmake --build tee/kokku/panemise/direktor --target install

Pärast seda saab seda liita mis tahes teise projektiga käsu abil find_package.

find_package(Mylib 1.0 REQUIRED)

Lisamine alamsüsteemina

Teine võimalus on liita meie projekti kaust teise projekti alamsüsteemina käsu abil add_subdirectory.

Kasutamine

Sidumisviise on erinevaid, kuid tulemus on sama. Nii ühes kui teises olukorras on projekti, mis kasutab meie moodulit, kättesaadavad eesmärgid Mylib::myfeature ja Mylib::mylib, mida saab kasutada näiteks nii:

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

konkreetse teema puhul peame library Mylib::myfeature ühendama siis, kui on vajalik siduda raamatukogu libmyfeature. Kui piisab päistest, siis peaksime kasutama raamatukogu Mylib::mylib.

CMake'i sihid võivad olla nutikad, näiteks ainult selleks, et edastada mingeid omadusi, sõltuvusi jne. Samuti toimub nendega töötamine ühtses võtmes.

Mis oli vajalik saavutada.

Allikas: habr.com