परिचय

यह लेख विभिन्न सॉफ्टवेयर उत्पादों को विकसित करने के लिए उपयोगिताओं के एक लचीले और बहुमुखी सेट का उपयोग करके सीएमके के परीक्षण और पैकेजिंग कार्यक्रमों के बारे में बताता है। यह दृढ़ता से अनुशंसा की जाती है कि आप सिंटैक्स को गलत समझने और सीएमके काम करने के तरीके से बचने के लिए मैनुअल के पहले और दूसरे हिस्सों को पढ़ें।

सीएमके लॉन्च

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

उदाहरण का परीक्षण करें

जैसा कि पहले उल्लेख किया गया है, CMake कार्यक्रमों के स्वत: परीक्षण का समर्थन करता है। इस सुविधा का उपयोग करना बहुत आसान है - बस कुछ आदेशों को सामान्य CMakeLists.txt , और फिर ctest का उपयोग करके परीक्षण ctest या make test । आपके निपटान में कार्यक्रमों के आउटपुट की जांच, स्मृति का गतिशील विश्लेषण और बहुत कुछ है।

हम एक विशिष्ट उदाहरण के साथ कार्यक्रम के परीक्षण की प्रक्रिया पर विचार करेंगे। Multiply.c स्रोत फ़ाइल में निम्न कोड है:

 #include <stdio.h> #include <stdlib.h> #define ARG_COUNT 3 int main(const int argc, const char *argv[]) { if (argc != ARG_COUNT) { fprintf(stderr, "Error!\n"); return EXIT_FAILURE; } const int first = atoi(argv[1]); const int second = atoi(argv[2]); printf("The result is: %d\n", first * second); return EXIT_SUCCESS; } 

यह कोड कंसोल के दो तर्कों को गुणा करने का परिणाम प्रदर्शित करता है। कृपया ध्यान दें कि एक त्रुटि की स्थिति भी संभव है यदि तर्क की वास्तविक संख्या अपेक्षित को संतुष्ट नहीं करती है: इस स्थिति में, त्रुटि त्रुटि स्ट्रीम में आउटपुट होगी Error! ।

उसी निर्देशिका में निर्माण प्रक्रिया के विवरण के साथ CMakeLists.txt फ़ाइल है, जिसमें नीचे दिए गए कोड हैं:

 cmake_minimum_required(VERSION 3.0) project(MyProgram) add_executable(Multiply Multiply.c) set(MULTIPLY_TIMEOUT 1) #   : enable_testing() #  : add_test(FirstTest Multiply 15 207) add_test(SecondTest Multiply -54 -785) add_test(ThirdTest Multiply 85234) #   : set_tests_properties(FirstTest SecondTest ThirdTest PROPERTIES TIMEOUT ${MULTIPLY_TIMEOUT}) set_tests_properties(FirstTest PROPERTIES PASS_REGULAR_EXPRESSION "The result is: 3105" FAIL_REGULAR_EXPRESSION "Error!") set_tests_properties(SecondTest PROPERTIES PASS_REGULAR_EXPRESSION "The result is: 42390" FAIL_REGULAR_EXPRESSION "Error!") set_tests_properties(ThirdTest PROPERTIES PASS_REGULAR_EXPRESSION "Error!") 

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

निम्नलिखित तीन add_test वर्तमान प्रोजेक्ट में परीक्षण जोड़ते हैं। इस कमांड का संक्षिप्त रूप पहले तर्क के रूप में परीक्षण का नाम लेता है, और बाद के तर्क परीक्षण चलाने के लिए एक शेल कमांड बनाते हैं।

set_tests_properties कमांड की एक श्रृंखला व्यक्तिगत परीक्षणों के व्यवहार को निर्धारित करती है। परीक्षण वस्तुओं की सूची के बाद, कीवर्ड PROPERTIES इस प्रकार हैं, गुणों की सूची की शुरुआत का संकेत देते हुए, फॉर्म < > < > और चयनित परीक्षणों के लिए सेट करें। उपलब्ध संपत्तियों की एक पूरी सूची यहां है ।

सभी परीक्षणों के लिए, अधिकतम निष्पादन समय TIMEOUT संपत्ति के साथ एक सेकंड के लिए सेट किया गया है, और फिर बाद के परीक्षणों के लिए, अपेक्षित आउटपुट PASS_REGULAR_EXPRESSION और FAIL_REGULAR_EXPRESSION साथ सेट किया गया है (उदाहरण के लिए, यदि नियमित अभिव्यक्ति The result is: 3105 मैच, तो FirstTest परीक्षण जारी है और यदि जारी है तो) अभिव्यक्ति के साथ Error! परीक्षण बंद हो जाता है और विफल माना जाता है)।

परीक्षण सक्षम करने के तरीके

enable_testing का एक एनालॉग है - यह include कमांड के माध्यम से CTest मॉड्यूल का समावेश है। सामान्य तौर पर, एक मॉड्यूल का समावेश अधिक सार्वभौमिक होता है, लेकिन उनके बीच अभी भी अंतर है।

enable_testing कमांड करंट डाइरेक्टरी के लिए और साथ ही बाद के सभी के लिए टेस्टिंग को सक्षम बनाता है। यह मूल CMakeLists.txt में स्थित होना चाहिए, क्योंकि CTest को विधानसभा की जड़ में एक परीक्षण फ़ाइल की उम्मीद है।

CTest मॉड्यूल को सक्षम करना CTest / CDash का उपयोग करके परीक्षण के लिए प्रोजेक्ट को कॉन्फ़िगर करता है, और स्वचालित रूप से BUILD_TESTING विकल्प भी निर्धारित करता है, जो परीक्षण के समय (डिफ़ॉल्ट ON ) सही है। इस प्रकार, इस कमांड का उपयोग करते समय, परीक्षण प्रक्रिया का इस तरह से वर्णन करना उचित है:

 if(BUILD_TESTING) add_test(FirstTest Test 1) add_test(SecondTest Test 2) add_test(ThirdTest Test 3) #  ... endif() 

परीक्षण निष्पादन

cmake . && cmake --build . && ctest . कमांड की एक श्रृंखला cmake . && cmake --build . && ctest . cmake . && cmake --build . && ctest . सभी तीन परीक्षण चलाए जाते हैं। ctest -R <RegularExpression> परीक्षणों का एक सेट निष्पादित करता है जो किसी दिए गए नियमित अभिव्यक्ति को संतुष्ट करता है। उदाहरण के लिए, ctest -R ThirdTest केवल तीसरा टेस्ट चलाता है।

पैकेजिंग उदाहरण

स्रोत फ़ाइलों, पुस्तकालयों और निष्पादन योग्य फ़ाइलों का एक पैकेज बनाने के लिए, आपको बस install कमांड का उपयोग करके आवश्यक फ़ाइलों की स्थापना का वर्णन करना होगा, और फिर include कमांड के CPack मॉड्यूल CPack सक्षम करना CPack :

 #    "Multiply"   "bin": install(TARGETS Multiply DESTINATION bin) #    : set(CPACK_PACKAGE_NAME "Multiply") set(CPACK_PACKAGE_VENDOR "MyCompany") set(CPACK_PACKAGE_CONTACT "https://myprojectsite.org") set(CPACK_DEBIAN_PACKAGE_MAINTAINER "mycontacts@gmail.com") set(CPACK_PACKAGE_DESCRIPTION "The most stupid program ever written") #    : set(CPACK_GENERATOR "DEB") #    "CPack": include(CPack) 

इस स्थिति में, install कमांड Multiply लक्ष्य इंस्टॉलेशन डायरेक्टरी के पैकेज जनरेटर को सूचित करता है। इंस्टॉलेशन कमांड्स लिखे बिना पैकेज जनरेशन संभव नहीं है।

निम्नलिखित कई चर सेट करके पैकेज की विशेषताओं को सूचीबद्ध करता है। वास्तव में, ऐसे कई चर हैं जो पैकेज को ठीक से पैकेज करते हैं। उनमें से अधिकांश वैकल्पिक हैं, लेकिन कुछ पैकेज जनरेटर को उनकी परिभाषा की आवश्यकता होती है। सभी पैकेज जनरेटर के लिए आम चर की एक सूची यहाँ उपलब्ध है ।

CPACK_GENERATOR चर की परिभाषा CPACK_GENERATOR - यह संकुल जनरेटर की एक सूची है जिसे cpack उपयोगिता द्वारा कहा जाता है। इस मामले में, यह मान DEB लेता है, इसलिए, अवलोकन अनुप्रयोग के रूट डायरेक्टरी में एक डेबियन पैकेज उत्पन्न होता है।

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

पैकिंग निष्पादन

cmake . && cmake --build . && cmake --build . --target package कमांड की एक श्रृंखला cmake . && cmake --build . && cmake --build . --target package cmake . && cmake --build . && cmake --build . --target package cmake . && cmake --build . && cmake --build . --target package_source पैकेज बाइनरी पैकेज और cmake . && cmake --build . && cmake --build . --target package_source कमांड बनाने के लिए चयनित जनरेटर को निष्पादित करने के लिए लॉन्च किया गया है cmake . && cmake --build . && cmake --build . --target package_source cmake . && cmake --build . && cmake --build . --target package_source cmake . && cmake --build . && cmake --build . --target package_source रूट निर्देशिका में एक स्रोत पैकेज उत्पन्न करता है।

समापन

इस बिंदु पर, CMake पूर्ण ट्यूटोरियल श्रृंखला समाप्त हो गई है। मुझे आशा है कि आपने बहुत सी उपयोगी सामग्री सीख ली है, साथ ही साथ अपने प्रोग्रामिंग कौशल में भी सुधार किया है। सौभाग्य है