C++ ਅਤੇ CMake - ਹਮੇਸ਼ਾ ਲਈ ਭਰਾ, ਭਾਗ II

ਪਿਛਲੇ ਹਿੱਸੇ ਵਿੱਚ ਇਸ ਮਨੋਰੰਜਕ ਕਹਾਣੀ ਨੇ ਸੀਮੇਕ ਬਿਲਡ ਸਿਸਟਮ ਜਨਰੇਟਰ ਦੇ ਅੰਦਰ ਇੱਕ ਸਿਰਲੇਖ ਲਾਇਬ੍ਰੇਰੀ ਨੂੰ ਸੰਗਠਿਤ ਕਰਨ ਬਾਰੇ ਗੱਲ ਕੀਤੀ।

ਇਸ ਵਾਰ ਅਸੀਂ ਇਸ ਵਿੱਚ ਇੱਕ ਸੰਕਲਿਤ ਲਾਇਬ੍ਰੇਰੀ ਜੋੜਾਂਗੇ, ਅਤੇ ਇੱਕ ਦੂਜੇ ਨਾਲ ਮੋਡੀਊਲ ਜੋੜਨ ਬਾਰੇ ਵੀ ਗੱਲ ਕਰਾਂਗੇ।

ਪਹਿਲਾਂ ਵਾਂਗ, ਜੋ ਬੇਸਬਰੇ ਹਨ, ਉਹ ਤੁਰੰਤ ਕਰ ਸਕਦੇ ਹਨ ਅੱਪਡੇਟ ਰਿਪੋਜ਼ਟਰੀ 'ਤੇ ਜਾਓ ਅਤੇ ਹਰ ਚੀਜ਼ ਨੂੰ ਆਪਣੇ ਹੱਥਾਂ ਨਾਲ ਛੂਹੋ.

ਸਮੱਗਰੀ

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