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