C++ ו-CMake - אחים לנצח, חלק ב'

בחלק הקודם הסיפור המשעשע הזה דיבר על ארגון ספריית כותרות בתוך מחולל מערכת ה-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