C++ और Bazel

समस्या की शिकायत करें सोर्स देखें Nightly · 8.4 · 8.3 · 8.2 · 8.1 · 8.0 · 7.6

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

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

C++ प्रोजेक्ट पर Bazel का इस्तेमाल करने के लिए, यहां दिए गए संसाधनों का इस्तेमाल करें:

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

Bazel के सामान्य सबसे सही तरीकों के अलावा, यहां 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>) का.

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

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