cmake ट्यूटोरियल
Cmake के साथ शुरुआत करना

टिप्पणियों

संस्करण

CMake स्थापना

सीएमके डाउनलोड पृष्ठ पर जाएं और अपने ऑपरेटिंग सिस्टम, जैसे विंडोज, लिनक्स, या मैक ओएस एक्स के लिए एक बाइनरी प्राप्त करें। विंडोज पर डबल बाइनरी स्थापित करने के लिए क्लिक करें। लिनक्स पर बाइनरी को टर्मिनल से चलाते हैं।

लिनक्स पर, आप वितरण के पैकेज प्रबंधक से संकुल भी स्थापित कर सकते हैं। Ubuntu 16.04 पर आप कमांड-लाइन और ग्राफिकल एप्लिकेशन को इनस्टॉल कर सकते हैं:

sudo apt-get install cmake
sudo apt-get install cmake-gui

FreeBSD पर आप कमांड-लाइन और Qt- आधारित ग्राफ़िकल एप्लिकेशन को इनस्टॉल कर सकते हैं:

pkg install cmake
pkg install cmake-gui

मैक ओएसएक्स पर, यदि आप अपने सॉफ़्टवेयर को स्थापित करने के लिए उपलब्ध पैकेज प्रबंधकों में से एक का उपयोग करते हैं, तो सबसे उल्लेखनीय मैकप्रॉर्ट्स ( मैकपोर्ट्स ) और होमब्रे ( होमब्रे ), आप उनमें से एक के माध्यम से सीएमके भी स्थापित कर सकते हैं। उदाहरण के लिए, MacPorts के मामले में, निम्न टाइप करना

sudo port install cmake  

CMake स्थापित करेगा, जबकि यदि आप Homebrew पैकेज का उपयोग करते हैं तो आप टाइप करेंगे

brew install cmake

एक बार जब आप CMake स्थापित कर लेते हैं, तो आप निम्न कार्य करके आसानी से जांच कर सकते हैं

cmake --version

आपको निम्नलिखित के समान कुछ देखना चाहिए

cmake version 3.5.1

CMake suite maintained and supported by Kitware (kitware.com/cmake).

बिल्ड प्रकार, जैसे डिबग और रिलीज़ के बीच स्विच करना

CMake कई बिल्ड प्रकारों को जानता है, जो आमतौर पर डिफ़ॉल्ट कंपाइलर और लिंकर मापदंडों (जैसे कि डिबगिंग जानकारी बनाई जा रही है) या वैकल्पिक कोड पथ को प्रभावित करते हैं।

डिफ़ॉल्ट रूप से, CMake निम्नलिखित बिल्ड प्रकारों को संभालने में सक्षम है:

• डीबग : आमतौर पर क्लासिक डीबग बिल्ड जिसमें डीबगिंग जानकारी, कोई ऑप्टिमाइज़ेशन आदि शामिल नहीं है
• रिलीज़ : आपका कोई भी डिबगिंग जानकारी और पूर्ण अनुकूलन के साथ विशिष्ट रिलीज़ बिल्ड।
• RelWithDebInfo:: रिलीज के रूप में भी, लेकिन डिबगिंग जानकारी के साथ।
• MinSizeRel : आकार के लिए अनुकूलित एक विशेष रिलीज़ बिल्ड।

विन्यास कैसे संभाला जाता है यह उस जनरेटर पर निर्भर करता है जिसका उपयोग किया जा रहा है।

कुछ जनरेटर (जैसे विजुअल स्टूडियो) कई कॉन्फ़िगरेशन का समर्थन करते हैं। CMake एक ही बार में सभी कॉन्फ़िगरेशन उत्पन्न करेगा और आप IDE से या --config CONFIG ( cmake --build साथ) का उपयोग करके चुन सकते हैं कि आप कौन सा कॉन्फ़िगरेशन बनाना चाहते हैं। इन जनरेटरों के लिए CMake एक बिल्ड डायरेक्टरी स्ट्रक्चर तैयार करने की पूरी कोशिश करेगा, ताकि अलग-अलग कॉन्फ़िगरेशन की फाइलें एक-दूसरे पर कदम न रखें।

जनरेटर जो केवल एकल कॉन्फ़िगरेशन का समर्थन करते हैं (जैसे यूनिक्स मेकफाइल्स) अलग तरीके से काम करते हैं। यहां वर्तमान में सक्रिय कॉन्फ़िगरेशन CMake चर CMAKE_BUILD_TYPE के मान से निर्धारित CMAKE_BUILD_TYPE ।

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

cmake -DCMAKE_BUILD_TYPE=Debug path/to/source
cmake -DCMAKE_BUILD_TYPE=Release path/to/source

एक CMake स्क्रिप्ट को CMAKE_BUILD_TYPE खुद सेट करने से बचना चाहिए, क्योंकि यह आमतौर पर उपयोगकर्ताओं को ऐसा करने की ज़िम्मेदारी माना जाता है।

एकल-कॉन्फ़िगरेशन जनरेटर के लिए कॉन्फ़िगरेशन स्विच करने के लिए सीएमके को फिर से चलाना आवश्यक है। एक बाद के निर्माण के लिए पहले कॉन्फ़िगरेशन द्वारा उत्पादित ऑब्जेक्ट फ़ाइलों को अधिलेखित करने की संभावना है।

सरल "हैलो वर्ल्ड" प्रोजेक्ट

एक सी ++ स्रोत फ़ाइल को देखते हुए main.cpp एक निर्णायक main() समारोह, एक साथ CMakeLists.txt फ़ाइल (निम्नलिखित सामग्री के साथ) CMake हिदायत मौजूदा प्रणाली के लिए उपयुक्त बनाने के निर्देश पैदा करते हैं और डिफ़ॉल्ट C ++ कम्पाइलर करने के लिए होगा।

main.cpp ( C ++ हैलो वर्ल्ड उदाहरण )

#include <iostream>

int main()
{
    std::cout << "Hello World!\n";
    return 0;
}

CMakeLists.txt

cmake_minimum_required(VERSION 2.4)

project(hello_world)

add_executable(app main.cpp)

इसे कोलिरु पर लाइव देखें

1. cmake_minimum_required(VERSION 2.4) वर्तमान स्क्रिप्ट का मूल्यांकन करने के लिए आवश्यक न्यूनतम cmake_minimum_required(VERSION 2.4) निर्धारित करता है।

2. project(hello_world) एक नया CMake प्रोजेक्ट शुरू करता है। यह बहुत सारे आंतरिक सीएमके तर्क को ट्रिगर करेगा, विशेष रूप से डिफ़ॉल्ट सी और सी ++ कंपाइलर का पता लगाना।

3. साथ add_executable(app main.cpp) निर्माण लक्ष्य app बनाई गई है, जो वर्तमान सेटिंग के लिए कुछ डिफ़ॉल्ट झंडे के साथ विन्यस्त संकलक आह्वान एक निष्पादन संकलित करने के लिए होगा app दिए गए स्रोत फ़ाइल से main.cpp ।

कमांड लाइन (इन-सोर्स-बिल्ड, अनुशंसित नहीं)

> cmake .
...
> cmake --build .

cmake . कंपाइलर डिटेक्शन करता है, दिए गए CMakeLists.txt मूल्यांकन करता है . निर्देशिका और वर्तमान कार्यशील निर्देशिका में निर्मित वातावरण बनाता है।

cmake --build . आदेश आवश्यक निर्माण / कॉल करने के लिए एक अमूर्त है।

कमांड लाइन (आउट-ऑफ-सोर्स, अनुशंसित)

किसी भी निर्माण कलाकृतियों से अपने स्रोत कोड को साफ रखने के लिए आपको "आउट-ऑफ-सोर्स" बिल्ड करना चाहिए।

> mkdir build
> cd build
> cmake ..
> cmake --build .

या सीएमके ऊपर के उदाहरण से आपके प्लेटफार्मों के मूल आदेशों को भी सार कर सकते हैं:

> cmake -E make_directory build
> cmake -E chdir build cmake .. 
> cmake --build build 

"हैलो वर्ल्ड" कई स्रोत फ़ाइलों के साथ

पहले हम शीर्ष लेख फ़ाइलों की निर्देशिकाओं को include_directories() द्वारा निर्दिष्ट कर सकते हैं include_directories() , फिर हमें add_executable() द्वारा निष्पादन योग्य लक्ष्य की संगत स्रोत फ़ाइलों को निर्दिष्ट करने की आवश्यकता है, और सुनिश्चित करें कि स्रोत फ़ाइलों में एक main() फ़ंक्शन है।

निम्नलिखित एक सरल उदाहरण है, सभी फ़ाइलों को PROJECT_SOURCE_DIR निर्देशिका में रखा गया है।

main.cpp

#include "foo.h"

int main()
{
    foo();
    return 0;
}

foo.h

void foo();

foo.cpp

#include <iostream>
#include "foo.h"

void foo()
{
    std::cout << "Hello World!\n";
}

CMakeLists.txt

cmake_minimum_required(VERSION 2.4)

project(hello_world)

include_directories(${PROJECT_SOURCE_DIR})
add_executable(app main.cpp foo.cpp)  # be sure there's exactly one main() function in the source files

हम अपनी परियोजना के निर्माण के लिए उपरोक्त उदाहरण में उसी प्रक्रिया का पालन कर सकते हैं। फिर एक्जीक्यूटिंग app प्रिंट होगा

>./app
Hello World!

एक पुस्तकालय के रूप में "हैलो वर्ल्ड"

यह उदाहरण दिखाता है कि "हैलो वर्ल्ड" कार्यक्रम को एक पुस्तकालय के रूप में कैसे तैनात किया जाए और इसे अन्य लक्ष्यों के साथ कैसे जोड़ा जाए।

मान लें कि हमारे पास http://www.riptutorial.com/cmake/example/22391/-hello-world--with-multiple-source-files उदाहरण के समान स्रोत / हेडर फाइलें हैं। इसके बजाय कई स्रोत फ़ाइलों से निर्माण की, हम पहले तैनात कर सकते हैं foo.cpp का उपयोग करके एक पुस्तकालय के रूप में add_library() और बाद में साथ मुख्य कार्यक्रम के साथ यह जोड़ने target_link_libraries() ।

हम CMakeLists.txt को संशोधित करते हैं

cmake_minimum_required(VERSION 2.4)

project(hello_world)

include_directories(${PROJECT_SOURCE_DIR})
add_library(applib foo.cpp)
add_executable(app main.cpp)
target_link_libraries(app applib)

और उसी चरणों का पालन करते हुए, हम एक ही परिणाम प्राप्त करेंगे।