C++ და CMake - ძმები სამუდამოდ, ნაწილი II

წინა ნაწილში ეს გასართობი ამბავი საუბრობდა სათაურის ბიბლიოთეკის ორგანიზებაზე CMake build სისტემის გენერატორის ფარგლებში.

ამჯერად მას დავამატებთ შედგენილ ბიბლიოთეკას და ასევე ვისაუბრებთ მოდულების ერთმანეთთან დაკავშირებაზე.

როგორც ადრე, მოუთმენელებს შეუძლიათ მაშინვე გადადით განახლებულ საცავში და შეეხეთ ყველაფერს საკუთარი ხელით.

ინფორმაციის

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