C++ 및 CMake - 영원한 형제, XNUMX부

앞 부분에서 이 재미있는 이야기는 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 대상은 까다로울 수 있습니다. 동시에 그들은 같은 방식으로 작동합니다.

어느 것이 당신이 얻어야 할 것입니다.

출처 : habr.com