C++ और Bazel

7.3 · 7.2 · 7.1 · 7.0 · 6.5

इस पेज पर ऐसे संसाधन मौजूद हैं जिनसे आपको C++ प्रोजेक्ट के साथ Bazel का इस्तेमाल करने में मदद मिलती है. यह Bazel की मदद से C++ प्रोजेक्ट बनाने के बारे में ट्यूटोरियल, बिल्ड नियमों, और अन्य जानकारी से लिंक करता है.

Bazel का इस्तेमाल करना

नीचे दिए गए संसाधनों की मदद से, C++ प्रोजेक्ट पर Basel के साथ काम करने में मदद मिलेगी:

सबसे सही तरीके

Basel के सामान्य सबसे सही तरीकों के अलावा, यहां C++ प्रोजेक्ट के लिए खास तौर पर बने सबसे सही तरीके दिए गए हैं.

BUILD फ़ाइलें

अपनी BUILD फ़ाइलें बनाते समय इन दिशा-निर्देशों का पालन करें:

  • हर BUILD फ़ाइल में, डायरेक्ट्री में मौजूद हर कंपाइलेशन यूनिट के लिए एक cc_library नियम टारगेट होना चाहिए.

  • आपको अपनी C++ लाइब्रेरी को ज़्यादा से ज़्यादा बारीकी से बड़ा करना चाहिए, ताकि बिल्ड को साथ-साथ बढ़ाया जा सके.

  • अगर srcs में एक सोर्स फ़ाइल है, तो लाइब्रेरी का नाम वही होना चाहिए जो C++ फ़ाइल का है. इस लाइब्रेरी में C++ फ़ाइल (फ़ाइलें), मेल खाने वाली कोई भी हेडर फ़ाइल, और लाइब्रेरी की डिपेंडेंसी होनी चाहिए. उदाहरण के लिए:

    cc_library(
        name = "mylib",
        srcs = ["mylib.cc"],
        hdrs = ["mylib.h"],
        deps = [":lower-level-lib"]
    )
    
  • फ़ाइल में हर cc_library टारगेट के लिए, एक cc_test नियम टारगेट का इस्तेमाल करें. टारगेट [library-name]_test और सोर्स फ़ाइल [library-name]_test.cc को नाम दें. उदाहरण के लिए, ऊपर दिखाए गए mylib लाइब्रेरी टारगेट के लिए, टेस्ट टारगेट कुछ ऐसा दिखेगा:

    cc_test(
        name = "mylib_test",
        srcs = ["mylib_test.cc"],
        deps = [":mylib"]
    )
    

पाथ शामिल करना

पाथ शामिल करने के लिए इन दिशा-निर्देशों का पालन करें:

  • सभी शामिल पाथ को वर्कस्पेस डायरेक्ट्री के हिसाब से बनाएं.

  • नॉन-सिस्टम हेडर के लिए कोट में शामिल (#include "foo/bar/baz.h") का इस्तेमाल करें, न कि ऐंगल-ब्रैकेट (#include <foo/bar/baz.h>).

  • UNIX डायरेक्ट्री के शॉर्टकट का इस्तेमाल करने से बचें. जैसे, . (मौजूदा डायरेक्ट्री) या .. (पैरंट डायरेक्ट्री).

  • लेगसी या third_party कोड के लिए, प्रोजेक्ट रिपॉज़िटरी के बाहर मौजूद फ़ाइलों को शामिल करना ज़रूरी है. जैसे, बाहरी रिपॉज़िटरी में शामिल फ़ाइलों के लिए प्रीफ़िक्स की ज़रूरत होती है. ऐसे में, cc_library नियम के टारगेट पर include_prefix और strip_include_prefix आर्ग्युमेंट का इस्तेमाल करें.