इस पेज का अनुवाद Cloud Translation API से किया गया है.

अतिरिक्त कार्रवाइयों के नियम

नियम

action_listener
extra_action

action_listener

action_listener(name, compatible_with, deprecation, distribs, exec_compatible_with, exec_properties, extra_actions, features, licenses, mnemonics, restricted_to, tags, target_compatible_with, testonly, visibility)

चेतावनी: अतिरिक्त कार्रवाइयों के इस्तेमाल पर रोक लगा दी गई है. इसके बजाय, आसपेक्ट का इस्तेमाल करें.

action_listener नियम खुद कोई आउटपुट नहीं देता. इसके बजाय, इससे टूल डेवलपर को बिल्ड सिस्टम में extra_action शामिल करने की अनुमति मिलती है. इसके लिए, उन्हें extra_action की कार्रवाई से मैपिंग की सुविधा मिलती है.

इस नियम का तर्क, याद रखने के तरीके को extra_action के नियमों से मैप करता है.

--experimental_action_listener=<label> विकल्प तय करने पर, बिल्ड बताए गए action_listener का इस्तेमाल करके, extra_action को बिल्ड ग्राफ़ में शामिल करेगा.

उदाहरण

action_listener(
    name = "index_all_languages",
    mnemonics = [
        "Javac",
        "CppCompile",
        "Python",
    ],
    extra_actions = [":indexer"],
)

action_listener(
    name = "index_java",
    mnemonics = ["Javac"],
    extra_actions = [":indexer"],
)

extra_action(
    name = "indexer",
    tools = ["//my/tools:indexer"],
    cmd = "$(location //my/tools:indexer)" +
          "--extra_action_file=$(EXTRA_ACTION_FILE)",
)

तर्क

विशेषताएं

विशेषताएं
`name`	नाम; ज़रूरी है इस टारगेट के लिए यूनीक नाम.
`extra_actions`	लेबल की सूची; ज़रूरी है टारगेट किए गए `extra_action` की सूची इस `action_listener` को बिल्ड ग्राफ़ में जोड़ना चाहिए. उदाहरण के लिए, `[ "//my/tools:analyzer" ]`.
`mnemonics`	स्ट्रिंग की सूची; ज़रूरी है काम की याद दिलाने वाली चीज़ों की एक सूची, जिसे इस `action_listener` को ध्यान में रखना चाहिए, जैसे कि `[ "Javac" ]`. याद रखने का तरीका कोई सार्वजनिक इंटरफ़ेस नहीं है. इस बात की कोई गारंटी नहीं है कि याद रखने की कला और उनके काम में कोई बदलाव नहीं होगा.

name

नाम; ज़रूरी है

इस टारगेट के लिए यूनीक नाम.

extra_actions

लेबल की सूची; ज़रूरी है

टारगेट किए गए extra_action की सूची इस action_listener को बिल्ड ग्राफ़ में जोड़ना चाहिए. उदाहरण के लिए, [ "//my/tools:analyzer" ].

mnemonics

स्ट्रिंग की सूची; ज़रूरी है

काम की याद दिलाने वाली चीज़ों की एक सूची, जिसे इस action_listener को ध्यान में रखना चाहिए, जैसे कि [ "Javac" ].

याद रखने का तरीका कोई सार्वजनिक इंटरफ़ेस नहीं है. इस बात की कोई गारंटी नहीं है कि याद रखने की कला और उनके काम में कोई बदलाव नहीं होगा.

extra_action

नियम का सोर्स देखें

extra_action(name, data, cmd, compatible_with, deprecation, distribs, exec_compatible_with, exec_properties, features, licenses, out_templates, requires_action_output, restricted_to, tags, target_compatible_with, testonly, toolchains, tools, visibility)

सामान्य बिल्ड टारगेट के तौर पर बताए जाने पर, extra_action नियम काम का कोई आउटपुट नहीं देता है. इसके बजाय, इससे टूल डेवलपर बिल्ड ग्राफ़ में ऐसी अन्य कार्रवाइयां डाल सकते हैं जो मौजूदा कार्रवाइयों को शैडो करती हैं.

extra_action को चालू करने का तरीका जानने के लिए, action_listener पर जाएं.

extra_action, कमांड-लाइन के तौर पर चलते हैं. कमांड लाइन टूल, इसके पास उन सभी इनपुट फ़ाइलों का ऐक्सेस भी होता है जिनका ऐक्सेस ओरिजनल ऐक्शन के पास है. प्रोटोकॉल बफ़र में सेव किए गए डेटा के बारे में ज़्यादा जानने के लिए, extra_actions_base.proto पर जाएं. हर प्रोटो फ़ाइल में एक ExtraActionInfo मैसेज होता है.

दूसरी सभी कार्रवाइयों की तरह ही, अतिरिक्त कार्रवाइयां सैंडबॉक्स की जाती हैं और उन्हें इस हिसाब से डिज़ाइन किया जाना चाहिए.

तर्क

विशेषताएं
`name`	नाम; ज़रूरी है इस टारगेट के लिए यूनीक नाम. आप `action_listener` नियमों के `extra_actions` आर्ग्युमेंट में, `label` के हिसाब से इस नियम को देख सकते हैं.
`cmd`	स्ट्रिंग; आवश्यक है चलाने के लिए निर्देश. जैसे, ये अंतर वाले gen बचाने cmd एट्रिब्यूट की तरह: अनुमान के हिसाब से लेबल को बढ़ाया नहीं जा सकता. सिर्फ़ $(location ...) का इस्तेमाल करने वाले लेबल को बड़ा किया जाता है. स्ट्रिंग पर एक अतिरिक्त पास लागू किया जाता है, ताकि `out_templates` एट्रिब्यूट से बनाए गए सभी आउटपुट को बदला जा सके. `$(output out_template)` सभी इंस्टेंस को उस फ़ाइल के पाथ से बदल दिया जाता है जो `label` से दिखाया गया है. उदाहरण के लिए, out_template `$(ACTION_ID).analysis` का मिलान `$(output $(ACTION_ID).analysis)` से किया जा सकता है. इस मामले में, यह `$(location)` जैसा ही है, लेकिन एक अलग स्कोप के साथ.
`out_templates`	स्ट्रिंग की सूची; डिफ़ॉल्ट `[]` है `extra_action` कमांड से जनरेट की गई फ़ाइलों के लिए, टेंप्लेट की सूची. टेंप्लेट में इन वैरिएबल का इस्तेमाल किया जा सकता है: $(ACTION_ID), एक आईडी है जो इस `extra_action` की खास तौर पर पहचान करता है. इसका इस्तेमाल, यूनीक आउटपुट फ़ाइल जनरेट करने के लिए किया जाता है.
`requires_action_output`	बूलियन; डिफ़ॉल्ट `False` है इससे पता चलता है कि `extra_action` को इस `extra_action` के इनपुट के तौर पर ओरिजनल कार्रवाई के आउटपुट का होना ज़रूरी है. सही (डिफ़ॉल्ट रूप से गलत) होने पर, extra_action यह मान सकती है कि मूल कार्रवाई आउटपुट उसके इनपुट के हिस्से के रूप में उपलब्ध हैं.
`tools`	लेबल की सूची; डिफ़ॉल्ट `[]` है इस नियम के लिए, `tool` डिपेंडेंसी की सूची. ज़्यादा जानकारी के लिए, डिपेंडेंसी की परिभाषा देखें. बिल्ड सिस्टम यह पक्का करता है कि इन ज़रूरी शर्तों को `extra_action` कमांड चलाने से पहले बनाया गया हो. इन्हें `exec`कॉन्फ़िगरेशन का इस्तेमाल करके बनाया जाता है. ऐसा इसलिए, क्योंकि बिल्ड के दौरान इन्हें एक टूल के तौर पर चलाना ज़रूरी है. किसी व्यक्तिगत `tools` टारगेट `//x:y` का पाथ, `$(location //x:y)` का इस्तेमाल करके हासिल किया जा सकता है. सभी टूल और उनकी डेटा डिपेंडेंसी एक ही ट्री में एक साथ रखी जाती हैं. इसमें कमांड, मिलते-जुलते पाथ का इस्तेमाल कर सकती है. काम करने वाली डायरेक्ट्री, उस यूनिफ़ाइड ट्री का रूट होगी.