C++ आणि CMake - कायमचे भाऊ, भाग II

मागील भागात या मनोरंजक कथेने सीमेक बिल्ड सिस्टम जनरेटरमध्ये हेडर लायब्ररी आयोजित करण्याबद्दल सांगितले.

यावेळी आपण त्यात एक संकलित लायब्ररी जोडू, आणि मॉड्यूल एकमेकांशी जोडण्याबद्दल देखील बोलू.

पूर्वीप्रमाणे, जे अधीर आहेत ते लगेच करू शकतात अद्यतनित भांडारावर जा आणि आपल्या स्वत: च्या हातांनी सर्वकाही स्पर्श करा.

सामग्री

1. वाटणे
2. जिंकणे

वाटणे

आमचे उदात्त उद्दिष्ट साध्य करण्यासाठी पहिली गोष्ट म्हणजे आम्ही विकसित करत असलेल्या सॉफ्टवेअरचे सार्वत्रिक, वेगळ्या ब्लॉक्समध्ये विभाजन करणे जे वापरकर्त्याच्या दृष्टिकोनातून एकसमान आहेत.

पहिल्या भागात, अशा मानक ब्लॉकचे वर्णन केले गेले - हेडर लायब्ररीसह एक प्रकल्प. आता आपल्या प्रकल्पात एक संकलित लायब्ररी जोडू.

हे करण्यासाठी, फंक्शनची अंमलबजावणी करू myfunc वेगळ्या मध्ये .cpp-फाइल:

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 <mylib/myfeature.hpp>
+
+namespace mylib
+{
+    bool myfunc (mystruct)
+    {
+        return true;
+    }
+}

मग आम्ही संकलित करण्यासाठी लायब्ररी परिभाषित करतो (myfeature), ज्यामध्ये मागील चरणात मिळालेल्या गोष्टींचा समावेश असेल .cpp-फाइल. नवीन लायब्ररीला स्पष्टपणे विद्यमान शीर्षलेखांची आवश्यकता आहे आणि हे प्रदान करण्यासाठी, ते विद्यमान उद्देशाशी जोडले जाऊ शकते आणि असावे mylib. शिवाय, त्यांच्यातील कनेक्शन सार्वजनिक आहे, याचा अर्थ असा आहे की लक्ष्य जोडलेले असेल myfeature, स्वयंचलितपणे लोड आणि लक्ष्य प्राप्त होईल 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)

+###################################################################################################
+##
+##      Компилируемая библиотека
+##
+###################################################################################################
+
+add_library(myfeature src/mylib/myfeature.cpp)
+target_link_libraries(myfeature PUBLIC mylib)
+
+add_library(Mylib::myfeature ALIAS myfeature)
+

पुढे, आम्ही खात्री करू की नवीन लायब्ररी सिस्टमवर देखील स्थापित केली आहे:

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

हे लक्षात घ्यावे की हेतूसाठी myfeature, म्हणून mylib उपसर्ग असलेले उपनाव तयार केले Mylib::. सिस्टीमवर इन्स्टॉलेशनसाठी एक्सपोर्ट करताना दोन्ही उद्देशांसाठी समान लिहिले आहे. यामुळे कोणत्याही उद्दिष्टांसह एकसमान कार्य करणे शक्य होते बंधनकारक योजना.

यानंतर, फक्त युनिट चाचण्यांना नवीन लायब्ररी (कार्य myfunc शीर्षकातून काढले आहे, म्हणून आता तुम्हाला लिंक करणे आवश्यक आहे):

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
 )

मथळे (Mylib::mylib) आता तुम्हाला स्वतंत्रपणे कनेक्ट करण्याची आवश्यकता नाही, कारण आधीच नमूद केल्याप्रमाणे, ते लायब्ररीसह स्वयंचलितपणे कनेक्ट केलेले आहेत (Mylib::myfeature).

आणि नवीन आलेली लायब्ररी लक्षात घेऊन कव्हरेज मोजमाप सुनिश्चित करण्यासाठी काही बारकावे जोडूया:

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

तुम्ही आणखी लायब्ररी, एक्झिक्युटेबल इ. जोडू शकता. प्रकल्पात ते एकमेकांशी कसे जोडलेले आहेत हे महत्त्वाचे नाही. एकमेव महत्त्वाची गोष्ट म्हणजे कोणते लक्ष्य आमच्या मॉड्यूलचे इंटरफेस आहेत, म्हणजेच ते चिकटून राहतात.

जिंकणे

आता आमच्याकडे मानक ब्लॉक मॉड्यूल आहेत, आणि आम्ही त्यांच्यावर वर्चस्व गाजवू शकतो: त्यांना कोणत्याही जटिलतेच्या संरचनेत तयार करा, त्यांना सिस्टममध्ये स्थापित करा किंवा त्यांना एकाच असेंब्ली सिस्टममध्ये एकत्र जोडून.

सिस्टममध्ये स्थापना

मॉड्यूल वापरण्यासाठी पर्यायांपैकी एक म्हणजे आमचे मॉड्यूल सिस्टममध्ये स्थापित करणे.

cmake --build путь/к/сборочной/директории --target install

त्यानंतर, तो कमांड वापरून इतर कोणत्याही प्रकल्पाशी जोडला जातो find_package.

find_package(Mylib 1.0 REQUIRED)

सबमॉड्यूल म्हणून कनेक्शन

दुसरा पर्याय म्हणजे कमांड वापरून सबमॉड्यूल म्हणून आमच्या प्रोजेक्टसह फोल्डरला दुसऱ्या प्रोजेक्टशी जोडणे add_subdirectory.

वापरा

बंधनकारक पद्धती भिन्न आहेत, परंतु परिणाम समान आहे. दोन्ही प्रकरणांमध्ये, आमचे मॉड्यूल वापरून प्रोजेक्टमध्ये उद्दिष्टे उपलब्ध असतील Mylib::myfeature и Mylib::mylib, जे वापरले जाऊ शकते, उदाहरणार्थ, यासारखे:

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

विशेषतः आमच्या बाबतीत, लायब्ररी Mylib::myfeature जेव्हा लायब्ररीशी दुवा साधणे आवश्यक असेल तेव्हा कनेक्ट करणे आवश्यक आहे libmyfeature. पुरेसे शीर्षलेख असल्यास, लायब्ररी वापरणे फायदेशीर आहे Mylib::mylib.

CMake लक्ष्य अवघड असू शकतात, उदाहरणार्थ, केवळ काही गुणधर्म, अवलंबित्व इ. फॉरवर्ड करण्याच्या हेतूने. त्याच वेळी, त्यांच्याबरोबर काम करणे त्याच प्रकारे होते.

आम्हाला ते मिळवण्याची गरज होती.

स्त्रोत: www.habr.com