C++ និង CMake - បងប្អូនជារៀងរហូត វគ្គ II

នៅក្នុងផ្នែកមុន។ រឿងកម្សាន្តនេះនិយាយអំពីការរៀបចំបណ្ណាល័យបឋមកថានៅក្នុងម៉ាស៊ីនបង្កើតប្រព័ន្ធ CMake ។

លើកនេះយើងនឹងបន្ថែមបណ្ណាល័យដែលបានចងក្រងទៅវា ហើយក៏និយាយអំពីការភ្ជាប់ម៉ូឌុលជាមួយគ្នាផងដែរ។

ដូចពីមុនអ្នកដែលមិនចេះអត់ធ្មត់អាចភ្លាមៗ ទៅកាន់ឃ្លាំងដែលបានធ្វើបច្ចុប្បន្នភាព ហើយប៉ះអ្វីៗទាំងអស់ដោយដៃរបស់អ្នក។

មាតិកា

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