Java_सामान्य

अभी तक किसी भी व्यक्ति ने चेक इन नहीं किया है Starlark में Java कम्पाइलेशन सपोर्ट करने के लिए सुविधाएं.

सदस्य

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, host_javabase=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 ज़रूरी है
नियम का संदर्भ.
source_jars sequence of Files; डिफ़ॉल्ट = []
जार की ऐसी सूची जिसे कंपाइल किया जाना है. source_ Jars या source_files में से कम से कम एक तय करना चाहिए.
source_files sequence of Files; डिफ़ॉल्ट = []
कंपाइल की जाने वाली Java सोर्स फ़ाइलों की सूची. source_ Jars या source_files में से कम से कम एक तय करना चाहिए.
output ज़रूरी है
output_source_jar File; or None; डिफ़ॉल्ट = कोई नहीं
आउटपुट सोर्स जार. ज़रूरी नहीं. अगर यह नीति सेट नहीं है, तो डिफ़ॉल्ट रूप से `{आउटपुट_जर}-src.jar` को सेट करती है.
javac_opts sequence of strings; डिफ़ॉल्ट = []
मनचाहे javac विकल्पों की सूची. ज़रूरी नहीं.
deps sequence of JavaInfos; डिफ़ॉल्ट = []
डिपेंडेंसी की सूची. ज़रूरी नहीं.
runtime_deps sequence of JavaInfos; डिफ़ॉल्ट = []
रनटाइम डिपेंडेंसी की सूची. ज़रूरी नहीं.
exports sequence of JavaInfos; डिफ़ॉल्ट = []
एक्सपोर्ट किए गए डेटा की सूची. ज़रूरी नहीं.
plugins sequence of JavaPluginInfos; or sequence of JavaInfos; डिफ़ॉल्ट = []
प्लगिन की सूची. ज़रूरी नहीं.
exported_plugins sequence of JavaPluginInfos; or sequence of JavaInfos; डिफ़ॉल्ट = []
एक्सपोर्ट किए गए प्लगिन की सूची. ज़रूरी नहीं.
native_libraries sequence of CcInfos; डिफ़ॉल्ट = []
इस लाइब्रेरी के लिए ज़रूरी CC नेटिव लाइब्रेरी डिपेंडेंसी.
annotation_processor_additional_inputs sequence of Files; डिफ़ॉल्ट = []
ऐसे इनपुट की सूची जिसे एनोटेशन प्रोसेसिंग के लिए, Java सोर्स के अलावा, कंपाइलेशन की कार्रवाई की जाएगी.
annotation_processor_additional_outputs sequence of Files; डिफ़ॉल्ट = []
आउटपुट की एक सूची, जिसे एनोटेशन प्रोसेसिंग से क्लास जार के साथ-साथ, Java कंपाइलेशन ऐक्शन आउटपुट करेगा.
strict_deps डिफ़ॉल्ट = 'गड़बड़ी'
इस स्ट्रिंग से तय होता है कि सख्त डिप को कैसे मैनेज किया जाए. संभावित वैल्यू: 'OFF', 'ERROR', 'WARN' और 'DEFAULT'. ज़्यादा जानकारी के लिए, /docs/user-manual#flag--strict_java_deps देखें. डिफ़ॉल्ट रूप से 'ERROR'.
java_toolchain ज़रूरी है
इस कंपाइलेशन के लिए इस्तेमाल की जाने वाली JavaToolchainInfo. ज़रूरी है.
host_javabase डिफ़ॉल्ट = कोई नहीं
अब काम नहीं करता. इस पैरामीटर के इस्तेमाल पर रोक लगा दी गई है और इसे जल्द ही हटा दिया जाएगा. कृपया इस पर निर्भर न रहें. यह --+incompatible_java_common_parameters के साथ बंद है. इस फ़्लैग का इस्तेमाल करके, पुष्टि करें कि आपका कोड जल्द ही हटाए जाने के साथ काम करता है.
अब काम नहीं करता: इस पैरामीटर को छोड़ा जा सकता है (host_javabase को java_toolchain के साथ दिया गया है)
sourcepath sequence of Files; डिफ़ॉल्ट = []
resources sequence of Files; डिफ़ॉल्ट = []
resource_jars sequence of Files; डिफ़ॉल्ट = []
classpath_resources sequence of Files; डिफ़ॉल्ट = []
डिफ़ॉल्ट = गलत
enable_annotation_processing डिफ़ॉल्ट = सही
इस कंपाइलेशन में एनोटेशन प्रोसेस करने की सुविधा बंद हो जाती है. इससे, प्लगिन में या deps के export_plugins में दिए गए किसी भी एनोटेशन प्रोसेसर को अनदेखा कर दिया जाता है.
enable_compile_jar_action डिफ़ॉल्ट = सही
हेडर कंपाइलेशन या iJर बनाना चालू करता है. अगर इस नीति को 'गलत है' पर सेट किया जाता है, तो किसी भी डिपेंडेंट के कंपाइलेशन क्लासपाथ में जार का इस्तेमाल किया जा सकता है. ऐसा करना, उन टारगेट के लिए है जो लाइब्रेरी में नहीं हैं. जैसे, बाइनरी. इनमें डिपेंडेंट नहीं होते.
add_exports sequence of strings; डिफ़ॉल्ट = []
इस लाइब्रेरी को दिए गए /तक पहुँचने की अनुमति दें. ज़रूरी नहीं.
add_opens sequence of strings; डिफ़ॉल्ट = []
इस लाइब्रेरी को दिए गए /के हिसाब से ऐक्सेस करने की अनुमति दें. ज़रूरी नहीं.

JavaPluginInfo

Provider java_common.JavaPluginInfo

कंपनी को वापस लाने के लिए इस्तेमाल की जाने वाली कुंजी, जिसमें Java प्लगिन के बारे में जानकारी होती है. इस वैल्यू को JavaPluginInfo के तौर पर भी ऐक्सेस किया जा सकता है.
नए कोड में JavaPluginInfo का इस्तेमाल करना पसंद है.

JavaRuntimeInfo

Provider java_common.JavaRuntimeInfo

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

JavaToolchainInfo

Provider java_common.JavaToolchainInfo

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

make_non_strict

JavaInfo java_common.make_non_strict(java_info)

यह विकल्प Java की सेवा देने वाली नई कंपनी की जानकारी देता है, जिसका डायरेक्ट-जार हिस्सा, दिए गए Java प्रोवाइडर के डायरेक्ट और इनडायरेक्ट जार का कॉम्बिनेशन होता है.

पैरामीटर

पैरामीटर ब्यौरा
java_info ज़रूरी है
Java की जानकारी.

मर्ज करें

JavaInfo java_common.merge(providers, *, merge_java_outputs=True, merge_source_jars=True)

यह दिए गए प्रोवाइडर को एक JavaInfo में मर्ज करता है.

पैरामीटर

पैरामीटर ब्यौरा
providers sequence of JavaInfos; ज़रूरी है
मर्ज करने के लिए कंपनियों की सूची.
merge_java_outputs डिफ़ॉल्ट = सही
merge_source_jars डिफ़ॉल्ट = सही

pack_sources

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

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

JavaInfo#source_jar

. कम से कम एक पैरामीटर का होना ज़रूरी है. इसके लिए, window_ज़ार या आउटपुट_source_jar का एक से ज़्यादा पैरामीटर होना ज़रूरी है.

पैरामीटर

पैरामीटर ब्यौरा
actions ज़रूरी है
ctx.actions
output_jar File; or None; डिफ़ॉल्ट = कोई नहीं
अब काम नहीं करता. इस पैरामीटर के इस्तेमाल पर रोक लगा दी गई है और इसे जल्द ही हटा दिया जाएगा. कृपया इस पर निर्भर न रहें. यह --+incompatible_java_common_parameters के साथ बंद है. इस फ़्लैग का इस्तेमाल करके, पुष्टि करें कि आपका कोड जल्द ही हटाए जाने के साथ काम करता है.
अब काम नहीं करता: नियम का आउटपुट जार. इसका इस्तेमाल, मिलने वाले सोर्स जार को नाम देने के लिए किया जाता है. पैरामीटर,Output_source_jar पैरामीटर को `{आउटपुट_जेर}-src.जारीर` पर सेट करता है.इसके बजाय, सीधे window_source_jar पैरामीटर का इस्तेमाल करें.
output_source_jar File; or None; डिफ़ॉल्ट = कोई नहीं
आउटपुट सोर्स जार.
sources sequence of Files; डिफ़ॉल्ट = []
सोर्स जार में पैक की जाने वाली Java सोर्स फ़ाइलों की सूची.
source_jars sequence of Files; डिफ़ॉल्ट = []
सोर्स जार में पैक किए जाने वाले सोर्स जार की सूची.
java_toolchain ज़रूरी है
iJर टूल ढूंढने के लिए इस्तेमाल की जाने वाली JavaToolchainInfo
host_javabase डिफ़ॉल्ट = कोई नहीं
अब काम नहीं करता. इस पैरामीटर के इस्तेमाल पर रोक लगा दी गई है और इसे जल्द ही हटा दिया जाएगा. कृपया इस पर निर्भर न रहें. यह --+incompatible_java_common_parameters के साथ बंद है. इस फ़्लैग का इस्तेमाल करके, पुष्टि करें कि आपका कोड जल्द ही हटाए जाने के साथ काम करता है.
अब काम नहीं करता: इस पैरामीटर को छोड़ा जा सकता है (host_javabase को java_toolchain के साथ दिया गया है)
None को वापस किया जा सकता है.

provider

Provider java_common.provider

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

run_ijar

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

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

पैरामीटर

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

stamp_jar

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

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

पैरामीटर

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

to_java_binary_info

JavaInfo java_common.to_java_binary_info(java_info)

यह फ़ंक्शन, java_binary के ज़रिए दी गई कम से कम जानकारी के साथ दी गई JavaInfo की एक कॉपी दिखाता है अभी तक किसी भी व्यक्ति ने चेक इन नहीं किया है

पैरामीटर

पैरामीटर ब्यौरा
java_info ज़रूरी है
बेहतर बनाने के लिए JavaInfo.