🥇CMake और C++ हमेशा के लिए भाई हैं

विकास के दौरान, मुझे कंपाइलर बदलना, मोड बनाना, निर्भरता संस्करण बनाना, स्थैतिक विश्लेषण करना, प्रदर्शन मापना, कवरेज एकत्र करना, दस्तावेज़ तैयार करना आदि पसंद है। और मुझे वास्तव में सीएमके पसंद है क्योंकि यह मुझे वह सब कुछ करने की अनुमति देता है जो मैं चाहता हूं।

बहुत से लोग सीएमके की आलोचना करते हैं, और अक्सर इसके हकदार भी हैं, लेकिन अगर आप इसे देखें, तो सब कुछ इतना बुरा नहीं है, और हाल ही में बिल्कुल बुरा नहीऔर विकास की दिशा काफी सकारात्मक है।

इस नोट में, मैं आपको बताना चाहता हूं कि निम्नलिखित कार्यक्षमता प्राप्त करने के लिए सीएमके सिस्टम में सी++ में हेडर लाइब्रेरी को कैसे व्यवस्थित किया जाए:

विधानसभा;
ऑटोरन परीक्षण;
कोड कवरेज माप;
स्थापना;
ऑटो-दस्तावेज़ीकरण;
ऑनलाइन सैंडबॉक्स पीढ़ी;
स्थैतिक विश्लेषण.

जो कोई भी पहले से ही फायदे और सी-मेक को समझता है वह आसानी से ऐसा कर सकता है प्रोजेक्ट टेम्पलेट डाउनलोड करें और इसका प्रयोग शुरू करें.

अंदर से प्रोजेक्ट करें

परियोजना संरचना

.
├── CMakeLists.txt
├── README.en.md
├── README.md
├── doc
│   ├── CMakeLists.txt
│   └── Doxyfile.in
├── include
│   └── mylib
│       └── myfeature.hpp
├── online
│   ├── CMakeLists.txt
│   ├── mylib-example.cpp
│   └── wandbox.py
└── test
    ├── CMakeLists.txt
    ├── mylib
    │   └── myfeature.cpp
    └── test_main.cpp

हम मुख्य रूप से सीएमके स्क्रिप्ट को व्यवस्थित करने के तरीके के बारे में बात करेंगे, इसलिए उन पर विस्तार से चर्चा की जाएगी। बाकी फाइलों को कोई भी सीधे देख सकता है टेम्प्लेट प्रोजेक्ट पृष्ठ पर.

मुख्य CMake फ़ाइल (./CMakeLists.txt)

परियोजना की जानकारी

सबसे पहले, आपको सीएमके सिस्टम के आवश्यक संस्करण का अनुरोध करना होगा। सीएमके विकसित हो रहा है, विभिन्न स्थितियों में कमांड हस्ताक्षर और व्यवहार बदल रहे हैं। सीएमके को तुरंत यह समझने के लिए कि हम उससे क्या चाहते हैं, हमें इसके लिए अपनी आवश्यकताओं को तुरंत रिकॉर्ड करना होगा।

cmake_minimum_required(VERSION 3.13)

फिर हम अपना प्रोजेक्ट, उसका नाम, संस्करण, प्रयुक्त भाषाएँ आदि निर्दिष्ट करेंगे। (देखें। команду project).

इस मामले में हम भाषा का संकेत देते हैं CXX (और इसका मतलब C++ है) ताकि CMake को तनाव न हो और C भाषा कंपाइलर की खोज न हो (डिफ़ॉल्ट रूप से, CMake में दो भाषाएँ शामिल हैं: C और C++)।

project(Mylib VERSION 1.0 LANGUAGES CXX)

यहां आप तुरंत जांच सकते हैं कि क्या हमारा प्रोजेक्ट किसी अन्य प्रोजेक्ट में सबप्रोजेक्ट के रूप में शामिल है। इससे भविष्य में काफी मदद मिलेगी.

get_directory_property(IS_SUBPROJECT PARENT_DIRECTORY)

परियोजना विकल्प

हम दो विकल्प प्रदान करेंगे.

पहला विकल्प है MYLIB_TESTING - यूनिट परीक्षणों को अक्षम करने के लिए। यह आवश्यक हो सकता है यदि हम आश्वस्त हैं कि सब कुछ परीक्षणों के अनुरूप है, लेकिन हम केवल उदाहरण के लिए, अपने प्रोजेक्ट को स्थापित या पैकेज करना चाहते हैं। या हमारे प्रोजेक्ट को एक उपप्रोजेक्ट के रूप में शामिल किया गया है - इस मामले में, हमारे प्रोजेक्ट के उपयोगकर्ता को हमारे परीक्षण चलाने में कोई दिलचस्पी नहीं है। आप अपने द्वारा उपयोग की जाने वाली निर्भरताओं का परीक्षण नहीं करते हैं, है ना?

option(MYLIB_TESTING "Включить модульное тестирование" ON)

इसके अलावा हम एक अलग विकल्प बनाएंगे MYLIB_COVERAGE परीक्षणों द्वारा कोड कवरेज को मापने के लिए, लेकिन इसके लिए अतिरिक्त टूल की आवश्यकता होगी, इसलिए इसे स्पष्ट रूप से सक्षम करने की आवश्यकता होगी।

option(MYLIB_COVERAGE "Включить измерение покрытия кода тестами" OFF)

संकलन विकल्प

बेशक, हम कूल प्लस प्रोग्रामर हैं, इसलिए हम कंपाइलर से कंपाइल-टाइम डायग्नोस्टिक्स का अधिकतम स्तर चाहते हैं। एक भी चूहा फिसलेगा नहीं.

add_compile_options(
    -Werror

    -Wall
    -Wextra
    -Wpedantic

    -Wcast-align
    -Wcast-qual
    -Wconversion
    -Wctor-dtor-privacy
    -Wenum-compare
    -Wfloat-equal
    -Wnon-virtual-dtor
    -Wold-style-cast
    -Woverloaded-virtual
    -Wredundant-decls
    -Wsign-conversion
    -Wsign-promo
)

C++ भाषा मानक का पूर्ण अनुपालन करने के लिए हम एक्सटेंशन को भी अक्षम कर देंगे। वे CMake में डिफ़ॉल्ट रूप से सक्षम हैं।

if(NOT CMAKE_CXX_EXTENSIONS)
    set(CMAKE_CXX_EXTENSIONS OFF)
endif()

प्राथमिक लक्ष्य

हमारी लाइब्रेरी में केवल हेडर फ़ाइलें हैं, जिसका अर्थ है कि हमारे पास स्थिर या गतिशील लाइब्रेरी के रूप में कोई निकास नहीं है। दूसरी ओर, हमारी लाइब्रेरी को बाहरी रूप से उपयोग करने के लिए, इसे स्थापित करने की आवश्यकता है, इसे सिस्टम में पता लगाने योग्य होना चाहिए और आपके प्रोजेक्ट से कनेक्ट होना चाहिए, और साथ ही ये समान हेडर, साथ ही संभवतः कुछ अतिरिक्त भी, इसके साथ गुण जुड़े हुए हैं।

इस उद्देश्य के लिए, हम एक इंटरफ़ेस लाइब्रेरी बनाते हैं।

add_library(mylib INTERFACE)

हम हेडर को अपनी इंटरफ़ेस लाइब्रेरी से जोड़ते हैं।

सीएमके के आधुनिक, फैशनेबल, युवा उपयोग से तात्पर्य है कि हेडर, गुण इत्यादि। एक ही लक्ष्य के माध्यम से प्रेषित। इतना कहना काफी है target_link_libraries(target PRIVATE dependency), और सभी शीर्षलेख जो लक्ष्य से संबद्ध हैं dependency, लक्ष्य से संबंधित स्रोतों के लिए उपलब्ध होगा target. और आपको किसी की जरूरत नहीं है [target_]include_directories. इसे नीचे विश्लेषण में प्रदर्शित किया जाएगा यूनिट परीक्षणों के लिए सीएमके स्क्रिप्ट.

यह तथाकथित पर भी ध्यान देने योग्य है। выражения-генераторы: $<...>.

यह कमांड हमारे इंटरफ़ेस लाइब्रेरी के साथ आवश्यक हेडर को जोड़ता है, और यदि हमारी लाइब्रेरी उसी सीएमके पदानुक्रम के भीतर किसी भी लक्ष्य से जुड़ी है, तो निर्देशिका के हेडर इसके साथ जुड़े होंगे ${CMAKE_CURRENT_SOURCE_DIR}/include, और यदि हमारी लाइब्रेरी सिस्टम पर स्थापित है और कमांड का उपयोग करके किसी अन्य प्रोजेक्ट से जुड़ी है find_package, तो निर्देशिका से हेडर इसके साथ जुड़े होंगे include संस्थापन निर्देशिका के सापेक्ष.

target_include_directories(mylib INTERFACE
    $<BUILD_INTERFACE:${CMAKE_CURRENT_SOURCE_DIR}/include>
    $<INSTALL_INTERFACE:include>
)

आइए एक भाषा मानक स्थापित करें। निःसंदेह, सबसे आखिरी वाला। साथ ही, हम न केवल मानक को शामिल करते हैं, बल्कि इसे उन लोगों तक भी विस्तारित करते हैं जो हमारी लाइब्रेरी का उपयोग करेंगे। यह इस तथ्य के कारण प्राप्त होता है कि सेट संपत्ति की एक श्रेणी होती है INTERFACE (देखें। target_compile_features कमांड).

target_compile_features(mylib INTERFACE cxx_std_17)

आइए अपनी लाइब्रेरी के लिए एक उपनाम बनाएं। इसके अलावा, सुंदरता के लिए, यह एक विशेष "नेमस्पेस" में होगा। यह तब उपयोगी होगा जब हमारी लाइब्रेरी में विभिन्न मॉड्यूल दिखाई देंगे, और हम उन्हें एक-दूसरे से स्वतंत्र रूप से कनेक्ट करने जा रहे हैं। उदाहरण के लिए, जैसे बुस्टा में.

add_library(Mylib::mylib ALIAS mylib)

स्थापना

हमारे हेडर को सिस्टम में इंस्टॉल करना। यहां सब कुछ सरल है. हम कहते हैं कि सभी हेडर वाले फ़ोल्डर को डायरेक्टरी में जाना चाहिए include स्थापना स्थान के सापेक्ष.

install(DIRECTORY include/mylib DESTINATION include)

इसके बाद, हम बिल्ड सिस्टम को सूचित करते हैं कि हम तृतीय-पक्ष परियोजनाओं में कमांड को कॉल करने में सक्षम होना चाहते हैं find_package(Mylib) और एक लक्ष्य प्राप्त करें Mylib::mylib.

install(TARGETS mylib EXPORT MylibConfig)
install(EXPORT MylibConfig NAMESPACE Mylib:: DESTINATION share/Mylib/cmake)

अगले मंत्र को इस प्रकार समझना चाहिए। जब किसी तृतीय-पक्ष प्रोजेक्ट में हम कमांड को कॉल करते हैं find_package(Mylib 1.2.3 REQUIRED), और स्थापित लाइब्रेरी का वास्तविक संस्करण संस्करण के साथ असंगत होगा 1.2.3CMake स्वचालित रूप से एक त्रुटि उत्पन्न करेगा. यानी आपको मैन्युअली वर्जन ट्रैक करने की जरूरत नहीं पड़ेगी.

include(CMakePackageConfigHelpers)
write_basic_package_version_file("${PROJECT_BINARY_DIR}/MylibConfigVersion.cmake"
    VERSION
        ${PROJECT_VERSION}
    COMPATIBILITY
        AnyNewerVersion
)
install(FILES "${PROJECT_BINARY_DIR}/MylibConfigVersion.cmake" DESTINATION share/Mylib/cmake)

परीक्षण

यदि परीक्षण स्पष्ट रूप से उपयोग करके अक्षम हैं संगत विकल्प या हमारा प्रोजेक्ट एक सबप्रोजेक्ट है, यानी यह कमांड का उपयोग करके किसी अन्य सीएमके प्रोजेक्ट से जुड़ा है add_subdirectory, हम पदानुक्रम के साथ आगे नहीं बढ़ते हैं, और स्क्रिप्ट, जो परीक्षण उत्पन्न करने और चलाने के लिए आदेशों का वर्णन करती है, बस नहीं चलती है।

if(NOT MYLIB_TESTING)
    message(STATUS "Тестирование проекта Mylib выключено")
elseif(IS_SUBPROJECT)
    message(STATUS "Mylib не тестируется в режиме подмодуля")
else()
    add_subdirectory(test)
endif()

अभिलेख

उपप्रोजेक्ट के मामले में दस्तावेज़ीकरण भी उत्पन्न नहीं किया जाएगा।

if(NOT IS_SUBPROJECT)
    add_subdirectory(doc)
endif()

ऑनलाइन सैंडबॉक्स

इसी तरह, उपप्रोजेक्ट में ऑनलाइन सैंडबॉक्स भी नहीं होगा।

if(NOT IS_SUBPROJECT)
    add_subdirectory(online)
endif()

परीक्षण स्क्रिप्ट (परीक्षण/CMakeLists.txt)

परीक्षण

सबसे पहले, हम आवश्यक परीक्षण ढांचे के साथ एक पैकेज ढूंढते हैं (अपने पसंदीदा के साथ बदलें)।

find_package(doctest 2.3.3 REQUIRED)

आइए परीक्षणों के साथ अपनी निष्पादन योग्य फ़ाइल बनाएं। आमतौर पर मैं सीधे निष्पादन योग्य बाइनरी में केवल वही फ़ाइल जोड़ता हूं जिसमें फ़ंक्शन होगा main.

add_executable(mylib-unit-tests test_main.cpp)

और मैं फ़ाइलें जोड़ता हूं जिनमें परीक्षणों का वर्णन बाद में किया जाता है। लेकिन आपको ऐसा करने की ज़रूरत नहीं है.

target_sources(mylib-unit-tests PRIVATE mylib/myfeature.cpp)

हम निर्भरताएँ जोड़ते हैं। कृपया ध्यान दें कि हमने केवल उन्हीं CMake लक्ष्यों को अपनी बाइनरी से जोड़ा है जिनकी हमें आवश्यकता थी और कमांड को कॉल नहीं किया था target_include_directories. परीक्षण ढांचे से और हमारे से शीर्षक Mylib::mylib, साथ ही बिल्ड पैरामीटर (हमारे मामले में, यह C++ भाषा मानक है) इन लक्ष्यों के साथ आए।

target_link_libraries(mylib-unit-tests
    PRIVATE
        Mylib::mylib
        doctest::doctest
)

अंत में, हम एक डमी लक्ष्य बनाते हैं, जिसका "बिल्ड" परीक्षण चलाने के बराबर है, और इस लक्ष्य को डिफ़ॉल्ट बिल्ड में जोड़ते हैं (विशेषता इसके लिए जिम्मेदार है) ALL). इसका मतलब यह है कि डिफ़ॉल्ट बिल्ड परीक्षणों को चलाने के लिए ट्रिगर करता है, जिसका अर्थ है कि हम उन्हें चलाना कभी नहीं भूलेंगे।

add_custom_target(check ALL COMMAND mylib-unit-tests)

कवरेज

इसके बाद, यदि उपयुक्त विकल्प निर्दिष्ट किया गया है तो हम कोड कवरेज माप को सक्षम करते हैं। मैं विवरण में नहीं जाऊंगा, क्योंकि वे सीएमके की तुलना में कवरेज को मापने के लिए एक उपकरण से अधिक संबंधित हैं। केवल यह ध्यान रखना महत्वपूर्ण है कि परिणामों के आधार पर एक लक्ष्य बनाया जाएगा coverage, जिसके साथ कवरेज को मापना शुरू करना सुविधाजनक है।

find_program(GCOVR_EXECUTABLE gcovr)
if(MYLIB_COVERAGE AND GCOVR_EXECUTABLE)
    message(STATUS "Измерение покрытия кода тестами включено")

    target_compile_options(mylib-unit-tests PRIVATE --coverage)
    target_link_libraries(mylib-unit-tests PRIVATE gcov)

    add_custom_target(coverage
        COMMAND
            ${GCOVR_EXECUTABLE}
                --root=${PROJECT_SOURCE_DIR}/include/
                --object-directory=${CMAKE_CURRENT_BINARY_DIR}
        DEPENDS
            check
    )
elseif(MYLIB_COVERAGE AND NOT GCOVR_EXECUTABLE)
    set(MYLIB_COVERAGE OFF)
    message(WARNING "Для замеров покрытия кода тестами требуется программа gcovr")
endif()

दस्तावेज़ीकरण के लिए स्क्रिप्ट (doc/CMakeLists.txt)

डॉक्सिजन मिला.

find_package(Doxygen)

इसके बाद, हम जांचते हैं कि उपयोगकर्ता ने भाषा चर सेट किया है या नहीं। यदि हाँ, तो हम इसे नहीं छूते, यदि नहीं, तो हम रूसी लेते हैं। फिर हम डॉक्सीजन सिस्टम फ़ाइलों को कॉन्फ़िगर करते हैं। भाषा सहित सभी आवश्यक चर, कॉन्फ़िगरेशन प्रक्रिया के दौरान वहां जाते हैं (देखें)। команду configure_file).

फिर हम एक लक्ष्य बनाते हैं doc, जो दस्तावेज़ीकरण बनाना शुरू कर देगा। चूँकि विकास प्रक्रिया में दस्तावेज़ तैयार करना सबसे बड़ी आवश्यकता नहीं है, लक्ष्य डिफ़ॉल्ट रूप से सक्षम नहीं होगा; इसे स्पष्ट रूप से लॉन्च करना होगा।

if (Doxygen_FOUND)
    if (NOT MYLIB_DOXYGEN_LANGUAGE)
        set(MYLIB_DOXYGEN_LANGUAGE Russian)
    endif()
    message(STATUS "Doxygen documentation will be generated in ${MYLIB_DOXYGEN_LANGUAGE}")
    configure_file(Doxyfile.in Doxyfile)
    add_custom_target(doc COMMAND ${DOXYGEN_EXECUTABLE} ${CMAKE_CURRENT_BINARY_DIR}/Doxyfile)
endif ()

ऑनलाइन सैंडबॉक्स के लिए स्क्रिप्ट (online/CMakeLists.txt)

यहां हम तीसरा पायथन ढूंढते हैं और एक लक्ष्य बनाते हैं wandbox, जो सेवा एपीआई के अनुरूप एक अनुरोध उत्पन्न करता है वैंडबॉक्स, और उसे विदा कर देता है। प्रतिक्रिया तैयार सैंडबॉक्स के लिंक के साथ आती है।

find_program(PYTHON3_EXECUTABLE python3)
if(PYTHON3_EXECUTABLE)
    set(WANDBOX_URL "https://wandbox.org/api/compile.json")

    add_custom_target(wandbox
        COMMAND
            ${PYTHON3_EXECUTABLE} wandbox.py mylib-example.cpp "${PROJECT_SOURCE_DIR}" include |
            curl -H "Content-type: application/json" -d @- ${WANDBOX_URL}
        WORKING_DIRECTORY
            ${CMAKE_CURRENT_SOURCE_DIR}
        DEPENDS
            mylib-unit-tests
    )
else()
    message(WARNING "Для создания онлайн-песочницы требуется интерпретатор ЯП python 3-й версии")
endif()

बाहर प्रोजेक्ट करें

अब आइए देखें कि इन सबका उपयोग कैसे किया जाए।

सभा

सीएमके बिल्ड सिस्टम पर किसी भी अन्य प्रोजेक्ट की तरह, इस प्रोजेक्ट के निर्माण में दो चरण होते हैं:

पीढ़ी

cmake -S путь/к/исходникам -B путь/к/сборочной/директории [опции ...]

यदि सीएमके के पुराने संस्करण के कारण उपरोक्त आदेश काम नहीं करता है, तो हटाने का प्रयास करें -S:
cmake путь/к/исходникам -B путь/к/сборочной/директории [опции ...]

विकल्पों के बारे में अधिक जानकारी.

परियोजना का निर्माण

cmake --build путь/к/сборочной/директории [--target target]

असेंबली लक्ष्यों के बारे में अधिक जानकारी.

विकल्प

MYLIB_कवरेज

cmake -S ... -B ... -DMYLIB_COVERAGE=ON [прочие опции ...]

लक्ष्य शामिल है coverage, जिसके साथ आप परीक्षणों द्वारा कोड कवरेज को मापना शुरू कर सकते हैं।

MYLIB_परीक्षण

cmake -S ... -B ... -DMYLIB_TESTING=OFF [прочие опции ...]

यूनिट परीक्षण निर्माण और लक्ष्य को अक्षम करने की क्षमता प्रदान करता है check. परिणामस्वरूप, परीक्षणों द्वारा कोड कवरेज का मापन बंद हो जाता है (देखें)। MYLIB_COVERAGE).

यदि प्रोजेक्ट कमांड का उपयोग करके सबप्रोजेक्ट के रूप में किसी अन्य प्रोजेक्ट से जुड़ा है तो परीक्षण भी स्वचालित रूप से अक्षम हो जाता है add_subdirectory.

MYLIB_DOXYGEN_LANGUAGE

cmake -S ... -B ... -DMYLIB_DOXYGEN_LANGUAGE=English [прочие опции ...]

लक्ष्य द्वारा तैयार किए गए दस्तावेज़ की भाषा बदल देता है doc दिए गए को. उपलब्ध भाषाओं की सूची के लिए देखें डॉक्सीजन सिस्टम वेबसाइट.

रूसी डिफ़ॉल्ट रूप से सक्षम है.

विधानसभा लक्ष्य

По умолчанию

cmake --build path/to/build/directory
cmake --build path/to/build/directory --target all

यदि लक्ष्य निर्दिष्ट नहीं है (जो लक्ष्य के समतुल्य है all), वह सब कुछ एकत्र करता है जो वह कर सकता है, और लक्ष्य को कॉल भी करता है check.

मायलिब-यूनिट-परीक्षण

cmake --build path/to/build/directory --target mylib-unit-tests

इकाई परीक्षण संकलित करता है। डिफ़ॉल्ट रूप से सक्षम.

चेक

cmake --build путь/к/сборочной/директории --target check

एकत्रित (एकत्रित, यदि पहले से नहीं तो) इकाई परीक्षण चलाता है। डिफ़ॉल्ट रूप से सक्षम.

См. также mylib-unit-tests.

व्याप्ति

cmake --build путь/к/сборочной/директории --target coverage

प्रोग्राम का उपयोग करके परीक्षणों द्वारा कोड कवरेज के लिए चल रहे यूनिट परीक्षणों का विश्लेषण करता है (यदि पहले से नहीं है तो चलाता है)। gcovr.

कोटिंग एग्जॉस्ट कुछ इस तरह दिखेगा:

------------------------------------------------------------------------------
                           GCC Code Coverage Report
Directory: /path/to/cmakecpptemplate/include/
------------------------------------------------------------------------------
File                                       Lines    Exec  Cover   Missing
------------------------------------------------------------------------------
mylib/myfeature.hpp                            2       2   100%   
------------------------------------------------------------------------------
TOTAL                                          2       2   100%
------------------------------------------------------------------------------

लक्ष्य केवल तभी उपलब्ध होता है जब विकल्प सक्षम होता है MYLIB_COVERAGE.

См. также check.

डॉक्टर

cmake --build путь/к/сборочной/директории --target doc

सिस्टम का उपयोग करके कोड दस्तावेज़ तैयार करना प्रारंभ करता है Doxygen.

wandbox

cmake --build путь/к/сборочной/директории --target wandbox

सेवा की प्रतिक्रिया कुछ इस तरह दिखती है:

{
    "permlink" :    "QElvxuMzHgL9fqci",
    "status" :  "0",
    "url" : "https://wandbox.org/permlink/QElvxuMzHgL9fqci"
}

इसके लिए सेवा का उपयोग किया जाता है वैंडबॉक्स. मुझे नहीं पता कि उनके सर्वर कितने लचीले हैं, लेकिन मुझे लगता है कि इस अवसर का दुरुपयोग नहीं किया जाना चाहिए।

उदाहरण

कवरेज माप के साथ डिबग मोड में प्रोजेक्ट बनाएं

cmake -S путь/к/исходникам -B путь/к/сборочной/директории -DCMAKE_BUILD_TYPE=Debug -DMYLIB_COVERAGE=ON
cmake --build путь/к/сборочной/директории --target coverage --parallel 16

प्रारंभिक संयोजन और परीक्षण के बिना एक परियोजना स्थापित करना

cmake -S путь/к/исходникам -B путь/к/сборочной/директории -DMYLIB_TESTING=OFF -DCMAKE_INSTALL_PREFIX=путь/к/установойной/директории
cmake --build путь/к/сборочной/директории --target install

किसी दिए गए कंपाइलर के साथ रिलीज़ मोड में निर्माण करें

cmake -S путь/к/исходникам -B путь/к/сборочной/директории -DCMAKE_BUILD_TYPE=Release -DCMAKE_CXX_COMPILER=g++-8 -DCMAKE_PREFIX_PATH=путь/к/директории/куда/установлены/зависимости
cmake --build путь/к/сборочной/директории --parallel 4

अंग्रेजी में दस्तावेज़ तैयार करना

cmake -S путь/к/исходникам -B путь/к/сборочной/директории -DCMAKE_BUILD_TYPE=Release -DMYLIB_DOXYGEN_LANGUAGE=English
cmake --build путь/к/сборочной/директории --target doc

उपकरण

सीएमके 3.13

वास्तव में, सीएमके संस्करण 3.13 को केवल इस सहायता में वर्णित कुछ कंसोल कमांड चलाने के लिए आवश्यक है। सीएमके स्क्रिप्ट के सिंटैक्स के दृष्टिकोण से, यदि पीढ़ी को अन्य तरीकों से बुलाया जाता है तो संस्करण 3.8 पर्याप्त है।
परीक्षण पुस्तकालय सबसे अच्छा

परीक्षण अक्षम किया जा सकता है (देखें опцию MYLIB_TESTING).
Doxygen

जिस भाषा में दस्तावेज़ तैयार किया जाएगा उसे बदलने के लिए एक विकल्प प्रदान किया गया है MYLIB_DOXYGEN_LANGUAGE.
भाषा दुभाषिया अजगर 3

स्वचालित पीढ़ी के लिए ऑनलाइन सैंडबॉक्स.

स्थैतिक विश्लेषण

सीएमके और कुछ अच्छे टूल के साथ, आप न्यूनतम प्रयास के साथ स्थैतिक विश्लेषण प्रदान कर सकते हैं।

सीपीपीचेक

सीएमके में स्थैतिक विश्लेषण उपकरण के लिए अंतर्निहित समर्थन है सीपीपीचेक.

ऐसा करने के लिए आपको विकल्प का उपयोग करना होगा CMAKE_CXX_CPPCHECK:

cmake -S путь/к/исходникам -B путь/к/сборочной/директории -DCMAKE_BUILD_TYPE=Debug -DCMAKE_CXX_CPPCHECK="cppcheck;--enable=all;-Iпуть/к/исходникам/include"

इसके बाद, हर बार स्रोत संकलित और पुन: संकलित होने पर स्थैतिक विश्लेषण स्वचालित रूप से लॉन्च किया जाएगा। कुछ भी अतिरिक्त करने की जरूरत नहीं है.

बजना

एक अद्भुत टूल की मदद से scan-build आप कुछ ही समय में स्थैतिक विश्लेषण भी चला सकते हैं:

scan-build cmake -S путь/к/исходникам -B путь/к/сборочной/директории -DCMAKE_BUILD_TYPE=Debug
scan-build cmake --build путь/к/сборочной/директории

यहां, Cppcheck के मामले के विपरीत, आपको हर बार बिल्ड को चलाने की आवश्यकता होती है scan-build.

अंतभाषण

सीएमके एक बहुत शक्तिशाली और लचीली प्रणाली है जो आपको हर स्वाद और रंग के लिए कार्यक्षमता लागू करने की अनुमति देती है। और, हालांकि वाक्य-विन्यास कभी-कभी वांछित नहीं होता है, शैतान अभी भी उतना भयानक नहीं है जितना उसे चित्रित किया गया है। समाज और स्वास्थ्य के लाभ के लिए सीएमके बिल्ड सिस्टम का उपयोग करें।

→ प्रोजेक्ट टेम्पलेट डाउनलोड करें

स्रोत: www.habr.com

CMake और C++ हमेशा से भाई हैं