Java_सामान्य

Starlark में Java कंपाइलेशन की सुविधा के लिए यूटिलिटी.

सदस्य

• BootClassPathInfo
• compile
• JavaRuntimeInfo
• JavaToolchainInfo
• merge
• pack_sources
• run_ijar
• stamp_jar

BootClassPathInfo

Provider java_common.BootClassPathInfo

बूटक्लाथपाथ की जानकारी देने वाली कंपनी

कंपाइल करें

JavaInfo java_common.compile(ctx, *, source_jars=[], source_files=[], output, output_source_jar=None, javac_opts=[], deps=[], runtime_deps=[], exports=[], plugins=[], exported_plugins=[], native_libraries=[], annotation_processor_additional_inputs=[], annotation_processor_additional_outputs=[], strict_deps='ERROR', java_toolchain, bootclasspath=None, sourcepath=[], resources=[], resource_jars=[], classpath_resources=[], neverlink=False, enable_annotation_processing=True, enable_compile_jar_action=True, add_exports=[], add_opens=[])

यह फ़ंक्शन, Starlark नियम को लागू करने से मिली Java सोर्स फ़ाइलों/जार को कंपाइल करता है. साथ ही, एक ऐसा प्रोवाइडर दिखाता है जो कंपाइलेशन के नतीजों को दिखाता है. इसे इस नियम से जनरेट किए गए प्रोवाइडर के सेट में जोड़ा जा सकता है.

पैरामीटर

पैरामीटर	ब्यौरा
ctx	ctx; ज़रूरी है नियम का कॉन्टेक्स्ट.
source_jars	sequence of Files; डिफ़ॉल्ट रूप से [] होता है यह कंपाइल किए जाने वाले जार की सूची होती है. source_jars या source_files में से कम से कम एक के बारे में बताना ज़रूरी है.
source_files	sequence of Files; डिफ़ॉल्ट रूप से [] होता है यह कंपाइल की जाने वाली Java सोर्स फ़ाइलों की सूची होती है. source_jars या source_files में से कम से कम एक के बारे में बताना ज़रूरी है.
output	फ़ाइल; ज़रूरी है
output_source_jar	File; या None; डिफ़ॉल्ट वैल्यू None है आउटपुट सोर्स जार. अगर इसे सेट नहीं किया गया है, तो डिफ़ॉल्ट रूप से इसकी वैल्यू `{output_jar}-src.jar` होती है.
javac_opts	स्ट्रिंग का क्रम; डिफ़ॉल्ट रूप से [] होता है यह javac के उन विकल्पों की सूची होती है जिनकी ज़रूरत होती है.
deps	JavaInfo का sequence; डिफ़ॉल्ट वैल्यू [] है डिपेंडेंसी की सूची.
runtime_deps	JavaInfo का sequence; डिफ़ॉल्ट रूप से [] होता है यह रनटाइम डिपेंडेंसी की सूची होती है.
exports	JavaInfo का sequence; डिफ़ॉल्ट रूप से [] होता है एक्सपोर्ट की सूची.
plugins	sequence of JavaPluginInfos; or sequence of JavaInfos; डिफ़ॉल्ट रूप से [] होता है यह प्लगिन की सूची होती है.
exported_plugins	sequence of JavaPluginInfos; या sequence of JavaInfos; डिफ़ॉल्ट रूप से [] होता है एक्सपोर्ट किए गए प्लगिन की सूची.
native_libraries	sequence of CcInfos; default is [] CC की नेटिव लाइब्रेरी की ऐसी डिपेंडेंसी जो इस लाइब्रेरी के लिए ज़रूरी हैं.
annotation_processor_additional_inputs	sequence of Files; डिफ़ॉल्ट रूप से [] होता है यह उन इनपुट की सूची है जिन्हें Java कंपाइलेशन ऐक्शन, एनोटेशन प्रोसेसिंग के लिए Java सोर्स के अलावा लेगा.
annotation_processor_additional_outputs	sequence of Files; डिफ़ॉल्ट रूप से [] होता है यह उन आउटपुट की सूची है जिन्हें Java कंपाइलेशन ऐक्शन, एनोटेशन प्रोसेसिंग से क्लास जार के अलावा आउटपुट करेगा.
strict_deps	string; डिफ़ॉल्ट वैल्यू 'ERROR' है यह स्ट्रिंग बताती है कि स्ट्रिक्ट डिपेंडेंसी को कैसे मैनेज करना है. संभावित वैल्यू: 'OFF', 'ERROR', 'WARN', और 'DEFAULT'. ज़्यादा जानकारी के लिए, --strict_java_deps flag. By default 'ERROR'. देखें
java_toolchain	जानकारी; ज़रूरी है इस कंपाइलेशन के लिए इस्तेमाल की जाने वाली JavaToolchainInfo. ज़रूरी है.
bootclasspath	डिफ़ॉल्ट वैल्यू None है यह BootClassPathInfo, इस कंपाइलेशन के लिए इस्तेमाल किया जाएगा. यह विकल्प मौजूद होने पर, java_toolchain से जुड़े bootclasspath को बदल देता है.
sourcepath	File का sequence; डिफ़ॉल्ट वैल्यू [] है
resources	File का sequence; डिफ़ॉल्ट वैल्यू [] है
resource_jars	File का sequence; डिफ़ॉल्ट वैल्यू [] है
classpath_resources	File का sequence; डिफ़ॉल्ट वैल्यू [] है
neverlink	bool; डिफ़ॉल्ट वैल्यू False है
enable_annotation_processing	bool; डिफ़ॉल्ट रूप से True होता है इस कंपाइलेशन में एनोटेशन प्रोसेसिंग को बंद करता है. इससे प्लगिन या deps के exported_plugins में दिए गए किसी भी एनोटेशन प्रोसेसर को अनदेखा किया जाता है.
enable_compile_jar_action	bool; डिफ़ॉल्ट वैल्यू True है यह हेडर कंपाइलेशन या ijar क्रिएशन को चालू करता है. अगर इसे 'गलत है' पर सेट किया जाता है, तो यह डिपेंडेंट क्लास के कंपाइलेशन क्लासपाथ में पूरे क्लास जार का इस्तेमाल करने के लिए मजबूर करता है. ऐसा उन टारगेट के लिए किया जाता है जो लाइब्रेरी नहीं हैं. जैसे, ऐसे बाइनरी फ़ाइलें जिनमें डिपेंडेंट नहीं होते हैं.
add_exports	स्ट्रिंग का sequence; डिफ़ॉल्ट वैल्यू [] है इस लाइब्रेरी को दिए गए /का ऐक्सेस दें.
add_opens	स्ट्रिंग का क्रम; डिफ़ॉल्ट वैल्यू [] है इस लाइब्रेरी को, दिए गए /को रिफ़्लेक्टिव तरीके से ऐक्सेस करने की अनुमति दें.

JavaRuntimeInfo

Provider java_common.JavaRuntimeInfo

इस कुंजी का इस्तेमाल, उस प्रोवाइडर को वापस पाने के लिए किया जाता है जिसमें इस्तेमाल किए जा रहे Java रनटाइम के बारे में जानकारी होती है.

JavaToolchainInfo

Provider java_common.JavaToolchainInfo

इस कुंजी का इस्तेमाल, उस प्रोवाइडर को वापस पाने के लिए किया जाता है जिसमें इस्तेमाल की जा रही Java टूलचेन के बारे में जानकारी होती है.

मर्ज करें

JavaInfo java_common.merge(providers)

यह फ़ंक्शन, दी गई कंपनियों को एक JavaInfo में मर्ज करता है.

पैरामीटर

पैरामीटर	ब्यौरा
providers	sequence of JavaInfos; ज़रूरी है मर्ज करने के लिए, सेवा देने वाली कंपनियों की सूची.

pack_sources

File java_common.pack_sources(actions, *, output_source_jar=None, sources=[], source_jars=[], java_toolchain)

यह सोर्स और सोर्स जार को एक ही सोर्स जार फ़ाइल में पैक करता है. आम तौर पर, रिटर्न वैल्यू को

JavaInfo#source_jar

.output_jar या output_source_jar में से कम से कम एक पैरामीटर का होना ज़रूरी है.

पैरामीटर

पैरामीटर	ब्यौरा
actions	actions; required ctx.actions
output_source_jar	File; या None; डिफ़ॉल्ट वैल्यू None है आउटपुट सोर्स जार.
sources	sequence of Files; डिफ़ॉल्ट रूप से [] होता है यह Java की उन सोर्स फ़ाइलों की सूची होती है जिन्हें सोर्स जार में पैक किया जाना है.
source_jars	sequence of Files; डिफ़ॉल्ट तौर पर [] होता है यह, सोर्स जार में पैक किए जाने वाले सोर्स जार की सूची होती है.
java_toolchain	Info; required A JavaToolchainInfo to used to find the ijar tool.

run_ijar

File java_common.run_ijar(actions, *, jar, target_label=None, java_toolchain)

यह jar पर ijar चलाता है और उसके मेथड बॉडी को हटा देता है. इससे, किसी भी रीकंपाइल के दौरान, डिपेंडेंट जार को फिर से बनाने की ज़रूरत नहीं पड़ती. रीकंपाइल में, सिर्फ़ तरीके लागू करने से जुड़े सामान्य बदलाव शामिल होते हैं. आम तौर पर, रिटर्न वैल्यू को JavaInfo#compile_jar में पास किया जाता है.

पैरामीटर

पैरामीटर	ब्यौरा
actions	actions; required ctx.actions
jar	File; ज़रूरी है यह वह जार फ़ाइल है जिस पर ijar को चलाना है.
target_label	Label या None; डिफ़ॉल्ट वैल्यू None है जार पर स्टैंप लगाने के लिए टारगेट लेबल. इस कुकी का इस्तेमाल add_dep सहायता के लिए किया जाता है. आम तौर पर, जार पर मौजूदा नियम का लेबल लगाने के लिए, ctx.label को पास किया जाता है.
java_toolchain	Info; required A JavaToolchainInfo to used to find the ijar tool.

stamp_jar

File java_common.stamp_jar(actions, *, jar, target_label, java_toolchain)

यह कुकी, add_dep सहायता के लिए जार को टारगेट लेबल के साथ स्टैंप करती है. आम तौर पर, रिटर्न वैल्यू को JavaInfo#compile_jar में पास किया जाता है. जब भी हो सके, run_ijar का इस्तेमाल करें.

पैरामीटर

पैरामीटर	ब्यौरा
actions	actions; required ctx.actions
jar	File; ज़रूरी है यह वह जार फ़ाइल है जिस पर stamp_jar को चलाया जाना है.
target_label	लेबल; ज़रूरी है जार पर स्टैंप लगाने के लिए टारगेट लेबल. इस कुकी का इस्तेमाल add_dep सहायता के लिए किया जाता है. आम तौर पर, जार पर मौजूदा नियम का लेबल लगाने के लिए, ctx.label को पास किया जाता है.
java_toolchain	जानकारी; ज़रूरी है stamp_jar टूल ढूंढने के लिए, JavaToolchainInfo का इस्तेमाल किया जाता है.