पैसे चुकाकर बने सदस्यों के लिए
- action_is_enabled
- CcToolchainInfo
- compile
- configure_features
- create_cc_toolchain_config_info
- create_compilation_context
- create_compilation_outputs
- create_compile_variables
- create_library_to_link
- create_link_variables
- create_linker_input
- create_linking_context
- create_linking_context_from_compilation_outputs
- do_not_use_tools_cpp_compiler_present
- get_environment_variables
- get_execution_requirements
- get_memory_inefficient_command_line
- get_tool_for_action
- is_enabled
- लिंक
- merge_compilation_contexts
- merge_compilation_outputs
action_is_enabled
bool cc_common.action_is_enabled(feature_configuration, action_name)अगर सुविधा के कॉन्फ़िगरेशन में, Actions_config चालू किया गया है, तो 'सही' दिखाता है.
पैरामीटर
पैरामीटर | ब्यौरा |
---|---|
feature_configuration
|
सुविधा के कॉन्फ़िगरेशन के लिए क्वेरी करना ज़रूरी है. |
action_name
|
ज़रूरी है action_config का नाम. |
CcToolchainInfo
Provider cc_common.CcToolchainInfoइस कुंजी का इस्तेमाल, सेवा देने वाली कंपनी को वापस पाने के लिए किया जाता है. इस कुंजी में, इस्तेमाल किए जा रहे C++ टूलचेन के बारे में जानकारी होती है
compile
tuple cc_common.compile(actions, feature_configuration, cc_toolchain, srcs=[], public_hdrs=[], private_hdrs=[], includes=[], quote_includes=[], system_includes=[], framework_includes=[], defines=[], local_defines=[], include_prefix='', strip_include_prefix='', user_compile_flags=[], compilation_contexts=[], name, disallow_pic_outputs=False, disallow_nopic_outputs=False, additional_inputs=[])इसका इस्तेमाल C++ कंपाइलेशन के लिए किया जाना चाहिए. (
CompilationContext
, CcCompilationOutputs
) का टपल देता है.
पैरामीटर
पैरामीटर | ब्यौरा |
---|---|
actions
|
ज़रूरी हैactions ऑब्जेक्ट.
|
feature_configuration
|
feature_configuration क्वेरी करना ज़रूरी है.
|
cc_toolchain
|
CcToolchainInfo कंपनी का इस्तेमाल करना ज़रूरी है.
|
srcs
|
डिफ़ॉल्ट तौर पर यह [] पर सेट होता हैइकट्ठा की जाने वाली सोर्स फ़ाइलों की सूची. |
public_hdrs
|
डिफ़ॉल्ट तौर पर यह [] पर सेट होता हैsrcs को कंपाइल करने के लिए, हेडर की सूची ज़रूरी है. इसे डिपेंडेंट नियमों में, ट्रांज़िशन के लिए शामिल किया जा सकता है. |
private_hdrs
|
डिफ़ॉल्ट तौर पर यह [] पर सेट होता हैsrcs को कंपाइल करने के लिए, हेडर की सूची ज़रूरी है. साथ ही, इसे डिपेंडेंट नियमों से शामिल नहीं किया जा सकता. |
includes
|
क्रम; या depset;
डिफ़ॉल्ट यह है [] एंगल ब्रैकेट और कोट, दोनों से रेफ़र की गई हेडर फ़ाइलों के लिए खोज पाथ. आम तौर पर -I के साथ पास किया जाता है. आश्रितों के लिए संक्रामक रूप से फैलाया जाता है. |
quote_includes
|
डिफ़ॉल्ट वैल्यू [] हैकोट से रेफ़र की गई हेडर फ़ाइलों के लिए खोज पाथ, जैसे कि #include "foo/bar/header.h". वे या तो exec रूट या निरपेक्ष के सापेक्ष हो सकते हैं. आम तौर पर, इसे -iquote से पास किया जाता है. आश्रितों के लिए संक्रामक रूप से फैलाया जाता है. |
system_includes
|
डिफ़ॉल्ट वैल्यू [] हैऐंगल ब्रैकेट से रेफ़र की गई हेडर फ़ाइलों के लिए खोज पाथ, जैसे कि #include <foo/bar/header.h>. वे exec रूट या ऐब्सलूट, से मिलते-जुलते हो सकते हैं. आम तौर पर -isystem के साथ पास किया जाता है. आश्रितों के लिए संक्रामक रूप से फैलाया जाता है. |
framework_includes
|
डिफ़ॉल्ट तौर पर यह [] पर सेट होता हैApple फ़्रेमवर्क की हेडर फ़ाइलों के लिए खोज पाथ. वे या तो exec रूट या निरपेक्ष के सापेक्ष हो सकते हैं. आम तौर पर, -F से पास होता है. आश्रितों के लिए संक्रामक रूप से फैलाया जाता है. |
defines
|
डिफ़ॉल्ट वैल्यू [] हैइस टारगेट को तैयार करने के लिए, वैल्यू का सेट ज़रूरी है. हर परिभाषा एक स्ट्रिंग होती है. आश्रितों के लिए संक्रामक रूप से फैलाया जाता है. |
local_defines
|
डिफ़ॉल्ट वैल्यू [] हैइस टारगेट को तैयार करने के लिए, वैल्यू का सेट ज़रूरी है. हर परिभाषा एक स्ट्रिंग होती है. आश्रितों को ट्रांज़िटिव नहीं किया जाता. |
include_prefix
|
डिफ़ॉल्ट वैल्यू '' हैइस नियम के हेडर के पाथ में जोड़ने के लिए प्रीफ़िक्स. अगर यह सेट हो जाता है, तो इस नियम के hdrs एट्रिब्यूट के हेडर को ऐक्सेस किया जा सकता है. यह वैल्यू, रिपॉज़िटरी-रिलेटिव पाथ में पहले से जोड़े गए इस एट्रिब्यूट की वैल्यू होती है. इस प्रीफ़िक्स को जोड़ने से पहले, Strip_include_prefix एट्रिब्यूट में मौजूद प्रीफ़िक्स को हटा दिया गया. |
strip_include_prefix
|
डिफ़ॉल्ट '' हैइस नियम के हेडर के पाथ से हटाया जाने वाला प्रीफ़िक्स. अगर यह सेट हो जाता है, तो इस प्रीफ़िक्स के कट जाने पर, इस नियम के hdrs एट्रिब्यूट में हेडर को उनके पाथ पर ऐक्सेस किया जा सकता है. अगर यह पाथ मिलता-जुलता है, तो इसे पैकेज-रिलेटिव के तौर पर माना जाता है. अगर यह एक सटीक है, तो इसे रिपॉज़िटरी-रिलेटिव पाथ के तौर पर माना जाता है. इस प्रीफ़िक्स को हटाने के बाद, include_prefix एट्रिब्यूट में प्रीफ़िक्स जोड़ा गया है. |
user_compile_flags
|
डिफ़ॉल्ट वैल्यू [] हैकंपाइलेशन के विकल्पों की अन्य सूची. |
compilation_contexts
|
डिफ़ॉल्ट वैल्यू [] हैकंपाइलेशन के लिए इस्तेमाल की जाने वाली डिपेंडेंसी के हेडर. |
name
|
ज़रूरी है इसका इस्तेमाल, इस तरीके से बनाए गए ऐक्शन के आउटपुट आर्टफ़ैक्ट को नाम देने के लिए किया जाता है. `main_OUT` आर्ग्युमेंट भी देखें. |
disallow_pic_outputs
|
डिफ़ॉल्ट वैल्यू False हैपीआईसी आउटपुट बनाए जाने चाहिए या नहीं. |
disallow_nopic_outputs
|
डिफ़ॉल्ट False हैNOPIC आउटपुट बनाया जाना चाहिए या नहीं. |
additional_inputs
|
डिफ़ॉल्ट सेटिंग [] हैsrcs को कंपाइल करने के लिए ज़रूरी अतिरिक्त फ़ाइलों की सूची |
configure_features
FeatureConfiguration cc_common.configure_features(ctx=None, cc_toolchain, language=None, requested_features=[], unsupported_features=[])device_कॉन्फ़िगरेशन इंस्टेंस बनाता है. cpp कॉन्फ़िगरेशन फ़्रैगमेंट की ज़रूरत होती है.
पैरामीटर
पैरामीटर | ब्यौरा |
---|---|
ctx
|
ctx; या None ;
डिफ़ॉल्ट रूप से None नियम का संदर्भ है. |
cc_toolchain
|
ज़रूरी है cc_toolchain जिसके लिए हम सुविधाएं कॉन्फ़िगर करते हैं. |
language
|
string; या None ;
डिफ़ॉल्ट तौर पर None हैवह भाषा जिसके लिए कॉन्फ़िगर करना है: c++ या objc (डिफ़ॉल्ट c++) |
requested_features
|
[] डिफ़ॉल्ट के तौर पर सेट हैचालू की जाने वाली सुविधाओं की सूची. |
unsupported_features
|
डिफ़ॉल्ट सेटिंग [] हैउन सुविधाओं की सूची जिन पर मौजूदा नियम लागू नहीं होगा. |
create_cc_toolchain_config_info
CcToolchainConfigInfo cc_common.create_cc_toolchain_config_info(ctx, features=[], action_configs=[], artifact_name_patterns=[], cxx_builtin_include_directories=[], toolchain_identifier, host_system_name=None, target_system_name, target_cpu, target_libc, compiler, abi_version=None, abi_libc_version=None, tool_paths=[], make_variables=[], builtin_sysroot=None, cc_target_os=None)
CcToolchainConfigInfo
प्रोवाइडर
बनाता है
पैरामीटर
पैरामीटर | ब्यौरा |
---|---|
ctx
|
ज़रूरी है नियम का संदर्भ. |
features
|
डिफ़ॉल्ट वैल्यू [] हैइसमें एक सुविधा के लिए सभी फ़्लैग की खास जानकारी होती है. तर्क:
- provides में किसी अन्य सुविधा या कार्रवाई कॉन्फ़िगरेशन का नाम हो, जिसे हम चालू करना चाहते हैं.- provides में वही वैल्यू मौजूद है जो किसी दूसरी सुविधा या कार्रवाई कॉन्फ़िगरेशन में 'उपलब्ध कराई जाती है' में मौजूद है, जिसे हम चालू करना चाहते हैं. इसका इस्तेमाल यह पक्का करने के लिए करें कि काम न करने वाली सुविधाएं एक ही समय पर गलती से चालू न हो पाएं. इससे कंपाइलर गड़बड़ियों का पता लगाने में मुश्किल होती है.
|
action_configs
|
डिफ़ॉल्ट तौर पर यह [] पर सेट होता हैऐक्शन कॉन्फ़िगरेशन, Bazel ऐक्शन से जुड़ा होता है. इसमें, चालू सुविधाओं के आधार पर किसी टूल को चुना जाता है. कार्रवाई कॉन्फ़िगरेशन चालू होने की प्रोसेस, सुविधाओं जैसे सिमेंटिक्स के हिसाब से होती है: कोई सुविधा, किसी कार्रवाई कॉन्फ़िगरेशन को किसी दूसरी सुविधा की तरह ही 'ज़रूरी' या 'लागू' कर सकती है. तर्क:
|
artifact_name_patterns
|
डिफ़ॉल्ट है [] किसी कार्रवाई के लिए इनपुट या आउटपुट आर्टफ़ैक्ट की दी गई कैटगरी के आर्टफ़ैक्ट का नाम. तर्क:
|
cxx_builtin_include_directories
|
डिफ़ॉल्ट वैल्यू [] है C++ कंपाइल करने के लिए पहले से मौजूद डायरेक्ट्री शामिल हैं. ये सटीक पाथ होने चाहिए, जिनका इस्तेमाल कंपाइलर करता है. साथ ही, ये आम तौर पर exec रूट के मिलते-जुलते होने चाहिए. कंपाइलर जिस पाथ का इस्तेमाल करता है उसे 'gcc -E -xc++ - -v' की मदद से तय किया जा सकता है. हम फ़िलहाल C कंपाइलेशन के लिए भी C++ पाथ का इस्तेमाल करते हैं. यह तब तक सुरक्षित रहता है, जब तक C++ और C हेडर फ़ाइलों के बीच नाम का टकराव न हो. रिलेटिव पाथ का समाधान, कॉन्फ़िगरेशन फ़ाइल डायरेक्ट्री के आधार पर किया जाता है. अगर कंपाइलर के पास --sysroot सहायता है, तो इन पाथ को शामिल पाथ के बजाय %sysroot% का इस्तेमाल करना चाहिए और सही जगह बदलने के लिए ज़रूरी जानकारी देने के लिए sysroot एट्रिब्यूट तय करना चाहिए. |
toolchain_identifier
|
ज़रूरी है क्रॉसटूल रिलीज़ में टूलचेन का यूनीक आइडेंटिफ़ायर. पाथ में इसे डायरेक्ट्री के नाम के तौर पर इस्तेमाल किया जा सकता है. इसे इस रेगुलर एक्सप्रेशन से मैच होना चाहिए: [a-zA-Z_][\.\- \w]* |
host_system_name
|
string; या None ;
डिफ़ॉल्ट तौर पर None अनदेखा किया जाता है. |
target_system_name
|
ज़रूरी है GNU सिस्टम का नाम. |
target_cpu
|
ज़रूरी है टारगेट आर्किटेक्चर स्ट्रिंग. |
target_libc
|
ज़रूरी है libc वर्शन स्ट्रिंग (उदाहरण के लिए, "glibc-2.2.2"). |
compiler
|
ज़रूरी है कंपाइलर वर्शन स्ट्रिंग (उदाहरण के लिए, "gcc-4.1.1"). |
abi_version
|
string; या None ;
डिफ़ॉल्ट None हैabi का इस्तेमाल हो रहा है, जो gcc वर्शन है. E.g.: "जीसीसी-3.4" |
abi_libc_version
|
string; या None ;
डिफ़ॉल्ट None हैहम जिस abi का इस्तेमाल कर रहे हैं वह glibc का वर्शन है. |
tool_paths
|
[] टूल लोकेशन डिफ़ॉल्ट है. तर्क:
|
make_variables
|
डिफ़ॉल्ट [] हैएक ऐसा वैरिएबल बनाएं जिसे नियम के लिए ऐक्सेस किया जा सकता है. |
builtin_sysroot
|
string; या None ;
डिफ़ॉल्ट रूप से None पहले से मौजूद sysroot होता है. अगर यह एट्रिब्यूट मौजूद नहीं है, तो Bazel किसी दूसरे sysroot का इस्तेमाल करने की अनुमति नहीं देता. जैसे कि --grte_top विकल्प के ज़रिए. |
cc_target_os
|
string; या None ;
डिफ़ॉल्ट None हैयह सिर्फ़ अंदरूनी मकसद के लिए है, इसका इस्तेमाल न करें. |
create_compilation_context
CompilationContext cc_common.create_compilation_context(headers=unbound, system_includes=unbound, includes=unbound, quote_includes=unbound, framework_includes=unbound, defines=unbound, local_defines=unbound)
CompilationContext
बनाता है.
पैरामीटर
पैरामीटर | ब्यौरा |
---|---|
headers
|
डिफ़ॉल्ट वैल्यू unbound हैइस टारगेट को कंपाइल करने के लिए, हेडर का सेट ज़रूरी है |
system_includes
|
डिफ़ॉल्ट वैल्यू unbound हैऐंगल ब्रैकेट से जुड़ी हेडर फ़ाइलों के लिए, खोज पाथ का सेट, जैसे कि #include <foo/bar/header.h>. वे exec रूट या ऐब्सलूट, दोनों से जुड़े हो सकते हैं. आम तौर पर -isystem से पास किया जाता है |
includes
|
डिफ़ॉल्ट वैल्यू unbound हैऐंगल ब्रैकेट और कोट दोनों से रेफ़र की गई हेडर फ़ाइलों के लिए, खोज पाथ का सेट.आम तौर पर, इसे -I के साथ पास किया जाता है |
quote_includes
|
डिफ़ॉल्ट वैल्यू unbound हैकोट से रेफ़र की गई हेडर फ़ाइलों के लिए, खोज पाथ का सेट. उदाहरण के लिए, #include "foo/bar/header.h". वे या तो exec रूट या निरपेक्ष के सापेक्ष हो सकते हैं. आम तौर पर -iquote के साथ पास किया जाता है |
framework_includes
|
डिफ़ॉल्ट वैल्यू unbound हैहेडर फ़ाइलों के लिए, फ़्रेमवर्क खोज पाथ का सेट (सिर्फ़ Apple प्लैटफ़ॉर्म के लिए) |
defines
|
डिफ़ॉल्ट वैल्यू unbound हैइस टारगेट को तैयार करने के लिए, वैल्यू का सेट ज़रूरी है. हर परिभाषा एक स्ट्रिंग होती है. आश्रितों के लिए संक्रमित रूप से फैलाया जाता है. |
local_defines
|
डिफ़ॉल्ट वैल्यू unbound हैइस टारगेट को तैयार करने के लिए, वैल्यू का सेट ज़रूरी है. हर परिभाषा एक स्ट्रिंग होती है. आश्रितों को ट्रांज़िट के रूप में नहीं भेजा जाता. |
create_compilation_outputs
CcCompilationOutputs cc_common.create_compilation_outputs(objects=None, pic_objects=None)कंपाइलेशन आउटपुट ऑब्जेक्ट बनाएं.
पैरामीटर
पैरामीटर | ब्यौरा |
---|---|
objects
|
depset; या None ;
डिफ़ॉल्ट रूप से None ऑब्जेक्ट फ़ाइलों की सूची है. |
pic_objects
|
depset; या None ;
डिफ़ॉल्ट तौर पर None तस्वीर वाली ऑब्जेक्ट फ़ाइलों की सूची होती है. |
create_compile_variables
Variables cc_common.create_compile_variables(cc_toolchain, feature_configuration, source_file=None, output_file=None, user_compile_flags=None, include_directories=None, quote_include_directories=None, system_include_directories=None, framework_include_directories=None, preprocessor_defines=None, thinlto_index=None, thinlto_input_bitcode_file=None, thinlto_output_object_file=None, use_pic=False, add_legacy_cxx_options=False, variables_extension=unbound)कंपाइलेशन ऐक्शन के लिए इस्तेमाल किए जाने वाले वैरिएबल दिखाता है.
पैरामीटर
पैरामीटर | ब्यौरा |
---|---|
cc_toolchain
|
ज़रूरी है cc_toolchain, जिसके लिए हम बिल्ड वैरिएबल बना रहे हैं. |
feature_configuration
|
सुविधा के कॉन्फ़िगरेशन के लिए क्वेरी करना ज़रूरी है. |
source_file
|
डिफ़ॉल्ट तौर पर यह None कंपाइलेशन के लिए, एक वैकल्पिक सोर्स फ़ाइल होती है. कृपया cc_Common.get_memory_inefficiency_command_line से जनरेट की गई कमांड लाइन के आखिर में जोड़ने के बजाय, source_file को पास करें. ऐसा करने पर, टूलटिप के फ़्लैग को सही तरीके से बताने और सही जगह पर लाने के लिए, टूलचेन लेखक का काम होता है. |
output_file
|
डिफ़ॉल्ट वैल्यू None हैकंपाइलेशन की आउटपुट फ़ाइल देना ज़रूरी नहीं है. कृपया cc_Common.get_memory_inefficiency_command_line से जनरेट की गई कमांड लाइन के आखिर में जोड़े जाने के लिए, load_file को यहां पास करें. ऐसा करने पर, टूलचेन के लेखक, कंपाइलर फ़्लैग को सही तरीके से तय और पोज़िशन कर पाते हैं. |
user_compile_flags
|
स्ट्रिंग का क्रम या None ;
डिफ़ॉल्ट रूप से None अन्य कंपाइलेशन फ़्लैग (कॉप्ट) की सूची होती है. |
include_directories
|
depset; या None ;
डिफ़ॉल्ट रूप से None हैशामिल की गई डायरेक्ट्री का डिपसेट. |
quote_include_directories
|
depset; या None ;
डिफ़ॉल्ट रूप से None हैकोटेशन के डिपसेट में डायरेक्ट्री शामिल होती है. |
system_include_directories
|
depset; या None ;
डिफ़ॉल्ट None हैसिस्टम के विवरण में डायरेक्ट्री शामिल हैं. |
framework_include_directories
|
depset; या None ;
डिफ़ॉल्ट रूप से None हैफ़्रेमवर्क के विवरण में डायरेक्ट्री शामिल होती हैं. |
preprocessor_defines
|
depset; या None ;
डिफ़ॉल्ट None हैप्रीप्रोसेसर का विवरण. |
thinlto_index
|
string; या None ;
डिफ़ॉल्ट रूप से, None LTO इंडेक्स फ़ाइल पाथ होता है. |
thinlto_input_bitcode_file
|
string; या None ;
डिफ़ॉल्ट रूप से None एलटीओ बैकएंड के लिए इनपुट की गई बिटकोड फ़ाइल होती है. |
thinlto_output_object_file
|
string; या None ;
डिफ़ॉल्ट रूप से, None ऑब्जेक्ट फ़ाइल होती है, जिसका आउटपुट LTO बैकएंड से मिलता है. |
use_pic
|
डिफ़ॉल्ट वैल्यू False पर सेट होती हैसही होने पर, कंपाइलेशन, पोज़िशन से अलग कोड जनरेट करेगा. |
add_legacy_cxx_options
|
डिफ़ॉल्ट वैल्यू False इस्तेमाल नहीं की गई है. |
variables_extension
|
dict;
डिफ़ॉल्ट तौर पर unbound होता हैअतिरिक्त वैरिएबल का डिक्शनरी, जिसका इस्तेमाल कंपाइल कार्रवाइयों में किया जाता है. |
create_library_to_link
LibraryToLink cc_common.create_library_to_link(actions, feature_configuration=None, cc_toolchain=None, static_library=None, pic_static_library=None, dynamic_library=None, interface_library=None, pic_objects=unbound, objects=unbound, alwayslink=False, dynamic_library_symlink_path='', interface_library_symlink_path='')
LibraryToLink
को
बनाया जाता है
पैरामीटर
पैरामीटर | ब्यौरा |
---|---|
actions
|
ज़रूरी हैactions ऑब्जेक्ट.
|
feature_configuration
|
डिफ़ॉल्ट के तौर पर सेट None feature_configuration क्वेरी की जाती है.
|
cc_toolchain
|
डिफ़ॉल्ट तौर पर, None CcToolchainInfo सेवा देने वाली कंपनी का इस्तेमाल किया जाता है.
|
static_library
|
फ़ाइल या None ;
डिफ़ॉल्ट रूप से लिंक की जाने वाली स्टैटिक लाइब्रेरी का None File है.
|
pic_static_library
|
फ़ाइल या None ;
डिफ़ॉल्ट रूप से लिंक की जाने वाली तस्वीर की स्टैटिक लाइब्रेरी का None File है.
|
dynamic_library
|
फ़ाइल या None ;
डिफ़ॉल्ट रूप से यह डाइनैमिक लाइब्रेरी का None File है, जिसे लिंक करना है. इसका इस्तेमाल हमेशा रनटाइम के लिए किया जाता है. interface_library पास न होने पर, इसका इस्तेमाल लिंक करने के लिए किया जाता है.
|
interface_library
|
फ़ाइल या None ;
डिफ़ॉल्ट रूप से यह इंटरफ़ेस लाइब्रेरी का None File है जिसे लिंक करना है.
|
pic_objects
|
फ़ाइल का क्रम;
डिफ़ॉल्ट तौर पर unbound एक्सपेरिमेंट के तौर पर उपलब्ध है, इसका इस्तेमाल न करें |
objects
|
फ़ाइल का क्रम;
डिफ़ॉल्ट तौर पर unbound एक्सपेरिमेंट के तौर पर उपलब्ध है, इसका इस्तेमाल न करें |
alwayslink
|
डिफ़ॉल्ट वैल्यू False है--whole_archive ब्लॉक में स्टैटिक लाइब्रेरी/ऑब्जेक्ट को लिंक करना है या नहीं. |
dynamic_library_symlink_path
|
string;
डिफ़ॉल्ट तौर पर यह '' पर सेट होता हैSolib डायरेक्ट्री में डाइनैमिक लाइब्रेरी के लिंक का डिफ़ॉल्ट पाथ बदलें. डिफ़ॉल्ट का इस्तेमाल करने के लिए स्ट्रिंग खाली है. |
interface_library_symlink_path
|
डिफ़ॉल्ट वैल्यू '' हैSolib डायरेक्ट्री में इंटरफ़ेस लाइब्रेरी के लिंक का डिफ़ॉल्ट पाथ बदलें. डिफ़ॉल्ट का इस्तेमाल करने के लिए स्ट्रिंग खाली है. |
create_link_variables
Variables cc_common.create_link_variables(cc_toolchain, feature_configuration, library_search_directories=None, runtime_library_search_directories=None, user_link_flags=None, output_file=None, param_file=None, def_file=None, is_using_linker=True, is_linking_dynamic_library=False, must_keep_debug=True, use_test_only_flags=False, is_static_linking_mode=True)लिंक करने की कार्रवाइयों के लिए इस्तेमाल किए जाने वाले लिंक वैरिएबल दिखाता है.
पैरामीटर
पैरामीटर | ब्यौरा |
---|---|
cc_toolchain
|
ज़रूरी है cc_toolchain, जिसके लिए हम बिल्ड वैरिएबल बना रहे हैं. |
feature_configuration
|
सुविधा के कॉन्फ़िगरेशन के लिए क्वेरी करना ज़रूरी है. |
library_search_directories
|
None ; या depset;
डिफ़ॉल्ट है None उन डायरेक्ट्री का डिपसेट जहां लिंकर, लिंक के समय लाइब्रेरी को खोजेगा. |
runtime_library_search_directories
|
None ; या depset;
डिफ़ॉल्ट रूप से यह None उन डायरेक्ट्री का डिपसेट है जहां लोडर, रनटाइम के दौरान लाइब्रेरी खोजेगा. |
user_link_flags
|
None या क्रम;
डिफ़ॉल्ट रूप से None हैअन्य लिंक फ़्लैग (linkopts) की सूची. |
output_file
|
डिफ़ॉल्ट तौर पर सेट है None आउटपुट फ़ाइल पाथ ज़रूरी नहीं है. |
param_file
|
डिफ़ॉल्ट वैल्यू है None पैरामीटर फ़ाइल पाथ ज़रूरी नहीं है. |
def_file
|
डिफ़ॉल्ट None है.def फ़ाइल पाथ ज़रूरी नहीं है. |
is_using_linker
|
डिफ़ॉल्ट रूप से यह True लिंकर का इस्तेमाल करते समय 'सही' होता है और संग्रहित करने वाले टूल के तौर पर 'गलत' पर सेट होता है. कॉल करने वाले (कॉलर) की ज़िम्मेदारी यह है कि उसे इस्तेमाल की जाने वाली कार्रवाई के नाम के साथ सिंक किया जाए (is_using_linker = एक्ज़ीक्यूटेबल या डाइनैमिक लाइब्रेरी को लिंक करने के लिए सही, is_use_linker = स्टैटिक लाइब्रेरी को संग्रहित करने के लिए गलत). |
is_linking_dynamic_library
|
डिफ़ॉल्ट रूप से यह False डाइनैमिक लाइब्रेरी बनाते समय 'सही' होता है. हालांकि, एक्ज़ीक्यूटेबल या स्टैटिक लाइब्रेरी के तौर पर, यह 'गलत' पर सेट होता है. कॉल करने वाले (कॉलर) की ज़िम्मेदारी है कि वह इसे, इस्तेमाल की जा रही कार्रवाई के नाम के साथ सिंक रखे. b/65151735 के ठीक हो जाने पर, यह फ़ील्ड हटा दिया जाएगा. |
must_keep_debug
|
डिफ़ॉल्ट वैल्यू True है'गलत है' पर सेट करने पर, bazel 'strip_debug_सिंबोल' वैरिएबल को दिखाएगा. आम तौर पर, इसका इस्तेमाल आउटपुट फ़ाइल से डीबग सिंबल को हटाने के लिए, लिंकर का इस्तेमाल करने के लिए किया जाता है. |
use_test_only_flags
|
डिफ़ॉल्ट वैल्यू False हैसही पर सेट होने पर, 'is_cc_test' वैरिएबल सेट हो जाएगा. |
is_static_linking_mode
|
डिफ़ॉल्ट वैल्यू True इस्तेमाल नहीं की गई है. |
create_linker_input
LinkerInput cc_common.create_linker_input(owner, libraries=None, user_link_flags=None, additional_inputs=None)
LinkerInput
बनाता है.
पैरामीटर
पैरामीटर | ब्यौरा |
---|---|
owner
|
ज़रूरी है उस टारगेट का लेबल जिसने इस इनपुट में इस्तेमाल की गई सभी फ़ाइलें बनाई हैं. |
libraries
|
None ; या depset;
डिफ़ॉल्ट, None हैLibraryToLink की सूची.
|
user_link_flags
|
None ; या स्ट्रिंग के depset या स्ट्रिंग के क्रम;
डिफ़ॉल्ट रूप से, None उपयोगकर्ता के लिंक के फ़्लैग को स्ट्रिंग के तौर पर पास किया जाता है. [String], [[String]] या depset(String) में से किसी एक का इस्तेमाल करता है. नहीं सलाह दी जाती है, क्योंकि इसे सिर्फ़ साथ काम करने के मकसद से रखा जाता है और डिपसेट को समतल किया जाता है. अगर आपको user_link_flags को अनफ़्लैट किए गए depsets() के ज़रिए लागू करना है, तो उन्हें Linkerइनपुट में रैप करें, ताकि वे आखिर तक एक समान न हों. |
additional_inputs
|
None ; या depset;
डिफ़ॉल्ट None हैलिंक करने की कार्रवाई से जुड़े दूसरे इनपुट के लिए, जैसे: लिंक करने की स्क्रिप्ट. |
create_linking_context
LinkingContext cc_common.create_linking_context(linker_inputs=None, libraries_to_link=None, user_link_flags=None, additional_inputs=None)
LinkingContext
बनाता है.
पैरामीटर
पैरामीटर | ब्यौरा |
---|---|
linker_inputs
|
None ; या depset;
डिफ़ॉल्ट रूप से None LinkerInput है.
|
libraries_to_link
|
None ; या क्रम;
डिफ़ॉल्ट रूप से None है अब काम नहीं करता. इस पैरामीटर के इस्तेमाल पर रोक लगा दी गई है और इसे जल्द ही हटा दिया जाएगा. कृपया इस पर निर्भर न रहें. यह --+incompatible_require_linker_input_cc_api के साथ बंद है. इस फ़्लैग का इस्तेमाल करके यह पुष्टि करें कि आपका कोड, तुरंत हटाए जाने के लिए इस्तेमाल किया जा सकता है या नहीं. LibraryToLink की सूची.
|
user_link_flags
|
None ; या क्रम;
डिफ़ॉल्ट रूप से None है अब काम नहीं करता. इस पैरामीटर के इस्तेमाल पर रोक लगा दी गई है और इसे जल्द ही हटा दिया जाएगा. कृपया इस पर निर्भर न रहें. यह --+incompatible_require_linker_input_cc_api के साथ बंद है. इस फ़्लैग का इस्तेमाल करके यह पुष्टि करें कि आपका कोड, तुरंत हटाए जाने के लिए इस्तेमाल किया जा सकता है या नहीं. स्ट्रिंग के तौर पर पास किए गए, उपयोगकर्ता के लिंक के फ़्लैग की सूची. |
additional_inputs
|
None ; या क्रम;
डिफ़ॉल्ट रूप से None है अब काम नहीं करता. इस पैरामीटर के इस्तेमाल पर रोक लगा दी गई है और इसे जल्द ही हटा दिया जाएगा. कृपया इस पर निर्भर न रहें. यह --+incompatible_require_linker_input_cc_api के साथ बंद है. इस फ़्लैग का इस्तेमाल करके यह पुष्टि करें कि आपका कोड, तुरंत हटाए जाने के लिए इस्तेमाल किया जा सकता है या नहीं. लिंक करने की कार्रवाई से जुड़े दूसरे इनपुट के लिए, जैसे कि स्क्रिप्ट लिंक करना. |
create_linking_context_from_compilation_outputs
tuple cc_common.create_linking_context_from_compilation_outputs(actions, feature_configuration, cc_toolchain, compilation_outputs, user_link_flags=[], linking_contexts=[], name, language='c++', alwayslink=False, additional_inputs=[], disallow_static_libraries=False, disallow_dynamic_library=False)इसका इस्तेमाल लाइब्रेरी के ऐसे नियम बनाने के लिए किया जाना चाहिए जो डाउनस्ट्रीम में जानकारी को लागू कर सकें, ताकि बाद में एक टॉप लेवल नियम से लिंक किया जा सके जो एक्ज़ीक्यूटेबल या डाइनैमिक लाइब्रेरी बनाने के लिए ट्रांज़िटिव लिंकिंग का इस्तेमाल करता है. (
CcLinkingContext
, CcLinkingOutputs
) का टपल देता है.
पैरामीटर
पैरामीटर | ब्यौरा |
---|---|
actions
|
ज़रूरी हैactions ऑब्जेक्ट.
|
feature_configuration
|
feature_configuration क्वेरी करना ज़रूरी है.
|
cc_toolchain
|
CcToolchainInfo कंपनी का इस्तेमाल करना ज़रूरी है.
|
compilation_outputs
|
ज़रूरी है लिंक करने के लिए ऑब्जेक्ट फ़ाइलों वाले कंपाइलेशन आउटपुट. |
user_link_flags
|
डिफ़ॉल्ट के तौर पर सेट है [] लिंक करने के विकल्पों की अन्य सूची. |
linking_contexts
|
[] डिपेंडेंसी की लाइब्रेरी डिफ़ॉल्ट पर सेट होती हैं. इन लाइब्रेरी को link() कॉल के आउटपुट आर्टफ़ैक्ट में जोड़ा जाएगा. फिर चाहे वह कोई बाइनरी हो या लाइब्रेरी. |
name
|
ज़रूरी है इसका इस्तेमाल, इस तरीके से बनाए गए ऐक्शन के आउटपुट आर्टफ़ैक्ट को नाम देने के लिए किया जाता है. |
language
|
डिफ़ॉल्ट वैल्यू 'c++' हैफ़िलहाल, यह सुविधा सिर्फ़ C++ फ़ॉर्मैट में काम करती है. इस पैरामीटर का इस्तेमाल न करें. |
alwayslink
|
डिफ़ॉल्ट तौर पर यह False पर सेट होता हैयह लाइब्रेरी हमेशा लिंक होनी चाहिए या नहीं. |
additional_inputs
|
डिफ़ॉल्ट वैल्यू [] हैलिंक करने की कार्रवाई से जुड़े अन्य इनपुट के लिए, जैसे: स्क्रिप्ट लिंक करना. |
disallow_static_libraries
|
डिफ़ॉल्ट तौर पर यह False पर सेट होता हैस्टैटिक लाइब्रेरी बनाई जानी चाहिए या नहीं. |
disallow_dynamic_library
|
डिफ़ॉल्ट तौर पर यह False पर सेट होता हैडाइनैमिक लाइब्रेरी बनाई जानी चाहिए या नहीं. |
do_not_use_tools_cpp_compiler_present
None
cc_common.do_not_use_tools_cpp_compiler_present
इस फ़ील्ड का इस्तेमाल न करें. इसका सिर्फ़ मकसद config_setting.values{'compiler') से config_settings.flag_values{'@bazel_tools//tools/cpp:compiler'} में माइग्रेट करने में मदद करना है
get_environment_variables
dict cc_common.get_environment_variables(feature_configuration, action_name, variables)दी गई कार्रवाई के लिए सेट किए जाने वाले एनवायरमेंट वैरिएबल दिखाता है.
पैरामीटर
पैरामीटर | ब्यौरा |
---|---|
feature_configuration
|
सुविधा के कॉन्फ़िगरेशन के लिए क्वेरी करना ज़रूरी है. |
action_name
|
ज़रूरी है कार्रवाई का नाम. यह @bazel_tools//tools/build_defs/cc:action_names.bzl (https://github.com/bazelbuild/bazel/blob/master/tools/build_defs/cc/action_names.bzl) में मौजूद नामों में से एक होना चाहिए |
variables
|
ज़रूरी है टेंप्लेट एक्सपैंशन के लिए इस्तेमाल करने के लिए वैरिएबल बनाएं. |
get_execution_requirements
sequence cc_common.get_execution_requirements(feature_configuration, action_name)दी गई कार्रवाई के लिए, लागू होने की ज़रूरी शर्तें दिखाता है.
पैरामीटर
पैरामीटर | ब्यौरा |
---|---|
feature_configuration
|
सुविधा के कॉन्फ़िगरेशन के लिए क्वेरी करना ज़रूरी है. |
action_name
|
ज़रूरी है कार्रवाई का नाम. यह @bazel_tools//tools/build_defs/cc:action_names.bzl (https://github.com/bazelbuild/bazel/blob/master/tools/build_defs/cc/action_names.bzl) में मौजूद नामों में से एक होना चाहिए |
get_memory_inefficient_command_line
sequence cc_common.get_memory_inefficient_command_line(feature_configuration, action_name, variables)दी गई कार्रवाई के लिए, कमांड लाइन को फ़्लैट करने वाले फ़्लैग दिखाता है. ऐसा करने के लिए, दिए गए वैरिएबल का इस्तेमाल किया जाता है. नेस्ट किए गए सेट को फ़्लैट करता है और आम तौर पर, इनका इस्तेमाल नहीं किया जाना चाहिए या कम से कम विश्लेषण से बाहर नहीं जाना चाहिए. Args देने वाले मेमोरी कुशल फ़ंक्शन पर काम जारी है.
पैरामीटर
पैरामीटर | ब्यौरा |
---|---|
feature_configuration
|
सुविधा के कॉन्फ़िगरेशन के लिए क्वेरी करना ज़रूरी है. |
action_name
|
ज़रूरी है कार्रवाई का नाम. यह @bazel_tools//tools/build_defs/cc:action_names.bzl (https://github.com/bazelbuild/bazel/blob/master/tools/build_defs/cc/action_names.bzl) में मौजूद नामों में से एक होना चाहिए |
variables
|
ज़रूरी है टेंप्लेट एक्सपैंशन के लिए इस्तेमाल करने के लिए वैरिएबल बनाएं. |
get_tool_for_action
string cc_common.get_tool_for_action(feature_configuration, action_name)दी गई कार्रवाई के लिए टूल पाथ दिखाता है.
पैरामीटर
पैरामीटर | ब्यौरा |
---|---|
feature_configuration
|
सुविधा के कॉन्फ़िगरेशन के लिए क्वेरी करना ज़रूरी है. |
action_name
|
ज़रूरी है कार्रवाई का नाम. यह @bazel_tools//tools/build_defs/cc:action_names.bzl (https://github.com/bazelbuild/bazel/blob/master/tools/build_defs/cc/action_names.bzl) में मौजूद नामों में से एक होना चाहिए |
is_enabled
bool cc_common.is_enabled(feature_configuration, feature_name)अगर सुविधा के कॉन्फ़िगरेशन में, दी गई सुविधा चालू है, तो 'सही' दिखाता है.
पैरामीटर
पैरामीटर | ब्यौरा |
---|---|
feature_configuration
|
सुविधा के कॉन्फ़िगरेशन के लिए क्वेरी करना ज़रूरी है. |
feature_name
|
ज़रूरी है सुविधा का नाम. |
लिंक
CcLinkingOutputs cc_common.link(actions, feature_configuration, cc_toolchain, compilation_outputs=None, user_link_flags=[], linking_contexts=[], name, language='c++', output_type='executable', link_deps_statically=True, stamp=0, additional_inputs=[], additional_outputs=unbound)इसका इस्तेमाल C++ ट्रांज़िटिव लिंकिंग के लिए किया जाना चाहिए.
पैरामीटर
पैरामीटर | ब्यौरा |
---|---|
actions
|
ज़रूरी हैactions ऑब्जेक्ट.
|
feature_configuration
|
feature_configuration क्वेरी करना ज़रूरी है.
|
cc_toolchain
|
CcToolchainInfo कंपनी का इस्तेमाल करना ज़रूरी है.
|
compilation_outputs
|
CcCompilationOutputs; या None ;
डिफ़ॉल्ट रूप से None है कंपाइलेशन आउटपुट, जिनमें लिंक की जाने वाली ऑब्जेक्ट फ़ाइलें होती हैं. |
user_link_flags
|
डिफ़ॉल्ट सेटिंग यह है: [] लिंकर के विकल्पों की अन्य सूची. |
linking_contexts
|
डिफ़ॉल्ट सेटिंग [] हैइस नियम से जनरेट किए गए लिंक के कॉन्टेक्स्ट में जोड़ने के लिए, डिपेंडेंसी से कॉन्टेक्स्ट लिंक करना. |
name
|
ज़रूरी है इसका इस्तेमाल, इस तरीके से बनाए गए ऐक्शन के आउटपुट आर्टफ़ैक्ट को नाम देने के लिए किया जाता है. |
language
|
डिफ़ॉल्ट वैल्यू 'c++' हैफ़िलहाल, यह सुविधा सिर्फ़ C++ फ़ॉर्मैट में काम करती है. इस पैरामीटर का इस्तेमाल न करें. |
output_type
|
डिफ़ॉल्ट वैल्यू 'executable' हैयह 'executable' या 'Dynamic_library' हो सकता है. |
link_deps_statically
|
डिफ़ॉल्ट रूप से, True पर सेट होता हैडिपेंडेंसी को स्टैटिक तरीके से लिंक करने के लिए, 'सही' और डाइनैमिक रूप से 'गलत' पर सेट होता है. |
stamp
|
डिफ़ॉल्ट 0 हैअगर out_type 'executable' है, तो लिंक किए गए एक्ज़ीक्यूटेबल में बिल्ड की जानकारी शामिल करनी है या नहीं. अगर यह एक समस्या है, तो बिल्ड की जानकारी हमेशा शामिल की जाती है. अगर इसका मान 0 है, तो बिल्ड की डिफ़ॉल्ट जानकारी को हमेशा शामिल नहीं किया जाता है. अगर -1 है, तो डिफ़ॉल्ट कार्रवाई का इस्तेमाल किया जाता है, जिसे --[no]stamp फ़्लैग से बदला जा सकता है. जांच के नियमों के लिए एक्ज़ीक्यूटेबल आउटपुट जनरेट करते समय, इसे सेट नहीं (या 0 पर सेट करना) होना चाहिए. |
additional_inputs
|
क्रम या depset; डिफ़ॉल्ट तौर पर यह [] पर सेट होता है. लिंक करने की कार्रवाई से जुड़े दूसरे इनपुट के लिए, उदाहरण के लिए: लिंक करने की स्क्रिप्ट. |
additional_outputs
|
क्रम;
डिफ़ॉल्ट unbound हैलिंकिंग कार्रवाई के अतिरिक्त आउटपुट के लिए, उदाहरण: मैप फ़ाइलें. |
merge_compilation_contexts
CompilationContext cc_common.merge_compilation_contexts(compilation_contexts=[])एक से ज़्यादा
CompilationContexts
को एक में मर्ज कर देता है.
पैरामीटर
पैरामीटर | ब्यौरा |
---|---|
compilation_contexts
|
[] डिफ़ॉल्ट पर सेट हैमर्ज किए जाने वाले CompilationContexts की सूची. हर कॉन्टेक्स्ट के हेडर को, डोमेन नेम देने वाली कंपनी के डायरेक्ट फ़ील्ड से एक्सपोर्ट किया जाएगा.
|
merge_compilation_outputs
CcCompilationOutputs cc_common.merge_compilation_outputs(compilation_outputs=[])कंपाइलेशन आउटपुट मर्ज करें.
पैरामीटर
पैरामीटर | ब्यौरा |
---|---|
compilation_outputs
|
डिफ़ॉल्ट वैल्यू [] है |