Java_सामान्य

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

सदस्य

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

BootClassPathInfo

Provider java_common.BootClassPathInfo

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

कंपाइल करें

struct 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	struct का sequence; डिफ़ॉल्ट रूप से [] होता है यह डिपेंडेंसी की सूची होती है.
runtime_deps	sequence of structs; डिफ़ॉल्ट रूप से [] होता है यह रनटाइम डिपेंडेंसी की सूची होती है.
exports	struct का sequence; डिफ़ॉल्ट रूप से [] होता है एक्सपोर्ट की सूची.
plugins	sequence of structs; या sequence of structs; डिफ़ॉल्ट रूप से [] होता है यह प्लगिन की सूची होती है.
exported_plugins	sequence of structs; या sequence of structs; डिफ़ॉल्ट रूप से [] होता है एक्सपोर्ट किए गए प्लगिन की सूची.
native_libraries	sequence of CcInfos; डिफ़ॉल्ट रूप से [] होता है सीसी नेटिव लाइब्रेरी की डिपेंडेंसी, जो इस लाइब्रेरी के लिए ज़रूरी हैं.
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	Files का sequence; डिफ़ॉल्ट तौर पर [] होता है
resources	Files का sequence; डिफ़ॉल्ट तौर पर [] होता है
resource_jars	Files का sequence; डिफ़ॉल्ट तौर पर [] होता है
classpath_resources	Files का sequence; डिफ़ॉल्ट तौर पर [] होता है
neverlink	bool; डिफ़ॉल्ट रूप से False होता है
enable_annotation_processing	bool; डिफ़ॉल्ट रूप से True होता है इस कंपाइलेशन में एनोटेशन प्रोसेसिंग को बंद करता है. इससे प्लगिन या deps के exported_plugins में दिए गए किसी भी एनोटेशन प्रोसेसर को अनदेखा किया जाता है.
enable_compile_jar_action	bool; डिफ़ॉल्ट रूप से True होता है इससे हेडर कंपाइलेशन या ijar क्रिएशन चालू होता है. अगर इसे 'गलत है' पर सेट किया जाता है, तो यह किसी भी डिपेंडेंट के कंपाइलेशन क्लासपाथ में पूरे क्लास जार का इस्तेमाल करने के लिए मजबूर करता है. ऐसा उन टारगेट के लिए किया जाता है जो लाइब्रेरी नहीं हैं. जैसे, ऐसे बाइनरी फ़ाइलें जिनके कोई आश्रित नहीं हैं.
add_exports	स्ट्रिंग का क्रम; डिफ़ॉल्ट रूप से [] होता है इस लाइब्रेरी को दिए गए / को ऐक्सेस करने की अनुमति दें
add_opens	स्ट्रिंग का क्रम; डिफ़ॉल्ट रूप से [] होता है इस लाइब्रेरी को, दिए गए /को रिफ़्लेक्टिव तरीके से ऐक्सेस करने की अनुमति दें.

JavaRuntimeInfo

Provider java_common.JavaRuntimeInfo

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

JavaToolchainInfo

Provider java_common.JavaToolchainInfo

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

मर्ज करें

struct java_common.merge(providers)

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

पैरामीटर

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

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	जानकारी; ज़रूरी है ijar टूल ढूंढने के लिए, JavaToolchainInfo का इस्तेमाल किया जाता है.

run_ijar

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

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

पैरामीटर

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

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.