खास जानकारी
कंपाइलर को सही विकल्पों के साथ शुरू करने के लिए, Basel को इसके बारे में कुछ जानकारी होनी चाहिए कंपाइलर इंटर्नल, जैसे कि डायरेक्ट्री और ज़रूरी फ़्लैग शामिल करने होंगे. दूसरे शब्दों में, Basel को कंपाइलर के एक आसान मॉडल की ज़रूरत होती है, ताकि काम.
Bazel को इन चीज़ों की जानकारी चाहिए:
- कंपाइलर, thinLTO, मॉड्यूल, डाइनैमिक लिंकिंग या PIC (पोज़िशन इंडिपेंडेंट कोड) के साथ काम करता है या नहीं.
- ज़रूरी टूल के पाथ, जैसे कि gcc, ld, ar, objcopy वगैरह.
- बिल्ट-इन सिस्टम में डायरेक्ट्री शामिल होती हैं. बेज़ल को इनकी ज़रूरत है, ताकि
सोर्स फ़ाइल में शामिल सभी हेडर सही तरीके से
BUILD
फ़ाइल. - डिफ़ॉल्ट सिस्टम.
- कंपाइल करने, लिंक करने, और संग्रहित करने के लिए किन फ़्लैग का इस्तेमाल करना है.
- काम करने वाले कंपाइलेशन मोड (opt, dbg, fastbuild) के लिए, किन फ़्लैग का इस्तेमाल करना है.
- कंपाइलर के लिए खास तौर पर ज़रूरी वैरिएबल बनाएं.
अगर कंपाइलर में एक से ज़्यादा आर्किटेक्चर के लिए सहायता है, तो Bazel को उन्हें अलग से कॉन्फ़िगर करना होगा.
CcToolchainConfigInfo
एक ऐसी कंपनी है जो ज़रूरी लेवल की जानकारी देती है
बेज़ल के C++ नियमों के व्यवहार को कॉन्फ़िगर करने के लिए, जानकारी का स्तर. डिफ़ॉल्ट रूप से,
Bazel आपके बिल्ड के लिए CcToolchainConfigInfo
को अपने-आप कॉन्फ़िगर करता है. हालांकि, आपके पास इसे मैन्युअल तरीके से कॉन्फ़िगर करने का विकल्प होता है. इसके लिए, आपको स्टारलार्क नियम की ज़रूरत होगी
जो CcToolchainConfigInfo
उपलब्ध कराता है और आपको
एट्रिब्यूट की वैल्यू के तौर पर toolchain_config
cc_toolchain
को आपके नियम में जोड़ा गया.
CcToolchainConfigInfo
बनाने के लिए, इस नंबर पर कॉल करें
cc_common.create_cc_toolchain_config_info()
.
आपको @rules_cc//cc:cc_toolchain_config_lib.bzl
में, उन सभी स्ट्रक्चर के लिए Starlark कन्स्ट्रक्टर मिल सकते हैं जिनकी आपको प्रोसेस में ज़रूरत होगी.
जब C++ टारगेट, विश्लेषण के चरण में आता है, तो Baज़र सही विकल्प चुन लेता है
cc_toolchain
BUILD
फ़ाइल के आधार पर टारगेट करता है और
इसमें बताए गए टारगेट से CcToolchainConfigInfo
कंपनी
cc_toolchain.toolchain_config
एट्रिब्यूट की वैल्यू सबमिट करें. cc_toolchain
टारगेट, CcToolchainProvider
के ज़रिए इस जानकारी को C++ टारगेट को भेजता है.
उदाहरण के लिए, cc_binary
या cc_library
जैसे नियम से शुरू की गई कंपाइल या लिंक करने की कार्रवाई के लिए, यह जानकारी ज़रूरी है:
- इस्तेमाल करने के लिए कंपाइलर या लिंकर
- कंपाइलर/लिंकर के लिए कमांड-लाइन फ़्लैग
- कॉन्फ़िगरेशन फ़्लैग को
--copt/--linkopt
विकल्पों से पास किया गया है - एनवायरमेंट वैरिएबल
- सैंडबॉक्स में ऐसी आर्टफ़ैक्ट जिनमें कार्रवाई पूरी होती है
सैंडबॉक्स में ज़रूरी आर्टफ़ैक्ट को छोड़कर, ऊपर दी गई सभी जानकारी
Starlark के उस टारगेट में मौजूद है जिस पर cc_toolchain
ले जाता है.
सैंडबॉक्स में शिप किए जाने वाले आर्टफ़ैक्ट, cc_toolchain
टारगेट में दिखाए जाते हैं. उदाहरण के लिए, cc_toolchain.linker_files
एट्रिब्यूट की मदद से ये काम किए जा सकते हैं
सैंडबॉक्स में भेजने के लिए, लिंकर बाइनरी और टूलचेन लाइब्रेरी को तय करना.
टूलचेन चुनना
टूलचेन को चुनने का लॉजिक इस तरह काम करता है:
उपयोगकर्ता,
BUILD
फ़ाइल मेंcc_toolchain_suite
टारगेट तय करता है और--crosstool_top
विकल्प का इस्तेमाल करके, Bazel को टारगेट पर ले जाता है.cc_toolchain_suite
टारगेट में कई टूलचेन का इस्तेमाल होता है. कॉन्टेंट बनाने--cpu
और--compiler
फ़्लैग की वैल्यू से तय होता है कि इनमें से किस टूलचेन को चुना जाता है. ऐसा सिर्फ़--cpu
फ़्लैग की वैल्यू के आधार पर किया जाता है या संयुक्त--cpu | --compiler
वैल्यू के आधार पर. चुनने की प्रक्रिया ऐसी है: अनुसरण करता है:अगर
--compiler
बताया गया है, तो Bazecc_toolchain_suite.toolchains
से संबंधित एंट्री विशेषता--cpu | --compiler
वाली होनी चाहिए. अगर बेज़ल को न मिले एंट्री करने पर गड़बड़ी दिखती है.अगर
--compiler
विकल्प तय नहीं किया गया है, तो Basel को चुना जाता हैcc_toolchain_suite.toolchains
से जुड़ी हुई एंट्री एट्रिब्यूट की वैल्यू सिर्फ़--cpu
के साथ जोड़ी जा सकती है.अगर कोई फ़्लैग बताया नहीं गया है, तो Basel, होस्ट सिस्टम की जांच करता है और जानकारी के आधार पर
--cpu
की वैल्यू. जांच करने के तरीके का कोड देखें.
टूलचेन चुनने के बाद, Starlark नियम में मौजूद उससे जुड़े feature
और action_config
ऑब्जेक्ट, बिल्ड के कॉन्फ़िगरेशन को कंट्रोल करते हैं. इसका मतलब है कि बाद में बताए गए आइटम. इन मैसेज की मदद से,
बेज़ल में C++ की सभी बेहतरीन सुविधाएँ, बिना किसी बदलाव के
बेज़ल बाइनरी. C++ नियमों में कई यूनीक कार्रवाइयां की जा सकती हैं. इनके बारे में ज़्यादा जानकारी Bazel सोर्स कोड में दी गई है.
सुविधाएं
सुविधा एक ऐसी इकाई है जिसके लिए कमांड-लाइन फ़्लैग, कार्रवाई,
एक्ज़ीक्यूशन एनवायरमेंट पर कंस्ट्रेंट या डिपेंडेंसी में बदलाव करने पर. कोई सुविधा, BUILD
फ़ाइलों को treat_warnings_as_errors
जैसे फ़्लैग के कॉन्फ़िगरेशन चुनने की अनुमति देने या C++ नियमों के साथ इंटरैक्ट करने और header_modules
या thin_lto
जैसी नई कंपाइल ऐक्शन और इनपुट को कंपाइलेशन में शामिल करने जैसी कोई आसान सुविधा हो सकती है.
आम तौर पर, CcToolchainConfigInfo
में सुविधाओं की एक सूची होती है. इसमें हर सुविधा में एक या एक से ज़्यादा फ़्लैग ग्रुप होते हैं. हर फ़्लैग ग्रुप में, उन फ़्लैग की सूची होती है जो खास Bazel कार्रवाइयों पर लागू होते हैं.
किसी सुविधा को नाम से तय किया जाता है. इससे Starlark नियम कॉन्फ़िगरेशन को Bazel रिलीज़ से पूरी तरह अलग किया जा सकता है. दूसरे शब्दों में, Bazel रिलीज़ से CcToolchainConfigInfo
कॉन्फ़िगरेशन के काम करने के तरीके पर तब तक कोई असर नहीं पड़ता, जब तक उन कॉन्फ़िगरेशन के लिए नई सुविधाओं का इस्तेमाल ज़रूरी न हो.
सुविधा को इनमें से किसी एक तरीके से चालू किया जाता है:
- सुविधा के
enabled
फ़ील्ड कोtrue
पर सेट किया गया है. - Bazel या नियम का मालिक, साफ़ तौर पर इसे चालू करता है.
- उपयोगकर्ता,
--feature
Bazel विकल्प याfeatures
नियम के एट्रिब्यूट के ज़रिए इसे चालू करता है.
सुविधाओं में एक-दूसरे पर निर्भरता हो सकती है. ये कमांड-लाइन फ़्लैग, BUILD
फ़ाइल सेटिंग, और अन्य वैरिएबल पर निर्भर करती हैं.
सुविधाओं के साथ ऐसेट जोड़ना
आम तौर पर, डिपेंडेंसी को सीधे Basel की मदद से मैनेज किया जाता है, जो अपने-आप लागू होती है साथ ही, सुविधाओं की प्रकृति से जुड़े विवादों को मैनेज करती है और बिल्ड में परिभाषित किया गया है. टूलचेन स्पेसिफ़िकेशन की मदद से, Starlark नियम में सीधे तौर पर इस्तेमाल करने के लिए ज़्यादा सटीक पाबंदियां लगाई जा सकती हैं. यह नियम, सुविधा के लिए सहायता और उसके दायरे को तय करता है. इनके उदाहरण हैं:
सीमा | जानकारी |
requires = [ feature_set (features = [ 'feature-name-1', 'feature-name-2' ]), ] |
सुविधा-लेवल. यह सुविधा सिर्फ़ तब काम करती है, जब तय किया गया हो
सुविधाएं चालू हों. उदाहरण के लिए, जब कोई सुविधा सिर्फ़
कुछ चुनिंदा बिल्ड मोड (opt , dbg या
fastbuild ). अगर `ज़रूरी है` में एक से ज़्यादा `feature_set`हैं
यह सुविधा तब काम करती है, जब कोई भी `feature_set`काम करता है
(जब सभी खास सुविधाएं चालू हों).
|
implies = ['feature'] |
सुविधा के लेवल पर. इस सुविधा का मतलब, बताई गई सुविधाओं से है. किसी सुविधा को चालू करने से, उसमें लागू की गई सभी सुविधाएं भी साफ़ तौर पर चालू हो जाती हैं (इसका मतलब है कि यह बार-बार काम करता है). साथ ही, सुविधाओं के किसी सेट से, फ़ंक्शन के सामान्य सबसेट को बाहर रखने की सुविधा भी मिलती है. जैसे, सैनिटाइज़र के सामान्य हिस्से. शामिल सुविधाओं को बंद नहीं किया जा सकता. |
provides = ['feature'] |
सुविधा-लेवल. इससे पता चलता है कि यह सुविधा, एक-दूसरे के साथ काम न करने वाली कई वैकल्पिक सुविधाओं में से एक है. उदाहरण के लिए, सभी सैनिटाइज़र के लिए अगर उपयोगकर्ता एक साथ दो या उससे ज़्यादा ऐसी सुविधाओं के लिए पूछता है जो एक-दूसरे के साथ काम नहीं करती हैं, तो गड़बड़ी को ठीक करने की प्रोसेस को बेहतर बनाने के लिए, विकल्पों की सूची दिखाई जाती है. |
with_features = [ with_feature_set( features = ['feature-1'], not_features = ['feature-2'], ), ] |
फ़्लैग सेट-लेवल. सुविधा, एक से ज़्यादा फ़्लैग सेट के बारे में बता सकती है.
with_features तय करने पर, फ़्लैग सेट सिर्फ़ तब बिल्ड कमांड में बड़ा होगा, जब कम से कम एक with_feature_set मौजूद हो, जिसके लिए तय किए गए features सेट की सभी सुविधाएं चालू हों और not_features सेट की सभी सुविधाएं बंद हों.
अगर with_features नहीं दिया गया है, तो फ़्लैग सेट, बताई गई हर कार्रवाई के लिए बिना शर्त लागू होगा.
|
कार्रवाइयां
कार्रवाइयों से, इन स्थितियों में बदलाव करने की सुविधा मिलती है
यह कार्रवाई किए बिना ही कार्रवाई पूरी होती है. अगर आप
action_config
किसी कार्रवाई को शुरू करने वाली टूल बाइनरी के बारे में बताता है, जबकि
feature
कॉन्फ़िगरेशन (फ़्लैग) के बारे में बताता है, जो यह तय करता है कि टूल
कार्रवाई शुरू होने पर काम करता है.
सुविधाएं, ऐक्शन का रेफ़रंस देती हैं, ताकि यह पता चल सके कि वे किन Bazel ऐक्शन पर असर डालती हैं. ऐसा इसलिए, क्योंकि ऐक्शन, Bazel ऐक्शन ग्राफ़ में बदलाव कर सकते हैं. कॉन्टेंट बनाने
सेवा देने वाली CcToolchainConfigInfo
कंपनी के पास ऐसी कार्रवाइयां हैं जिनमें फ़्लैग और टूल मौजूद हैं
जैसे कि c++-compile
. हर कार्रवाई के लिए फ़्लैग असाइन किए जाते हैं
और उन्हें किसी सुविधा से जोड़कर.
हर कार्रवाई के नाम से, एक ही तरह की कार्रवाई के बारे में पता चलता है. यह कार्रवाई Basel ने की है, जैसे कि
कंपाइल या लिंक करना. हालांकि, कार्रवाइयों और Bazel ऐक्शन टाइप के बीच कई-एक का संबंध है. यहां Bazel ऐक्शन टाइप से, किसी ऐसी Java क्लास का मतलब है जो किसी ऐक्शन को लागू करती है, जैसे कि CppCompileAction
. खास तौर पर, यहां दी गई टेबल में "असेम्बलर ऐक्शन" और "कंपाइलर ऐक्शन" CppCompileAction
हैं, जबकि लिंक ऐक्शन CppLinkAction
हैं.
असेंबलर की कार्रवाइयां
कार्रवाई | जानकारी |
preprocess-assemble
|
डेटा को पहले से प्रोसेस करके इकट्ठा करना. आम तौर पर, .S फ़ाइलों के लिए.
|
assemble
|
प्री-प्रोसेसिंग के बिना असेंबल करें. आम तौर पर, .s फ़ाइलों के लिए.
|
कंपाइलर ऐक्शन
कार्रवाई | जानकारी |
cc-flags-make-variable
|
CC_FLAGS को genrules में भेजता है.
|
c-compile
|
सी॰ के तौर पर कंपाइल करें |
c++-compile
|
C++ के तौर पर कंपाइल करें. |
c++-header-parsing
|
यह पक्का करने के लिए कि हेडर अपने-आप में पूरी हो. ऐसा इसलिए, क्योंकि इससे कंपाइलेशन की गड़बड़ियां पैदा होंगी. यह सिर्फ़ उन टूलचेन पर लागू होता है जिनमें मॉड्यूल काम करते हैं. |
लिंक से जुड़ी कार्रवाइयां
कार्रवाई | जानकारी |
c++-link-dynamic-library
|
एक शेयर की गई लाइब्रेरी को लिंक करें जिसमें उसकी सभी डिपेंडेंसी शामिल हों. |
c++-link-nodeps-dynamic-library
|
सिर्फ़ cc_library सोर्स वाली शेयर की गई लाइब्रेरी को लिंक करें.
|
c++-link-executable
|
चलाने के लिए तैयार आखिरी लाइब्रेरी लिंक करें. |
एआर से जुड़ी कार्रवाइयां
एआर ऐक्शन, ar
के ज़रिए ऑब्जेक्ट फ़ाइलों को संग्रह लाइब्रेरी (.a
फ़ाइलें) में इकट्ठा करते हैं और नाम में कुछ सेमेटिक कोड डालते हैं.
कार्रवाई | जानकारी |
c++-link-static-library
|
स्टैटिक लाइब्रेरी (संग्रह) बनाएं. |
एलटीओ से जुड़ी कार्रवाइयां
कार्रवाई | जानकारी |
lto-backend
|
थिनएलटीओ ऐक्शन, बिटकोड को नेटिव ऑब्जेक्ट में कंपाइल करता है. |
lto-index
|
थिनएलटीओ ऐक्शन, ग्लोबल इंडेक्स जनरेट कर रहा है. |
action_config का इस्तेमाल करना
action_config
एक Starlark स्ट्रक्चर है, जो किसी Bazel ऐक्शन के बारे में बताता है. यह ऐक्शन के दौरान इस्तेमाल किए जाने वाले टूल (बाइनरी) और सुविधाओं के हिसाब से तय किए गए फ़्लैग के सेट की जानकारी देता है. ये फ़्लैग, कार्रवाई के
लागू करता है.
action_config()
कंस्ट्रक्टर में ये पैरामीटर हैं:
एट्रिब्यूट | जानकारी |
action_name
|
वह Bazel कार्रवाई जिससे यह कार्रवाई जुड़ी है. बेज़ल इस एट्रिब्यूट का इस्तेमाल, हर कार्रवाई के टूल और उसे लागू करने के बारे में जानने के लिए करते हैं ज़रूरतें. |
tools
|
यह कोड एक्ज़ीक्यूट करने के लिए इस्तेमाल किया जाता है. कार्रवाई पर लागू किया गया टूल सुविधा के सेट के साथ सूची में पहला टूल मौजूद है जो सुविधा से मेल खाता है कॉन्फ़िगरेशन. डिफ़ॉल्ट वैल्यू देना ज़रूरी है. |
flag_sets
|
कई कार्रवाइयों पर लागू होने वाले फ़्लैग की सूची. इसके समान सुविधा. |
env_sets
|
कार्रवाइयों के ग्रुप पर लागू होने वाली, एनवायरमेंट से जुड़ी पाबंदियों की सूची. यह सुविधा के लिए लागू होती है. |
action_config
के लिए दूसरी सुविधाओं की ज़रूरत पड़ सकती है और उन्हें लागू किया जा सकता है.
action_config
सुविधाओं के साथ जुड़ाव के बारे में ऊपर बताया गया है. यह व्यवहार
किसी सुविधा के समान है.
आखिरी दो एट्रिब्यूट, सुविधाओं के एट्रिब्यूट के मुकाबले ग़ैर-ज़रूरी हैं. इन्हें इसलिए शामिल किया गया है, क्योंकि Bazel की कुछ कार्रवाइयों के लिए कुछ फ़्लैग या एनवायरमेंट वैरिएबल की ज़रूरत होती है. साथ ही, इसका मकसद action_config
+feature
के ग़ैर-ज़रूरी पेयर से बचना है. आम तौर पर, एक ही सुविधा को कई action_config
के साथ शेयर करना बेहतर होता है.
एक ही action_name
के साथ, एक से ज़्यादा action_config
नहीं दिए जा सकते
एक ही टूलचेन में. इससे टूल पाथ में किसी तरह की गड़बड़ी नहीं होती और action_config
के मकसद को पूरा किया जाता है. इसका मकसद यह है कि टूलचेन में किसी ऐक्शन की प्रॉपर्टी को एक ही जगह पर साफ़ तौर पर बताया जाए.
टूल कंस्ट्रक्टर का इस्तेमाल करना
action_config
अपने tools
पैरामीटर की मदद से, टूल का एक सेट तय कर सकता है.
tool()
कन्स्ट्रक्टर में ये पैरामीटर इस्तेमाल किए जाते हैं:
फ़ील्ड | जानकारी |
path
|
उस टूल का पाथ जिस पर दावा किया गया है (मौजूदा जगह के हिसाब से). |
with_features
|
सुविधा के सेट की ऐसी सूची जिसमें से कम से कम किसी एक को पूरा करना ज़रूरी है इस टूल का इस्तेमाल करें. |
किसी दिए गए action_config
के लिए, सिर्फ़ एक tool
लागू होता है
इसके टूल पाथ और इसे लागू करने की ज़रूरी शर्तों को पूरा करता है. किसी टूल को तब तक action_config
पर मौजूद tools
एट्रिब्यूट के ज़रिए दोहराया जाता है, जब तक कि सुविधा के कॉन्फ़िगरेशन से मैच करने वाला with_feature
सेट वाला टूल न मिल जाए. ज़्यादा जानकारी के लिए, इस पेज पर पहले मौजूद सुविधा के बीच के संबंध देखें. आपको टूल की सूचियों को डिफ़ॉल्ट टूल के साथ खत्म करना चाहिए, जो किसी खाली सुविधा कॉन्फ़िगरेशन से जुड़ा हो.
इस्तेमाल से जुड़ा उदाहरण
Basel की कार्रवाइयों को लागू करने के लिए, सुविधाओं और कार्रवाइयों का एक साथ इस्तेमाल किया जा सकता है
जिसमें अलग-अलग क्रॉस-प्लैटफ़ॉर्म सिमेंटिक्स शामिल हैं. उदाहरण के लिए, macOS पर डीबग सिंबल जनरेट करने के लिए, सबसे पहले कंपाइल ऐक्शन में सिंबल जनरेट करने होंगे. इसके बाद, लिंक ऐक्शन के दौरान एक खास टूल का इस्तेमाल करके, कंप्रेस किया गया dsym संग्रह बनाया जाएगा. इसके बाद, उस संग्रह को डिकंप्रेस करके ऐप्लिकेशन बंडल और .plist
ऐसी फ़ाइलें बनाई जाएंगी जिन्हें Xcode इस्तेमाल कर सकता है.
Bazel की मदद से, इस प्रोसेस को इस तरह लागू किया जा सकता है. इसमें unbundle-debuginfo
, Bazel ऐक्शन है:
load("@rules_cc//cc:defs.bzl", "ACTION_NAMES")
action_configs = [
action_config (
action_name = ACTION_NAMES.cpp_link_executable,
tools = [
tool(
with_features = [
with_feature(features=["generate-debug-symbols"]),
],
path = "toolchain/mac/ld-with-dsym-packaging",
),
tool (path = "toolchain/mac/ld"),
],
),
]
features = [
feature(
name = "generate-debug-symbols",
flag_sets = [
flag_set (
actions = [
ACTION_NAMES.c_compile,
ACTION_NAMES.cpp_compile
],
flag_groups = [
flag_group(
flags = ["-g"],
),
],
)
],
implies = ["unbundle-debuginfo"],
),
]
इस सुविधा को Linux के लिए पूरी तरह से अलग तरीके से लागू किया जा सकता है, जो
fission
या Windows के लिए, जो .pdb
फ़ाइलें बनाती है. उदाहरण के लिए, fission
पर आधारित डीबग सिंबल जनरेशन को लागू करने का तरीका कुछ ऐसा दिख सकता है:
load("@rules_cc//cc:defs.bzl", "ACTION_NAMES")
action_configs = [
action_config (
name = ACTION_NAMES.cpp_compile,
tools = [
tool(
path = "toolchain/bin/gcc",
),
],
),
]
features = [
feature (
name = "generate-debug-symbols",
requires = [with_feature_set(features = ["dbg"])],
flag_sets = [
flag_set(
actions = [ACTION_NAMES.cpp_compile],
flag_groups = [
flag_group(
flags = ["-gsplit-dwarf"],
),
],
),
flag_set(
actions = [ACTION_NAMES.cpp_link_executable],
flag_groups = [
flag_group(
flags = ["-Wl", "--gdb-index"],
),
],
),
],
),
]
ग्रुप फ़्लैग करना
CcToolchainConfigInfo
से आपको फ़्लैग को उन ग्रुप में शामिल करने की अनुमति मिलती है जो
किसी खास मकसद के लिए बनाया गया हो. फ़्लैग की वैल्यू में पहले से तय किए गए वैरिएबल का इस्तेमाल करके, फ़्लैग तय किया जा सकता है. कंपाइलर, फ़्लैग को बिल्ड कमांड में जोड़ते समय उसे बड़ा कर देता है. उदाहरण के लिए:
flag_group (
flags = ["%{output_execpath}"],
)
इस मामले में, फ़्लैग के कॉन्टेंट को कार्रवाई की आउटपुट फ़ाइल के पाथ से बदल दिया जाएगा.
फ़्लैग ग्रुप, बिल्ड कमांड तक उस क्रम में बड़े किए जाते हैं जिस क्रम में वे दिखते हैं सूची में ऊपर से नीचे, बाएं से दाएं.
उन फ़्लैग के लिए जिन्हें बिल्ड में जोड़ने पर अलग-अलग मानों के साथ दोहराने की ज़रूरत होती है
निर्देश देने के लिए, फ़्लैग ग्रुप list
टाइप के वैरिएबल को दोहरा सकता है. उदाहरण के लिए, list
टाइप का वैरिएबल include_path
:
flag_group (
iterate_over = "include_paths",
flags = ["-I%{include_paths}"],
)
include_paths
सूची में हर पाथ एलिमेंट के लिए, -I<path>
तक बड़ा होता है. फ़्लैग ग्रुप के एलान के मुख्य हिस्से में मौजूद सभी फ़्लैग (या flag_group
) को एक यूनिट के तौर पर बड़ा किया जाता है. उदाहरण के लिए:
flag_group (
iterate_over = "include_paths",
flags = ["-I", "%{include_paths}"],
)
include_paths
सूची में हर पाथ एलिमेंट के लिए, -I <path>
तक बड़ा होता है.
किसी वैरिएबल को कई बार दोहराया जा सकता है. उदाहरण के लिए:
flag_group (
iterate_over = "include_paths",
flags = ["-iprefix=%{include_paths}", "-isystem=%{include_paths}"],
)
इसमें बड़ा होगा:
-iprefix=<inc0> -isystem=<inc0> -iprefix=<inc1> -isystem=<inc1>
वैरिएबल, बिंदु-नोटेशन का इस्तेमाल करके ऐक्सेस किए जा सकने वाले स्ट्रक्चर से जुड़े हो सकते हैं. उदाहरण के लिए:
flag_group (
flags = ["-l%{libraries_to_link.name}"],
)
स्ट्रक्चर को नेस्ट किया जा सकता है और उनमें क्रम भी शामिल हो सकते हैं. नाम के टकराव से बचने के लिए साफ़ तौर पर कहा जाए, तो आपको फ़ील्ड के ज़रिए पूरा पाथ बताना होगा. इसके लिए उदाहरण:
flag_group (
iterate_over = "libraries_to_link",
flag_groups = [
flag_group (
iterate_over = "libraries_to_link.shared_libraries",
flags = ["-l%{libraries_to_link.shared_libraries.name}"],
),
],
)
शर्त के हिसाब से एक्सपैंशन
फ़्लैग ग्रुप, expand_if_available
, expand_if_not_available
,
expand_if_true
, expand_if_false
या expand_if_equal
एट्रिब्यूट का इस्तेमाल करके, किसी खास वैरिएबल या उसके फ़ील्ड की मौजूदगी के आधार पर, शर्त के मुताबिक डेटा एक्सपैंशन की सुविधा देते हैं. उदाहरण के लिए:
flag_group (
iterate_over = "libraries_to_link",
flag_groups = [
flag_group (
iterate_over = "libraries_to_link.shared_libraries",
flag_groups = [
flag_group (
expand_if_available = "libraries_to_link.shared_libraries.is_whole_archive",
flags = ["--whole_archive"],
),
flag_group (
flags = ["-l%{libraries_to_link.shared_libraries.name}"],
),
flag_group (
expand_if_available = "libraries_to_link.shared_libraries.is_whole_archive",
flags = ["--no_whole_archive"],
),
],
),
],
)
CcToolchainConfigInfo का रेफ़रंस
इस सेक्शन में, C++ नियमों को कॉन्फ़िगर करने के लिए ज़रूरी, बिल्ड वैरिएबल, सुविधाओं, और अन्य जानकारी का रेफ़रंस दिया गया है.
CcToolchainConfigInfo बिल्ड वैरिएबल
यहां CcToolchainConfigInfo
बिल्ड वैरिएबल का रेफ़रंस दिया गया है.
वैरिएबल | कार्रवाई | जानकारी |
source_file
|
कंपाइल करना | कंपाइल करने के लिए सोर्स फ़ाइल. |
input_file
|
स्ट्रिप | हटाने के लिए आर्टफ़ैक्ट. |
output_file
|
compile, strip | कंपाइलेशन का आउटपुट. |
output_assembly_file
|
कंपाइल करना | जनरेट की गई असेंबली फ़ाइल. यह सिर्फ़ तब लागू होता है, जब
compile कार्रवाई से, आम तौर पर असेंबली टेक्स्ट निकलता है. आम तौर पर, इसका इस्तेमाल करते समय
--save_temps फ़्लैग. कॉन्टेंट एक जैसा है
output_file .
|
output_preprocess_file
|
कंपाइल करना | पहले से प्रोसेस किया गया आउटपुट. यह सिर्फ़ उन Compile
ऐक्शन पर लागू होता है जो सिर्फ़ सोर्स फ़ाइलों को प्रीप्रोसेस करते हैं. आम तौर पर, ऐसा --save_temps फ़्लैग का इस्तेमाल करते समय होता है. कॉन्टेंट,
output_file के लिए मौजूद कॉन्टेंट जैसा ही है.
|
includes
|
कंपाइल करें | उन फ़ाइलों का क्रम जिन्हें कंपाइलर को बिना किसी शर्त के, कंपाइल किए गए सोर्स में शामिल करना चाहिए. |
include_paths
|
कंपाइल करना | सीक्वेंस डायरेक्ट्री, जिनमें कंपाइलर, #include<foo.h> और #include "foo.h" का इस्तेमाल करके शामिल किए गए हेडर खोजता है.
|
quote_include_paths
|
कंपाइल करें | -iquote के क्रम में शामिल हैं -
डायरेक्ट्री, जिनका इस्तेमाल करके कंपाइलर हेडर की मदद से खोजता है
#include "foo.h" .
|
system_include_paths
|
कंपाइल करें | -isystem के क्रम में ये शामिल हैं -
ऐसी डायरेक्ट्री जिनमें कंपाइलर, #include <foo.h> का इस्तेमाल करके शामिल किए गए हेडर खोजता है.
|
dependency_file
|
कंपाइल करना | कंपाइलर से जनरेट की गई .d डिपेंडेंसी फ़ाइल.
|
preprocessor_defines
|
कंपाइल करें | defines का क्रम, जैसे कि --DDEBUG .
|
pic
|
कंपाइल करना | आउटपुट को पोज़िशन-इंडिपेंडेंट कोड के तौर पर कंपाइल करता है. |
gcov_gcno_file
|
कंपाइल करें | gcov कवरेज फ़ाइल.
|
per_object_debug_info_file
|
कंपाइल करें | हर ऑब्जेक्ट की डीबग की जानकारी (.dwp ) फ़ाइल.
|
stripopts
|
स्ट्रिप | stripopts का क्रम.
|
legacy_compile_flags
|
कंपाइल करना | लेगसी
CROSSTOOL फ़ील्ड से मिले फ़्लैग का क्रम, जैसे कि compiler_flag ,
optional_compiler_flag , cxx_flag , और
optional_cxx_flag .
|
user_compile_flags
|
कंपाइल करना | copt नियम एट्रिब्यूट या --copt ,
--cxxopt , और --conlyopt फ़्लैग में से किसी एक का फ़्लैग क्रम.
|
unfiltered_compile_flags
|
कंपाइल करना | unfiltered_cxx_flag लेगसी CROSSTOOL फ़ील्ड या unfiltered_compile_flags सुविधा से फ़्लैग का क्रम. इन्हें इसके हिसाब से फ़िल्टर नहीं किया जाता
nocopts नियम एट्रिब्यूट.
|
sysroot
|
sysroot .
|
|
runtime_library_search_directories
|
लिंक | लिंकर के रनटाइम सर्च पाथ में मौजूद एंट्री (आम तौर पर, -rpath फ़्लैग के साथ सेट की जाती हैं).
|
library_search_directories
|
लिंक | लिंकर सर्च पाथ में मौजूद एंट्री (आम तौर पर, -L फ़्लैग के साथ सेट की जाती हैं).
|
libraries_to_link
|
लिंक | लिंकर को कॉल करते समय, इनपुट के तौर पर लिंक करने के लिए फ़ाइलें देने वाले फ़्लैग. |
def_file_path
|
लिंक | Windows पर MSVC के साथ इस्तेमाल की गई def फ़ाइल की जगह. |
linker_param_file
|
लिंक | कमांड लाइन की लंबाई की सीमा को कम करने के लिए, bazel की बनाई गई लिंकर पैरामीटर फ़ाइल की जगह. |
output_execpath
|
लिंक | लिंकर के आउटपुट का एक्ज़ीकपैट. |
generate_interface_library
|
लिंक | "yes" या "no" , इस आधार पर कि इंटरफ़ेस लाइब्रेरी जनरेट की जानी चाहिए या नहीं.
|
interface_library_builder_path
|
लिंक | इंटरफ़ेस लाइब्रेरी बिल्डर टूल का पाथ. |
interface_library_input_path
|
लिंक | इंटरफ़ेस लाइब्रेरी ifso बिल्डर टूल के लिए इनपुट.
|
interface_library_output_path
|
लिंक | वह पाथ जहां ifso बिल्डर टूल का इस्तेमाल करके इंटरफ़ेस लाइब्रेरी जनरेट की जानी है.
|
legacy_link_flags
|
लिंक | CROSSTOOL के लेगसी फ़ील्ड से मिलने वाले लिंकर फ़्लैग.
|
user_link_flags
|
लिंक | --linkopt से मिलने वाले लिंकर फ़्लैग
या linkopts एट्रिब्यूट का इस्तेमाल करें.
|
linkstamp_paths
|
लिंक | लिंकस्टैंप पाथ देने वाला बिल्ड वैरिएबल. |
force_pic
|
लिंक | इस वैरिएबल की मौजूदगी का मतलब है कि पीआईसी/पीआईई कोड को जनरेट किया जाएगा (बेज़ल विकल्प `--force_pic` पास किया गया था). |
strip_debug_symbols
|
लिंक | इस वैरिएबल की मौजूदगी से पता चलता है कि डीबग चिह्नों को हटा दिया जाना चाहिए. |
is_cc_test
|
लिंक | सत्य, जब मौजूदा गतिविधि एक cc_test है
लिंक करने की कार्रवाई, गलत नहीं है.
|
is_using_fission
|
कंपाइल करना, लिंक करना | इस वैरिएबल की मौजूदगी से पता चलता है कि फ़िज़न (हर ऑब्जेक्ट के लिए डीबग जानकारी)
चालू है. डीबग की जानकारी, .o फ़ाइलों के बजाय
.dwo फ़ाइलों में होगी. कंपाइलर और लिंकर को इसकी जानकारी होनी चाहिए.
|
fdo_instrument_path
|
कंपाइल करना, लिंक करना | उस डायरेक्ट्री का पाथ जिसमें एफ़डीओ की इंस्ट्रुमेंटेशन प्रोफ़ाइल सेव की जाती है. |
fdo_profile_path
|
कंपाइल करें | एफ़डीओ प्रोफ़ाइल का पाथ. |
fdo_prefetch_hints_path
|
कंपाइल करें | कैश मेमोरी प्रीफ़ेच प्रोफ़ाइल का पाथ. |
cs_fdo_instrument_path
|
कंपाइल, लिंक | उस डायरेक्ट्री का पाथ जिसमें संदर्भ के हिसाब से काम करने वाली FDO इंस्ट्रूमेंटेशन प्रोफ़ाइल सेव की जाती है. |
लोकप्रिय सुविधाएं
सुविधाओं और उनके चालू होने के बारे में यहां बताया गया है शर्तें.
सुविधा | दस्तावेज़ के रूप में |
opt | dbg | fastbuild
|
यह सुविधा, कंपाइलेशन मोड के आधार पर डिफ़ॉल्ट रूप से चालू होती है. |
static_linking_mode | dynamic_linking_mode
|
यह सुविधा, लिंकिंग मोड के आधार पर डिफ़ॉल्ट रूप से चालू होती है. |
per_object_debug_info
|
अगर supports_fission सुविधा की जानकारी दी गई है और वह चालू है, तो यह विकल्प चालू होता है. साथ ही, --fission फ़्लैग में मौजूदा कंपाइलेशन मोड की जानकारी दी जाती है.
|
supports_start_end_lib
|
अगर चालू है (और --start_end_lib विकल्प सेट है), तो Baze
स्थिर लाइब्रेरी से लिंक नहीं होगा, बल्कि
ऑब्जेक्ट से लिंक करने के लिए, --start-lib/--end-lib लिंकर के विकल्प
सकता है. इससे बिल्ड की प्रोसेस तेज़ हो जाती है, क्योंकि Bazel को स्टैटिक लाइब्रेरी बनाने की ज़रूरत नहीं होती.
|
supports_interface_shared_libraries
|
अगर चालू है (और विकल्प --interface_shared_objects यह है
सेट है), तो Basel उन टारगेट को लिंक करेगा जिनके linkstatic को इस पर सेट किया गया है
शेयर किए गए इंटरफ़ेस के लिए गलत (डिफ़ॉल्ट रूप से cc_test )
लाइब्रेरी. इससे, इंक्रीमेंटल रीलिंकिंग की प्रोसेस तेज़ी से पूरी होती है.
|
supports_dynamic_linker
|
इस विकल्प के चालू होने पर, C++ के नियमों को पता चल जाएगा कि टूलचेन से शेयर की गई लाइब्रेरी बनाई जा सकती हैं. |
static_link_cpp_runtimes
|
अगर यह विकल्प चालू है, तो Bazel, स्टैटिक लिंकिंग मोड में C++ रनटाइम को स्टैटिक तौर पर और डाइनैमिक लिंकिंग मोड में डाइनैमिक तौर पर लिंक करेगा. कलाकृतियां
cc_toolchain.static_runtime_lib में बताया गया है या
cc_toolchain.dynamic_runtime_lib एट्रिब्यूट (इस पर निर्भर करता है कि
लिंकिंग मोड) को लिंक करने की कार्रवाइयों में जोड़ दिया जाएगा.
|
supports_pic
|
अगर यह सुविधा चालू है, तो टूलचेन को डाइनैमिक लाइब्रेरी के लिए PIC ऑब्जेक्ट का इस्तेमाल करने की जानकारी मिल जाएगी. जब भी PIC कंपाइलेशन की ज़रूरत होती है, तब `pic` वैरिएबल मौजूद होता है. अगर यह सुविधा डिफ़ॉल्ट रूप से चालू नहीं है और `--force_pic` का इस्तेमाल किया गया है, तो Bazel, `supports_pic` का अनुरोध करेगा और पुष्टि करेगा कि यह सुविधा चालू है या नहीं. अगर यह सुविधा मौजूद नहीं है या इसे चालू नहीं किया जा सका, तो `--force_pic` का इस्तेमाल नहीं किया जा सकता. |
static_linking_mode | dynamic_linking_mode
|
यह सुविधा, लिंकिंग मोड के आधार पर डिफ़ॉल्ट रूप से चालू होती है. |
no_legacy_features
|
Bazel को C++ कॉन्फ़िगरेशन में लेगसी सुविधाएं जोड़ने से रोकता है. सुविधाओं की पूरी सूची यहां देखें. |
लेगसी सुविधाओं को पैच करने का लॉजिक
Basel ने टूलचेन की सुविधाओं में ये बदलाव लागू किए. ये बदलाव, पीछे की ओर करने के लिए किए गए हैं साथ काम करता है:
legacy_compile_flags
सुविधा को टूलचैन में सबसे ऊपर ले जाता हैdefault_compile_flags
सुविधा को टूलचेन के सबसे ऊपर ले जाता है- टूलचेन के सबसे ऊपर
dependency_file
(अगर मौजूद नहीं है) सुविधा जोड़ता है - टूलचेन के सबसे ऊपर
pic
(अगर मौजूद नहीं है) सुविधा जोड़ता है - टूलचेन के सबसे ऊपर
per_object_debug_info
(अगर मौजूद नहीं है) सुविधा जोड़ता है - टूलचेन के सबसे ऊपर
preprocessor_defines
(अगर मौजूद नहीं है) सुविधा जोड़ता है - टूलचेन के सबसे ऊपर
includes
(अगर मौजूद नहीं है) सुविधा जोड़ता है - टूलचेन के सबसे ऊपर
include_paths
(अगर मौजूद नहीं है) सुविधा जोड़ता है - टूलचेन के सबसे ऊपर
fdo_instrument
(अगर मौजूद नहीं है) सुविधा जोड़ता है - टूलचेन के सबसे ऊपर
fdo_optimize
(अगर मौजूद नहीं है) सुविधा जोड़ता है - टूलचेन के सबसे ऊपर
cs_fdo_instrument
(अगर मौजूद नहीं है) सुविधा जोड़ता है - टूलचेन के सबसे ऊपर
cs_fdo_optimize
(अगर मौजूद नहीं है) सुविधा जोड़ता है - टूलचेन के सबसे ऊपर
fdo_prefetch_hints
(अगर मौजूद नहीं है) सुविधा जोड़ता है - टूलचेन के सबसे ऊपर
autofdo
(अगर मौजूद नहीं है) सुविधा जोड़ता है - टूलचेन के सबसे ऊपर
build_interface_libraries
(अगर मौजूद नहीं है) सुविधा जोड़ता है - टूलचेन के सबसे ऊपर
dynamic_library_linker_tool
(अगर मौजूद नहीं है) सुविधा जोड़ता है - टूलचेन के सबसे ऊपर
shared_flag
(अगर मौजूद नहीं है) सुविधा जोड़ता है - टूलचेन के सबसे ऊपर
linkstamps
(अगर मौजूद नहीं है) सुविधा जोड़ता है - टूलचेन के सबसे ऊपर
output_execpath_flags
(अगर मौजूद नहीं है) सुविधा जोड़ता है - टूलचेन के सबसे ऊपर
runtime_library_search_directories
(अगर मौजूद नहीं है) सुविधा जोड़ता है - टूलचेन के सबसे ऊपर
library_search_directories
(अगर मौजूद नहीं है) सुविधा जोड़ता है - टूलचेन के सबसे ऊपर
archiver_flags
(अगर मौजूद नहीं है) सुविधा जोड़ता है - टूलचेन के सबसे ऊपर
libraries_to_link
(अगर मौजूद नहीं है) सुविधा जोड़ता है - टूलचेन के सबसे ऊपर
force_pic_flags
(अगर मौजूद नहीं है) सुविधा जोड़ता है - टूलचेन के सबसे ऊपर
user_link_flags
(अगर मौजूद नहीं है) सुविधा जोड़ता है - टूलचेन के सबसे ऊपर
legacy_link_flags
(अगर मौजूद नहीं है) सुविधा जोड़ता है - टूलचेन के सबसे ऊपर
static_libgcc
(अगर मौजूद नहीं है) सुविधा जोड़ता है - टूलचेन के सबसे ऊपर
fission_support
(अगर मौजूद नहीं है) सुविधा जोड़ता है - टूलचेन के सबसे ऊपर
strip_debug_symbols
(अगर मौजूद नहीं है) सुविधा जोड़ता है - टूलचेन के सबसे ऊपर
coverage
(अगर मौजूद नहीं है) सुविधा जोड़ता है - टूलचेन के सबसे ऊपर
llvm_coverage_map_format
(अगर मौजूद नहीं है) सुविधा जोड़ता है - टूलचेन के सबसे ऊपर
gcc_coverage_map_format
(अगर मौजूद नहीं है) सुविधा जोड़ता है - टूलचेन के सबसे नीचे
fully_static_link
(अगर मौजूद नहीं है) सुविधा जोड़ता है - टूलचेन के सबसे नीचे
user_compile_flags
(अगर मौजूद नहीं है) सुविधा जोड़ता है - इससे टूलचेन के सबसे नीचे
sysroot
(अगर मौजूद नहीं है) सुविधा जोड़ दी जाती है - टूलचेन के सबसे नीचे
unfiltered_compile_flags
(अगर मौजूद नहीं है) सुविधा जोड़ता है - टूलचेन के सबसे नीचे
linker_param_file
(अगर मौजूद नहीं है) सुविधा जोड़ता है - टूलचेन के सबसे नीचे
compiler_input_flags
(अगर मौजूद नहीं है) सुविधा जोड़ता है - टूलचेन के सबसे नीचे
compiler_output_flags
(अगर मौजूद नहीं है) सुविधा जोड़ता है
यह सुविधाओं की एक लंबी सूची है. Starlark में क्रॉसटूल बन जाने के बाद, इनका इस्तेमाल बंद कर दिया जाएगा. दिलचस्पी रखने वाले लोगों के लिए, इसे लागू करने की प्रोसेस को
CppActionConfigs,
और प्रोडक्शन टूलचेन के लिए, no_legacy_features
को जोड़कर
ज़्यादा अलग तरीके से बनाया जा सकता है.