सी ++ और सीएमके - ब्रदर्स फॉरएवर, भाग II

इस मनोरंजक कहानी के पिछले हिस्से में , हमने CMake असेंबली सिस्टम जनरेटर के हिस्से के रूप में एक हेडर लाइब्रेरी के आयोजन के बारे में बात की।

इस बार हम इसमें एक संकलित पुस्तकालय जोड़ते हैं, और एक दूसरे के साथ मॉड्यूल के लेआउट के बारे में भी बात करते हैं।

पहले की तरह, जो इंतजार नहीं कर सकते, वे तुरंत अद्यतन भंडार में जा सकते हैं और अपने हाथों से सब कुछ छू सकते हैं।

सामग्री

1. विभाजन
2. जीत

विभाजन

हमारे उदात्त लक्ष्य को प्राप्त करने के लिए पहली बात यह है कि विकास के तहत सॉफ्टवेयर को सार्वभौमिक पृथक ब्लॉकों में विभाजित किया जाए जो उपयोगकर्ता के दृष्टिकोण से एक समान हों।

पहला भाग इस तरह के एक मानक ब्लॉक का वर्णन करता है - एक हेडर लाइब्रेरी के साथ एक परियोजना। अब हमारी परियोजना में एक संकलित पुस्तकालय जोड़ें।

ऐसा करने के लिए, हम एक .cpp फ़ाइल में myfunc फ़ंक्शन के कार्यान्वयन को निकालते हैं:

 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 लक्ष्य से जुड़ा myfeature स्वचालित रूप से लोड में mylib लक्ष्य प्राप्त myfeature ( कनेक्ट करने के तरीकों के बारे में अधिक )।

 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 फ़ंक्शन myfunc दिया गया 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::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 ।

 find_package(Mylib 1.0 REQUIRED) 

एक सबमॉड्यूल के रूप में कनेक्शन

एक अन्य विकल्प यह है कि add_subdirectory का उपयोग करके हमारे प्रोजेक्ट के साथ फ़ोल्डर को किसी अन्य प्रोजेक्ट के लिए एक प्रोजेक्ट के रूप में 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 लाइब्रेरी से libmyfeature आवश्यक हो। यदि पर्याप्त हेडर हैं, तो आपको Mylib::mylib लाइब्रेरी का उपयोग करना चाहिए।

उदाहरण के लिए सीएमके लक्ष्य मुश्किल हो सकते हैं, केवल कुछ गुणों, निर्भरता आदि को आगे बढ़ाने के लिए डिज़ाइन किया गया है। एक ही समय में, उनके साथ काम एक ही तरीके से होता है।

जिसे प्राप्त करना आवश्यक था।