Android के नियम

अभी तक किसी भी व्यक्ति ने चेक इन नहीं किया है किसी समस्या की रिपोर्ट करें सोर्स देखें नाइटली · 7.3 · 7.2 · 7.1 · 7.0 · 6.5

नियम

android_binary

नियम का सोर्स देखें
android_binary(name, deps, srcs, assets, assets_dir, compatible_with, crunch_png, custom_package, debug_key, debug_signing_keys, debug_signing_lineage_file, densities, deprecation, dex_shards, dexopts, distribs, enable_data_binding, exec_compatible_with, exec_properties, features, incremental_dexing, instruments, javacopts, key_rotation_min_sdk, licenses, main_dex_list, main_dex_list_opts, main_dex_proguard_specs, manifest, manifest_values, multidex, nocompress_extensions, package_id, plugins, proguard_apply_dictionary, proguard_apply_mapping, proguard_generate_mapping, proguard_specs, resource_configuration_filters, resource_files, restricted_to, shrink_resources, tags, target_compatible_with, testonly, visibility)

Android ऐप्लिकेशन पैकेज फ़ाइलें (.apk) बनाती है.

इंप्लिसिट आउटपुट टारगेट

  • name.apk: Android ऐप्लिकेशन पैकेज फ़ाइल को डीबग कुंजियों के साथ साइन किया गया है और zipaligned हैं, तो इसका इस्तेमाल आपके ऐप्लिकेशन को डेवलप करने और डीबग करने के लिए किया जा सकता है. डीबग कुंजियों से साइन इन होने पर, ऐप्लिकेशन को रिलीज़ नहीं किया जा सकता.
  • name_unsigned.apk: जिसे रिलीज़ करने से पहले रिलीज़ कुंजियों से हस्ताक्षर किया जा सकता है सार्वजनिक.
  • name_deploy.jar: एक Java संग्रह जिसमें इस टारगेट का अस्थायी तौर पर बंद होना.

    डिप्लॉय जार में वे सभी क्लास शामिल हैं जो किसी क्लासलोडर जिसने इस टारगेट के रनटाइम क्लासपाथ को खोजा शुरू से आखिर तक.

  • name_proguard.jar: एक Java संग्रह जिसमें शामिल है नतीजे के तौर पर, ProGuard को name_deploy.jar. यह आउटपुट सिर्फ़ तब जनरेट होता है, जब proguard_specs एट्रिब्यूट बताया गया है.
  • name_proguard.map: इसका एक मैपिंग फ़ाइल नतीजा name_deploy.jar पर ProGuard को चला रही हूँ. यह आउटपुट सिर्फ़ तब जनरेट होता है, जब proguard_specs एट्रिब्यूट तय किया गया और proguard_generate_mapping या shrink_resources सेट किया गया है.

उदाहरण

Android के नियमों के उदाहरण, यहां दी गई examples/android डायरेक्ट्री में मिल सकते हैं: बेज़ल सोर्स ट्री.

तर्क

विशेषताएं
name

नाम; आवश्यक

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

deps

लेबल की सूची; डिफ़ॉल्ट रूप से [] है

बाइनरी टारगेट से लिंक की जाने वाली अन्य लाइब्रेरी की सूची. इस तरह की लाइब्रेरी इस्तेमाल की जा सकती हैं: android_library, android कंस्ट्रेंट और java_library के साथ cc_library के लिए .so नेटिव लाइब्रेरी को रैप करना या बनाना Android टारगेट प्लैटफ़ॉर्म.
srcs

लेबल की सूची; डिफ़ॉल्ट रूप से [] है

टारगेट बनाने के लिए प्रोसेस की जाने वाली सोर्स फ़ाइलों की सूची.

.java टाइप की srcs फ़ाइलें कंपाइल की गई हैं. सिर्फ़ समझने के लिए, किसी साइट का नाम srcs में .java सोर्स फ़ाइल जनरेट की गई. इसके बजाय, srcs में डिपेंडेंट-ऑन नियम का नाम इस तरह रखें जिनकी जानकारी नीचे दी गई है.

.srcjar टाइप की srcs फ़ाइलें पैक नहीं की गई हैं और कंपाइल किया गया. (यह तब काम आता है, जब आपको .java फ़ाइलों का सेट जनरेट करने की ज़रूरत हो सामान्य या बिल्ड एक्सटेंशन शामिल करें.)

assets

लेबल की सूची; डिफ़ॉल्ट रूप से [] है

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

String; "" डिफ़ॉल्ट है

assets में फ़ाइलों का पाथ देने वाली स्ट्रिंग. assets और assets_dir, पैकेज के बारे में बताते हैं ऐसेट और दोनों में से कोई एक एट्रिब्यूट दिया जाना चाहिए या फिर कोई भी नहीं दिया जाना चाहिए.
crunch_png

बूलियन; True डिफ़ॉल्ट है

PNG फ़ॉर्मैट में क्रंच करें या न करें. यह नौ पैच प्रोसेसिंग से अलग है, जो हमेशा हो गया. यह समाधान aapt Bug ने aapt2 में ठीक किया गया है.
custom_package

String; "" डिफ़ॉल्ट है

Java पैकेज, जिसके लिए java सोर्स जनरेट किए जाएंगे. डिफ़ॉल्ट रूप से, पैकेज का अनुमान उस डायरेक्ट्री से लगाया जाता है जहां BUILD फ़ाइल होती है जिसमें नियम शामिल है. कोई दूसरा पैकेज तय किया जा सकता है, लेकिन यह है बहुत ज़्यादा नहीं होता है, क्योंकि इसकी वजह से क्लासपाथ के विरोधाभास हो सकते हैं लाइब्रेरी जिनका पता सिर्फ़ रनटाइम के दौरान लगाया जा सकेगा.
debug_key

लेबल; डिफ़ॉल्ट रूप से "@bazel_tools//tools/android:debug_keystore" है

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

चेतावनी: अपनी प्रोडक्शन कुंजियों का इस्तेमाल न करें, उन्हें ऐसा करना चाहिए सख्ती से सुरक्षित रखा जाता है और उसे आपके सोर्स ट्री में नहीं रखा जाता.

debug_signing_keys

लेबल की सूची; डिफ़ॉल्ट रूप से [] है

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

चेतावनी: अपनी प्रोडक्शन कुंजियों का इस्तेमाल न करें, उन्हें ऐसा करना चाहिए सख्ती से सुरक्षित रखा जाता है और उसे आपके सोर्स ट्री में नहीं रखा जाता.

debug_signing_lineage_file

लेबल; डिफ़ॉल्ट रूप से None है

इस फ़ाइल मेंdebug_sign_keys के लिए साइनिंग लीनिएज है. आम तौर पर, आप ऐसा नहीं करते डिफ़ॉल्ट कुंजी के अलावा अन्य कुंजियों का इस्तेमाल करना चाहते हैं, इसलिए इस विशेषता को छोड़ देना चाहिए.

चेतावनी: अपनी प्रोडक्शन कुंजियों का इस्तेमाल न करें, उन्हें ऐसा करना चाहिए सख्ती से सुरक्षित रखा जाता है और उसे आपके सोर्स ट्री में नहीं रखा जाता.

densities

स्ट्रिंग की सूची; [] डिफ़ॉल्ट है

APK बनाते समय, फ़िल्टर करने के लिए डेंसिटी. इससे रास्टर ड्रॉ करने वाले संसाधन हट जाएंगे, जो कि APK का साइज़ कम करने के लिए, बताई गई स्क्रीन डेंसिटी का इस्तेमाल करें. स्क्रीन के साथ काम करने वाली स्क्रीन अगर इसमें पहले से कोई सुपरसेट नहीं है, तो मेनिफ़ेस्ट में सेक्शन भी जोड़ा जाएगा लिस्टिंग.
dex_shards

पूर्णांक; 1 डिफ़ॉल्ट है

शार्ड डीक्सिंग की संख्या को कम करना चाहिए. इससे डेक्सिंग की प्रोसेस बहुत तेज़ी से होती है. इसमें ऐप्लिकेशन इंस्टॉल होने और शुरू होने में लगने वाला समय बहुत ज़्यादा खर्च होता है. कॉन्टेंट बनाने बाइनरी जितनी बड़ी होगी, उतने ज़्यादा शार्ड का इस्तेमाल किया जाना चाहिए. शुरुआत करने के लिए 25 एक अच्छा मान है नए वीडियो बनाते रहें.

ध्यान दें कि फ़ाइनल ऐप्लिकेशन में हर शार्ड से कम से कम एक डेक्स मिलता है. इस वजह से, रिलीज़ बाइनरी के लिए, इसे 1 से ज़्यादा पर सेट करने का सुझाव नहीं दिया जाता.

dexopts

स्ट्रिंग की सूची; [] डिफ़ॉल्ट है

class.dex जनरेट करते समय, dx टूल के लिए अतिरिक्त कमांड-लाइन फ़्लैग. "वैरिएबल बनाएं" के विकल्प पर निर्भर करता है और बोर्न शेल टोकनाइज़ेशन.
enable_data_binding

बूलियन; False डिफ़ॉल्ट है

अगर सही है, तो इस नियम को प्रोसेस किया जाता है डेटा बाइंडिंग एक्सप्रेशन के ज़रिए शामिल किए गए लेआउट रिसॉर्स में resource_files एट्रिब्यूट. इसके बिना सेटिंग के हिसाब से, डेटा बाइंडिंग एक्सप्रेशन से बिल्ड फ़ेल हो जाता है.

डेटा बाइंडिंग वाला Android ऐप्लिकेशन बनाने के लिए, आपको ये काम भी करने होंगे:

  1. इस एट्रिब्यूट को, Android के उन सभी नियमों के लिए सेट करें जो इस पर निर्भर करते हैं. ऐसा इसलिए होता है, क्योंकि डिपेंडेंट, रिसॉर्स के ज़रिए नियम के डेटा बाइंडिंग एक्सप्रेशन को इनहेरिट करते हैं मर्ज करना. इसलिए, उन एक्सप्रेशन को पार्स करने के लिए, उन्हें डेटा बाइंडिंग के साथ भी बनाना होगा.
  2. डेटा बाइंडिंग रनटाइम लाइब्रेरी के सभी टारगेट के लिए, deps = एंट्री जोड़ें जो इस एट्रिब्यूट को सेट करते हैं. इस लाइब्रेरी की जगह, आपके डिपो के सेट अप के हिसाब से तय होती है.
incremental_dexing

पूर्णांक; कॉन्फ़िगर नहीं किया जा सकता; डिफ़ॉल्ट रूप से -1 है

डिफ़ॉल्ट को ओवरराइड करते हुए, इंक्रीमेंटल डेक्सिंग या बिना इंक्रीमेंटल डेक्सिंग के बनाए जाने वाले टारगेट को ज़बरदस्ती बनाएं और --incremental_dexing फ़्लैग का इस्तेमाल कर सकते हैं.
instruments

लेबल; डिफ़ॉल्ट रूप से None है

इंस्ट्रुमेंट पर android_binary का टारगेट.

अगर इस एट्रिब्यूट को सेट किया जाता है, तो इस android_binary को टेस्ट माना जाएगा इंस्ट्रुमेंटेशन टेस्ट के लिए आवेदन. android_instrumentation_test तो लक्ष्य इस लक्ष्य को अपने test_app एट्रिब्यूट.

javacopts

स्ट्रिंग की सूची; [] डिफ़ॉल्ट है

इस टारगेट के लिए, कंपाइलर के ज़्यादा विकल्प. "वैरिएबल बनाएं" के विकल्प पर निर्भर करता है और बोर्न शेल टोकनाइज़ेशन.

ग्लोबल कंपाइलर विकल्पों के बाद, ये कंपाइलर विकल्प javac को पास किए जाते हैं.

key_rotation_min_sdk

String; "" डिफ़ॉल्ट है

यह Android प्लैटफ़ॉर्म का वह कम से कम वर्शन (एपीआई लेवल) सेट करता है जिसके लिए APK को घुमाया गया हो कुंजी का इस्तेमाल APK का हस्ताक्षर बनाने के लिए किया जाना चाहिए. APK के लिए ओरिजनल साइनिंग पासकोड का इस्तेमाल प्लैटफ़ॉर्म के पिछले सभी वर्शन के लिए किया जाएगा.
main_dex_list

लेबल; डिफ़ॉल्ट रूप से None है

टेक्स्ट फ़ाइल में क्लास फ़ाइल के नामों की सूची शामिल है. उन क्लास फ़ाइलों से तय की गई क्लास प्राइमरी क्लास.dex. e.g.:
          android/support/multidex/MultiDex$V19.class
          android/support/multidex/MultiDex.class
          android/support/multidex/MultiDexApplication.class
          com/google/common/base/Objects.class
                    
multidex="manual_main_dex" के साथ इस्तेमाल करना चाहिए.
main_dex_list_opts

स्ट्रिंग की सूची; [] डिफ़ॉल्ट है

मुख्य डेक्स लिस्ट बिल्डर पर जाने के लिए, कमांड लाइन के विकल्प. इस विकल्प का इस्तेमाल करके, मुख्य डेक्स सूची में शामिल क्लास पर असर डालें.
main_dex_proguard_specs

लेबल की सूची; डिफ़ॉल्ट रूप से [] है

ProGuard स्पेसिफ़िकेशन के तौर पर इस्तेमाल की जाने वाली फ़ाइलें. इससे यह तय किया जा सकता है कि किन क्लास में रखा जाना चाहिए मुख्य dex. इसे सिर्फ़ तब इस्तेमाल किया जा सकता है, जब multidex एट्रिब्यूट को legacy पर सेट किया गया हो.
manifest

लेबल; आवश्यक

Android मेनिफ़ेस्ट फ़ाइल का नाम, आम तौर पर AndroidManifest.xml. अगरResource_files या ऐसेट के बारे में बताया गया है, तो यह तय करना ज़रूरी है.
manifest_values

शब्दकोश: स्ट्रिंग -> String; {} डिफ़ॉल्ट है

मेनिफ़ेस्ट में बदली जाने वाली वैल्यू की डिक्शनरी.

मेनिफ़ेस्ट में ${name} के किसी भी इंस्टेंस को मान से बदल दिया जाएगा इस शब्दकोश में मौजूद नाम से संबंधित है.

applicationId, versionCode, versionName, minSdkVersion, targetSdkVersion, और maxSdkVersion, मेनिफ़ेस्ट में इससे जुड़े एट्रिब्यूट को भी बदल देगा और uses-sdk टैग.

packageName को अनदेखा कर दिया जाएगा और इसे इनमें से किसी एक पर सेट किया जाएगा अगर बताया गया हो, तो applicationId या मेनिफ़ेस्ट में पैकेज.

जब manifest_merger को legacy पर सेट किया जाता है, तो सिर्फ़ applicationId, versionCode, और versionName करते हैं.

multidex

String; "native" डिफ़ॉल्ट है

क्या कोड को एक से ज़्यादा dex फ़ाइलों में बांटना है.
अभी तक किसी भी व्यक्ति ने चेक इन नहीं किया है वैल्यू, इनमें से कोई हो सकती है:
  • native: dex 64K इंडेक्स की सीमा होने पर, कोड को कई dex फ़ाइलों में बांटें पार हो गया है. रनटाइम के दौरान मल्टीडेक्स क्लास लोड करने के लिए, नेटिव प्लैटफ़ॉर्म सपोर्ट को मान लेता है. यह सुविधा सिर्फ़ Android L और उसके बाद के वर्शन पर काम करती है.
  • legacy: dex 64K इंडेक्स की सीमा होने पर, कोड को कई dex फ़ाइलों में बांटें पार हो गया है. यह मानकर चलता है कि मल्टीडेक्स क्लास को ऐप्लिकेशन कोड के ज़रिए लोड किया गया है (यानी कि कोई नेटिव प्लैटफ़ॉर्म सहायता).
  • manual_main_dex: dex 64K रिज़ॉल्यूशन में होने पर, कोड को कई dex फ़ाइलों में बांट दें इंडेक्स की सीमा पार हो गई है. मुख्य dex फ़ाइल के कॉन्टेंट की जानकारी टेक्स्ट फ़ाइल में क्लास की सूची उपलब्ध कराकर main_dex_list एट्रिब्यूट का इस्तेमाल करें.
  • off: सभी कोड को एक dex फ़ाइल में कंपाइल करें, भले ही वह इंडेक्स की सीमा.
nocompress_extensions

स्ट्रिंग की सूची; [] डिफ़ॉल्ट है

apk में बिना कंप्रेस किए छोड़ने के लिए फ़ाइल एक्सटेंशन की सूची.
package_id

पूर्णांक; 0 डिफ़ॉल्ट है

इस बाइनरी में मौजूद संसाधनों को असाइन किया जाने वाला पैकेज आईडी.

ज़्यादा जानकारी के लिए, AAPT2 के --package-id आर्ग्युमेंट को देखें. इससे ये काम किए जा सकते हैं (और सेट नहीं किया जाएगा, तो आम तौर पर 127 की डिफ़ॉल्ट वैल्यू मिलती है (0x7F).

plugins

लेबल की सूची; डिफ़ॉल्ट रूप से [] है

कंपाइलर के समय चलाए जाने वाले Java कंपाइलर प्लगिन. इसमें बताई गई हर java_plugin प्लगिन एट्रिब्यूट जब भी इस्तेमाल होगा, इस टारगेट को बनाया जाता है. संसाधन बनाने वाले का नाम प्लगिन को इसके परिणाम जार में शामिल किया जाएगा टारगेट किया जा सकता है.
proguard_apply_dictionary

लेबल; डिफ़ॉल्ट रूप से None है

ProGuard के लिए मैपिंग के रूप में इस्तेमाल की जाने वाली फ़ाइल. लाइन से अलग की गई "शब्दों" वाली फ़ाइल के दौरान क्लास और सदस्यों का नाम बदलते समय अस्पष्ट बनाना.
proguard_apply_mapping

लेबल; डिफ़ॉल्ट रूप से None है

ProGuard के लिए मैपिंग के रूप में इस्तेमाल की जाने वाली फ़ाइल. proguard_generate_mapping ने जो मैपिंग फ़ाइल जनरेट की है उसे नए बिल्ड में वही मैपिंग लागू करने के लिए फिर से इस्तेमाल किया गया है.
proguard_generate_mapping

बूलियन; कॉन्फ़िगर नहीं किया जा सकता; डिफ़ॉल्ट रूप से False है

ProGuard मैपिंग फ़ाइल जनरेट करनी है या नहीं. मैपिंग फ़ाइल सिर्फ़ तब जनरेट होगी, जब proguard_specs बताया गया है. यह फ़ाइल मूल और अस्पष्ट वर्ग, विधि और फ़ील्ड नाम.

चेतावनी: अगर इस एट्रिब्यूट का इस्तेमाल किया जाता है, तो ProGuard स्पेसिफ़िकेशन में न तो -dontobfuscate होना चाहिए और न ही -printmapping.

proguard_specs

लेबल की सूची; डिफ़ॉल्ट रूप से [] है

ProGuard स्पेसिफ़िकेशन के तौर पर इस्तेमाल की जाने वाली फ़ाइलें. यह फ़ाइल, ProGuard के इस्तेमाल किए जाने वाले खास निर्देशों के बारे में जानकारी देगी.
resource_configuration_filters

स्ट्रिंग की सूची; [] डिफ़ॉल्ट है

संसाधन कॉन्फ़िगरेशन फ़िल्टर की सूची, जैसे कि 'en' इससे संसाधनों को सीमित कर दिया जाएगा apk केवल 'en' में मौजूद लोगों को apk कॉन्फ़िगरेशन. pseudolocalization को चालू करने के लिए, शामिल करें en_XA और/या ar_XB pseudo-locales.
resource_files

लेबल की सूची; डिफ़ॉल्ट रूप से [] है

पैकेज किए जाने वाले संसाधनों की सूची. आम तौर पर, यह फ़ाइल के तहत आने वाली सभी फ़ाइलों का glob होता है res डायरेक्ट्री.
अभी तक किसी भी व्यक्ति ने चेक इन नहीं किया है जनरेट की गई फ़ाइलों (genrules से) का रेफ़रंस इनसे लिया जा सकता है यहां भी लेबल करें. पाबंदी सिर्फ़ यह है कि जनरेट किए गए आउटपुट, "res" से कम होने चाहिए डायरेक्ट्री, किसी भी अन्य फ़ॉर्मैट में होनी चाहिए शामिल हैं.
shrink_resources

पूर्णांक; -1 डिफ़ॉल्ट है

क्या संसाधन को छोटा करने की कार्रवाई करनी है. जिन संसाधनों का इस्तेमाल बाइनरी में नहीं किया गया है उन्हें APK से हटा दिया गया है. यह सिर्फ़ स्थानीय संसाधनों (जैसे कि manifest और resource_files एट्रिब्यूट के लिए ज़रूरी है.) के लिए ProGuard की ज़रूरत होती है. यह ज़्यादातर उसी तरीके से काम करता है जैसे Gradle रिसॉर्स श्रिंकर करता है (https://developer.android.com/studio/build/shrink-code.html#shrink-resources).

अहम अंतर:

  • values/ में मौजूद संसाधन हटा दिए जाएंगे. साथ ही, फ़ाइलों के हिसाब से संसाधन
  • डिफ़ॉल्ट रूप से strict mode का इस्तेमाल करता है
  • इस्तेमाल न किए गए आईडी रिसॉर्स को हटाने की सुविधा, सिर्फ़ aapt2 के साथ काम करती है
अगर रिसॉर्स को छोटा करने की सुविधा चालू है, तो name_files/resource_shrinker.log भी जनरेट किया जाएगा, जिसमें किए गए विश्लेषण और मिटाए गए डेटा की जानकारी होगी.

जितनी तरह के साइटमैप हो सकते हैं उनकी जानकारी यहां दी गई है:

  • shrink_resources = 1: Android संसाधन का साइज़ छोटा करने की सुविधा चालू करता है
  • shrink_resources = 0: Android संसाधन का साइज़ छोटा करने की सुविधा बंद करता है
  • shrink_resources = -1: शृंक करने की क्रिया को --android_resource_shinsking फ़्लैग.

aar_import

नियम का सोर्स देखें
aar_import(name, deps, data, aar, compatible_with, deprecation, distribs, exec_compatible_with, exec_properties, exports, features, licenses, restricted_to, srcjar, tags, target_compatible_with, testonly, visibility)

इस नियम के तहत, .aar फ़ाइलों को लाइब्रेरी के तौर पर इस्तेमाल किया जा सकता है android_library और android_binary नियम.

उदाहरण

    aar_import(
        name = "google-vr-sdk",
        aar = "gvr-android-sdk/libraries/sdk-common-1.10.0.aar",
    )

    android_binary(
        name = "app",
        manifest = "AndroidManifest.xml",
        srcs = glob(["**.java"]),
        deps = [":google-vr-sdk"],
    )

तर्क

विशेषताएं
name

नाम; आवश्यक

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

aar

लेबल; आवश्यक

इस टारगेट पर निर्भर Android टारगेट को उपलब्ध कराने के लिए .aar फ़ाइल.
exports

लेबल की सूची; डिफ़ॉल्ट रूप से [] है

इस नियम पर निर्भर नियमों पर एक्सपोर्ट किए जाने वाले टारगेट. java_library.exports.
srcjar

लेबल; डिफ़ॉल्ट रूप से None है

एक JAR फ़ाइल, जिसमें AAR में कंपाइल की गई JAR फ़ाइलों का सोर्स कोड होता है.

android_library

नियम का सोर्स देखें
android_library(name, deps, srcs, data, assets, assets_dir, compatible_with, custom_package, deprecation, distribs, enable_data_binding, exec_compatible_with, exec_properties, exported_plugins, exports, exports_manifest, features, idl_import_root, idl_parcelables, idl_preprocessed, idl_srcs, javacopts, licenses, manifest, neverlink, plugins, proguard_specs, resource_files, restricted_to, tags, target_compatible_with, testonly, visibility)

यह नियम अपने सोर्स को .jar फ़ाइल में कंपाइल और संग्रहित करता है. Android रनटाइम लाइब्रेरी android.jar को इंप्लिसिट रूप से चालू किया गया है कंपाइलेशन क्लास पाथ.

इंप्लिसिट आउटपुट टारगेट

  • libname.jar: एक Java संग्रह.
  • libname-src.jar: एक संग्रह जिसमें सोर्स ("सोर्स जार").
  • name.aar: Android 'aar' JavaScript संग्रह वाला बंडल टारगेट के लिए, और संसाधन शामिल हैं. इसमें ट्रांज़िटिव क्लोज़र शामिल नहीं है.

उदाहरण

Android के नियमों के उदाहरण, यहां दी गई examples/android डायरेक्ट्री में मिल सकते हैं: बेज़ल सोर्स ट्री.

यह उदाहरण दिखाता है idl_import_root को कैसे सेट करते हैं. //java/bazel/helloandroid/BUILD को यह जानकारी शामिल करने दें:

android_library(
    name = "parcelable",
    srcs = ["MyParcelable.java"], # bazel.helloandroid.MyParcelable

    # MyParcelable.aidl will be used as import for other .aidl
    # files that depend on it, but will not be compiled.
    idl_parcelables = ["MyParcelable.aidl"] # bazel.helloandroid.MyParcelable

    # We don't need to specify idl_import_root since the aidl file
    # which declares bazel.helloandroid.MyParcelable
    # is present at java/bazel/helloandroid/MyParcelable.aidl
    # underneath a java root (java/).
)

android_library(
    name = "foreign_parcelable",
    srcs = ["src/android/helloandroid/OtherParcelable.java"], # android.helloandroid.OtherParcelable
    idl_parcelables = [
        "src/android/helloandroid/OtherParcelable.aidl" # android.helloandroid.OtherParcelable
    ],

    # We need to specify idl_import_root because the aidl file which
    # declares android.helloandroid.OtherParcelable is not positioned
    # at android/helloandroid/OtherParcelable.aidl under a normal java root.
    # Setting idl_import_root to "src" in //java/bazel/helloandroid
    # adds java/bazel/helloandroid/src to the list of roots
    # the aidl compiler will search for imported types.
    idl_import_root = "src",
)

# Here, OtherInterface.aidl has an "import android.helloandroid.CallbackInterface;" statement.
android_library(
    name = "foreign_interface",
    idl_srcs = [
        "src/android/helloandroid/OtherInterface.aidl" # android.helloandroid.OtherInterface
        "src/android/helloandroid/CallbackInterface.aidl" # android.helloandroid.CallbackInterface
    ],

    # As above, idl_srcs which are not correctly positioned under a java root
    # must have idl_import_root set. Otherwise, OtherInterface (or any other
    # interface in a library which depends on this one) will not be able
    # to find CallbackInterface when it is imported.
    idl_import_root = "src",
)

# MyParcelable.aidl is imported by MyInterface.aidl, so the generated
# MyInterface.java requires MyParcelable.class at compile time.
# Depending on :parcelable ensures that aidl compilation of MyInterface.aidl
# specifies the correct import roots and can access MyParcelable.aidl, and
# makes MyParcelable.class available to Java compilation of MyInterface.java
# as usual.
android_library(
    name = "idl",
    idl_srcs = ["MyInterface.aidl"],
    deps = [":parcelable"],
)

# Here, ServiceParcelable uses and thus depends on ParcelableService,
# when it's compiled, but ParcelableService also uses ServiceParcelable,
# which creates a circular dependency.
# As a result, these files must be compiled together, in the same android_library.
android_library(
    name = "circular_dependencies",
    srcs = ["ServiceParcelable.java"],
    idl_srcs = ["ParcelableService.aidl"],
    idl_parcelables = ["ServiceParcelable.aidl"],
)

तर्क

विशेषताएं
name

नाम; आवश्यक

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

deps

लेबल की सूची; डिफ़ॉल्ट रूप से [] है

लिंक करने के लिए अन्य लाइब्रेरी की सूची. इस तरह की लाइब्रेरी इस्तेमाल की जा सकती हैं: android_library, android कंस्ट्रेंट और java_library के साथ cc_library में .so नेटिव लाइब्रेरी को रैप करना या बनाना Android टारगेट प्लैटफ़ॉर्म के लिए.
srcs

लेबल की सूची; डिफ़ॉल्ट रूप से [] है

ऐसी .java या .srcjar फ़ाइलों की सूची जिसमें जिन्हें टारगेट बनाने के लिए प्रोसेस किया जाता है.

.java टाइप की srcs फ़ाइलें कंपाइल की गई हैं. सिर्फ़ समझने के लिए, किसी साइट का नाम srcs में .java सोर्स फ़ाइल जनरेट की गई. इसके बजाय, srcs में डिपेंडेंट-ऑन नियम का नाम इस तरह रखें जिनकी जानकारी नीचे दी गई है.

.srcjar टाइप की srcs फ़ाइलें पैक नहीं की गई हैं और कंपाइल किया गया. (यह तब काम आता है, जब आपको .java फ़ाइलों का सेट जनरेट करने की ज़रूरत हो सामान्य या बिल्ड एक्सटेंशन शामिल करें.)

अगर srcs को शामिल नहीं किया जाता है, तो इसमें बताई गई कोई भी डिपेंडेंसी deps को इस नियम से एक्सपोर्ट किया गया है (देखें ज़्यादा जानकारी के लिए, java_library का एक्सपोर्ट डिपेंडेंसी एक्सपोर्ट करने के बारे में जानकारी). हालांकि, यह व्यवहार जल्द ही बंद हो जाएगा; उस पर भरोसा न करें.

assets

लेबल की सूची; डिफ़ॉल्ट रूप से [] है

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

String; "" डिफ़ॉल्ट है

assets में फ़ाइलों का पाथ देने वाली स्ट्रिंग. assets और assets_dir, पैकेज के बारे में बताते हैं ऐसेट और दोनों में से कोई एक एट्रिब्यूट दिया जाना चाहिए या फिर कोई भी नहीं दिया जाना चाहिए.
custom_package

String; "" डिफ़ॉल्ट है

Java पैकेज, जिसके लिए java सोर्स जनरेट किए जाएंगे. डिफ़ॉल्ट रूप से, पैकेज का अनुमान उस डायरेक्ट्री से लगाया जाता है जहां BUILD फ़ाइल होती है जिसमें नियम शामिल है. कोई दूसरा पैकेज तय किया जा सकता है, लेकिन यह है बहुत ज़्यादा नहीं होता है, क्योंकि इसकी वजह से क्लासपाथ के विरोधाभास हो सकते हैं लाइब्रेरी जिनका पता सिर्फ़ रनटाइम के दौरान लगाया जा सकेगा.
enable_data_binding

बूलियन; False डिफ़ॉल्ट है

अगर सही है, तो इस नियम को प्रोसेस किया जाता है डेटा बाइंडिंग एक्सप्रेशन के ज़रिए शामिल किए गए लेआउट रिसॉर्स में resource_files एट्रिब्यूट. इसके बिना सेटिंग के हिसाब से, डेटा बाइंडिंग एक्सप्रेशन से बिल्ड फ़ेल हो जाता है.

डेटा बाइंडिंग वाला Android ऐप्लिकेशन बनाने के लिए, आपको ये काम भी करने होंगे:

  1. इस एट्रिब्यूट को, Android के उन सभी नियमों के लिए सेट करें जो इस पर निर्भर करते हैं. ऐसा इसलिए होता है, क्योंकि डिपेंडेंट, रिसॉर्स के ज़रिए नियम के डेटा बाइंडिंग एक्सप्रेशन को इनहेरिट करते हैं मर्ज करना. इसलिए, उन एक्सप्रेशन को पार्स करने के लिए, उन्हें डेटा बाइंडिंग के साथ भी बनाना होगा.
  2. डेटा बाइंडिंग रनटाइम लाइब्रेरी के सभी टारगेट के लिए, deps = एंट्री जोड़ें जो इस एट्रिब्यूट को सेट करते हैं. इस लाइब्रेरी की जगह, आपके डिपो के सेट अप के हिसाब से तय होती है.
exported_plugins

लेबल की सूची; डिफ़ॉल्ट रूप से [] है

java_plugin की सूची (उदाहरण के लिए, एनोटेशन प्रोसेसर) शामिल करें.

java_plugin की तय सूची ऐसी किसी भी लाइब्रेरी पर लागू की जाएगी जिसमें इस लाइब्रेरी पर निर्भर करता है, ठीक वैसे ही जैसे कि उस लाइब्रेरी में plugins में लेबल.

exports

लेबल की सूची; डिफ़ॉल्ट रूप से [] है

exports एट्रिब्यूट के ज़रिए, सभी नियमों को बंद किया गया ऐसे किसी भी नियम की प्रत्यक्ष निर्भरता माने जाते हैं, जो आपकी exports के साथ टारगेट.

exports, उस नियम का सीधा हिस्सा नहीं हैं जिससे वे जुड़े हैं.

exports_manifest

पूर्णांक; 1 डिफ़ॉल्ट है

मेनिफ़ेस्ट एंट्री को android_binary टारगेट में एक्सपोर्ट करना है या नहीं जो इस टारगेट पर निर्भर करती हैं. uses-permissions एट्रिब्यूट को कभी एक्सपोर्ट नहीं किया जाता.
idl_import_root

String; "" डिफ़ॉल्ट है

idl वाले Java पैकेज ट्री के रूट का पैकेज-रिलेटिव पाथ इस लाइब्रेरी में शामिल स्रोत.

इस पाथ का इस्तेमाल इंपोर्ट रूट के तौर पर किया जाएगा, जब उन idl सोर्स को प्रोसेस किया जाएगा उस लाइब्रेरी पर निर्भर करते हैं.

जब idl_import_root बताया गया हो, तो दोनों idl_parcelables और idl_srcs, ऑब्जेक्ट के java पैकेज से तय किए गए पाथ पर होना चाहिए वे idl_import_root से कम का प्रतिनिधित्व करते हैं. जब idl_import_root होता है तय नहीं है, idl_parcelables और idl_srcs दोनों पाथ का इस्तेमाल करता है.

देखें उदाहरण.

idl_parcelables

लेबल की सूची; डिफ़ॉल्ट रूप से [] है

इंपोर्ट के तौर पर सप्लाई की जाने वाली Android IDL की परिभाषाओं की सूची. ये फ़ाइलें किसी भी सीधे इस लाइब्रेरी पर निर्भर android_library टारगेट या अपने अस्थायी बंद करने के माध्यम से, लेकिन Java में उसका अनुवाद नहीं किया जाएगा या कंपाइल न किए जाएं.

सिर्फ़ .aidl फ़ाइलें जो सीधे तौर पर जुड़ी हैं इस लाइब्रेरी में मौजूद .java स्रोत शामिल किए जाने चाहिए (उदाहरण के लिए, कस्टम पार्सल करने के तरीके को लागू करता है), नहीं तो idl_srcs होना चाहिए इस्तेमाल किया गया.

इन फ़ाइलों को सही जगह पर रखना ज़रूरी है, ताकि एडल कंपाइलर उन्हें ढूंढ सके. idl_Import_root का ब्यौरा देखें ताकि आपको इनके बारे में जानकारी मिल सके.

idl_preprocessed

लेबल की सूची; डिफ़ॉल्ट रूप से [] है

इंपोर्ट के तौर पर सप्लाई करने के लिए, पहले से प्रोसेस की गई Android IDL की परिभाषाओं की सूची. ये फ़ाइलें किसी भी सीधे इस लाइब्रेरी पर निर्भर android_library टारगेट या अपने अस्थायी बंद करने के माध्यम से, लेकिन Java में उसका अनुवाद नहीं किया जाएगा या कंपाइल न किए जाएं.

सिर्फ़ पहले से प्रोसेस की गई .aidl फ़ाइलें, जो सीधे तौर पर संबंधित हैं इस लाइब्रेरी में मौजूद .java स्रोत शामिल किए जाने चाहिए (उदाहरण के लिए, कस्टम पार्सल करने का तरीका लागू करना), या फिर इन चीज़ों के लिए idl_srcs का इस्तेमाल करें Android IDL की परिभाषाएं, जिनका Java इंटरफ़ेस में अनुवाद किया जाना चाहिए और idl_parcelable का इस्तेमाल करें प्रोसेस नहीं की गई एआईडीएल फ़ाइलों के लिए.

idl_srcs

लेबल की सूची; डिफ़ॉल्ट रूप से [] है

Java इंटरफ़ेस में अनुवाद करने के लिए, Android IDL की परिभाषाओं की सूची. Java इंटरफ़ेस जनरेट होने के बाद, उन्हें एक साथ कंपाइल किया जाएगा srcs की सामग्री के साथ.

ये फ़ाइलें किसी भी सीधे इस लाइब्रेरी पर निर्भर android_library टारगेट अस्थायी तौर पर बंद रहने के दौरान भी किया जा सकता है.

इन फ़ाइलों को सही जगह पर रखना ज़रूरी है, ताकि एडल कंपाइलर उन्हें ढूंढ सके. idl_Import_root का ब्यौरा देखें ताकि आपको इनके बारे में जानकारी मिल सके.

javacopts

स्ट्रिंग की सूची; [] डिफ़ॉल्ट है

इस टारगेट के लिए, कंपाइलर के ज़्यादा विकल्प. "वैरिएबल बनाएं" के विकल्प पर निर्भर करता है और बोर्न शेल टोकनाइज़ेशन.

ग्लोबल कंपाइलर विकल्पों के बाद, ये कंपाइलर विकल्प javac को पास किए जाते हैं.

manifest

लेबल; डिफ़ॉल्ट रूप से None है

Android मेनिफ़ेस्ट फ़ाइल का नाम, आम तौर पर AndroidManifest.xml. अगरResource_files या ऐसेट के बारे में बताया गया है, तो यह तय करना ज़रूरी है.

बूलियन; False डिफ़ॉल्ट है

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

लेबल की सूची; डिफ़ॉल्ट रूप से [] है

कंपाइलर के समय चलाए जाने वाले Java कंपाइलर प्लगिन. इसमें बताई गई हर java_plugin प्लगिन एट्रिब्यूट जब भी इस्तेमाल होगा, इस टारगेट को बनाया जाता है. संसाधन बनाने वाले का नाम प्लगिन को इसके परिणाम जार में शामिल किया जाएगा टारगेट किया जा सकता है.
proguard_specs

लेबल की सूची; डिफ़ॉल्ट रूप से [] है

ProGuard स्पेसिफ़िकेशन के तौर पर इस्तेमाल की जाने वाली फ़ाइलें. यहां ProGuard की ओर से इस्तेमाल की जाने वाली खास जानकारी के बारे में बताया जाएगा. अगर तय किया गया हो, उन्हें इस लाइब्रेरी के आधार पर किसी भी android_binary टारगेट में जोड़ दिया जाएगा. यहां शामिल की गई फ़ाइलों में सिर्फ़ पहचान बदलने वाले नियम होने चाहिए, जैसे कि -dontnote, -dontvarn, माना जाता है कि -keep से शुरू होने वाले नियम और साइड इफ़ेक्ट शामिल हैं. अन्य विकल्प सिर्फ़ यहां दिख सकते हैं android_binary के ProGuard_specs, ताकि नॉन-टॉटलॉजिकल मर्ज पक्का किए जा सकें.
resource_files

लेबल की सूची; डिफ़ॉल्ट रूप से [] है

पैकेज किए जाने वाले संसाधनों की सूची. आम तौर पर, यह फ़ाइल के तहत आने वाली सभी फ़ाइलों का glob होता है res डायरेक्ट्री.
अभी तक किसी भी व्यक्ति ने चेक इन नहीं किया है जनरेट की गई फ़ाइलों (genrules से) का रेफ़रंस इनसे लिया जा सकता है यहां भी लेबल करें. पाबंदी सिर्फ़ यह है कि जनरेट किए गए आउटपुट, "res" से कम होने चाहिए डायरेक्ट्री, किसी भी अन्य फ़ॉर्मैट में होनी चाहिए शामिल हैं.

android_instrumentation_test

नियम का सोर्स देखें
android_instrumentation_test(name, data, args, compatible_with, deprecation, distribs, env, env_inherit, exec_compatible_with, exec_properties, features, flaky, licenses, local, restricted_to, shard_count, size, support_apks, tags, target_compatible_with, target_device, test_app, testonly, timeout, toolchains, visibility)

android_instrumentation_test नियम के मुताबिक, Android इंस्ट्रुमेंटेशन की जांच की जाती है. यह काम करेगा एम्युलेटर शुरू करें, टेस्ट किया जा रहा ऐप्लिकेशन इंस्टॉल करें, और टेस्ट ऐप्लिकेशन किसी भी अन्य ऐप्लिकेशन को इंस्टॉल करने की कोशिश की जा सकती है, और परीक्षण पैकेज में तय किए गए परीक्षणों को चलाया जा सकता है.

test_app एट्रिब्यूट android_binary जिसमें टेस्ट शामिल है. यह android_binary, इसकी मदद से, टेस्ट में शामिल android_binary ऐप्लिकेशन के बारे में बताता है instruments एट्रिब्यूट का इस्तेमाल करना चाहिए.

उदाहरण

# java/com/samples/hello_world/BUILD

android_library(
    name = "hello_world_lib",
    srcs = ["Lib.java"],
    manifest = "LibraryManifest.xml",
    resource_files = glob(["res/**"]),
)

# The app under test
android_binary(
    name = "hello_world_app",
    manifest = "AndroidManifest.xml",
    deps = [":hello_world_lib"],
)
# javatests/com/samples/hello_world/BUILD

android_library(
    name = "hello_world_test_lib",
    srcs = ["Tests.java"],
    deps = [
      "//java/com/samples/hello_world:hello_world_lib",
      ...  # test dependencies such as Espresso and Mockito
    ],
)

# The test app
android_binary(
    name = "hello_world_test_app",
    instruments = "//java/com/samples/hello_world:hello_world_app",
    manifest = "AndroidManifest.xml",
    deps = [":hello_world_test_lib"],
)

android_instrumentation_test(
    name = "hello_world_uiinstrumentation_tests",
    target_device = ":some_target_device",
    test_app = ":hello_world_test_app",
)

तर्क

विशेषताएं
name

नाम; आवश्यक

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

support_apks

लेबल की सूची; डिफ़ॉल्ट रूप से [] है

इंस्ट्रुमेंटेशन टेस्ट शुरू होने से पहले, डिवाइस पर इंस्टॉल किए जाने वाले अन्य APKs.
target_device

लेबल; आवश्यक

वह android_device जिस पर टेस्ट चलना चाहिए.

पहले से चल रहे एम्युलेटर या फ़िज़िकल डिवाइस पर टेस्ट करने के लिए, इसका इस्तेमाल करें ये तर्क: --test_output=streamed --test_arg=--device_broker_type=LOCAL_ADB_SERVER --test_arg=--device_serial_number=$device_identifier अभी तक किसी भी व्यक्ति ने चेक इन नहीं किया है

test_app

लेबल; आवश्यक

android_binary टारगेट में टेस्ट क्लास शामिल हैं. android_binary टारगेट को यह बताना होगा कि वह किस टारगेट से टेस्ट कर रहा है इसकी instruments एट्रिब्यूट की वैल्यू सबमिट की गई है.

android_local_test

नियम का सोर्स देखें
android_local_test(name, deps, srcs, data, args, compatible_with, custom_package, densities, deprecation, enable_data_binding, env, env_inherit, exec_compatible_with, exec_properties, features, flaky, javacopts, jvm_flags, licenses, local, manifest, manifest_values, nocompress_extensions, plugins, resource_configuration_filters, resource_jars, resource_strip_prefix, restricted_to, runtime_deps, shard_count, size, stamp, tags, target_compatible_with, test_class, testonly, timeout, toolchains, use_launcher, visibility)

यह नियम स्थानीय तौर पर android_library नियमों की जांच करने के लिए है (यह एक डिवाइस पर अलग होता है). यह Android Robolectric फ़्रेमवर्क के साथ काम करता है. इस बारे में जानकारी के लिए Android Robolectric साइट देखें जिनमें रोबोलेक्ट्रिक टेस्ट लिखे जा रहे हों.

इंप्लिसिट आउटपुट टारगेट

  • name.jar: टेस्ट का Java संग्रह.
  • name-src.jar: सोर्स वाला एक संग्रह ("सोर्स जार").
  • name_deploy.jar: Java डिप्लॉयमेंट के लिए सही संग्रह डिप्लॉयमेंट के लिए (सिर्फ़ तब बनाया जाता है, जब साफ़ तौर पर अनुरोध किया गया हो).

उदाहरण

android_local_test के साथ Robolectric का इस्तेमाल करने के लिए, जोड़ें रोबोलेक्टरिक्स डेटा स्टोर करने की जगह को आपकी WORKSPACE फ़ाइल में सेव करें:

http_archive(
    name = "robolectric",
    urls = ["https://github.com/robolectric/robolectric-bazel/archive/<COMMIT>.tar.gz"],
    strip_prefix = "robolectric-bazel-<COMMIT>",
    sha256 = "<HASH>",
)
load("@robolectric//bazel:robolectric.bzl", "robolectric_repositories")
robolectric_repositories()
इससे Robolectric के लिए ज़रूरी maven_jar नियम लागू हो जाते हैं. तो हर android_local_test नियम इन पर निर्भर होना चाहिए: @robolectric//bazel:robolectric. नीचे उदाहरण देखें।

android_local_test(
    name = "SampleTest",
    srcs = [
        "SampleTest.java",
    ],
    manifest = "LibManifest.xml",
    deps = [
        ":sample_test_lib",
        "@robolectric//bazel:android-all",
    ],
)

android_library(
    name = "sample_test_lib",
    srcs = [
         "Lib.java",
    ],
    resource_files = glob(["res/**"]),
    manifest = "AndroidManifest.xml",
)

तर्क

विशेषताएं
name

नाम; आवश्यक

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

deps

लेबल की सूची; डिफ़ॉल्ट रूप से [] है

जिन लाइब्रेरी की जांच होनी है उनकी सूची और लिंक की जाने वाली अतिरिक्त लाइब्रेरी कमाया जा सकता है. ऐसे सभी संसाधन, एसेट, और मेनिफ़ेस्ट फ़ाइलों के बारे में जिनका एलान Android के नियमों में ट्रांज़िट के दौरान किया गया है इस एट्रिब्यूट की वैल्यू को बंद करने की जानकारी, टेस्ट में उपलब्ध कराई जाती है.

deps में मंज़ूर किए गए नियमों की सूची android_library है, aar_import, java_import, java_library, और java_lite_proto_library.

srcs

लेबल की सूची; डिफ़ॉल्ट रूप से [] है

टारगेट बनाने के लिए प्रोसेस की जाने वाली सोर्स फ़ाइलों की सूची. नीचे बताए गए खास मामलों को छोड़कर, यह ज़रूरी है.

.java टाइप की srcs फ़ाइलें कंपाइल की गई हैं. सिर्फ़ समझने के लिए, किसी साइट का नाम srcs में .java सोर्स फ़ाइल जनरेट की गई. इसके बजाय, srcs में डिपेंडेंट-ऑन नियम का नाम इस तरह रखें जिनकी जानकारी नीचे दी गई है.

.srcjar टाइप की srcs फ़ाइलें पैक नहीं की गई हैं और कंपाइल किया गया. (यह तब काम आता है, जब आपको .java फ़ाइलों का सेट जनरेट करने की ज़रूरत हो सामान्य या बिल्ड एक्सटेंशन शामिल करें.)

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

srcs एट्रिब्यूट ज़रूरी है और इसे तब तक खाली नहीं छोड़ा जा सकता, जब तक कि runtime_deps बताया गया है.

custom_package

String; "" डिफ़ॉल्ट है

Java पैकेज जिसमें R क्लास जनरेट की जाएगी. डिफ़ॉल्ट रूप से पैकेज का अनुमान लगाया जाता है उस डायरेक्ट्री से जिसमें नियम वाली BUILD फ़ाइल मौजूद है. इस एट्रिब्यूट का इस्तेमाल करने पर, आपको test_class का भी इस्तेमाल करना होगा.
densities

स्ट्रिंग की सूची; [] डिफ़ॉल्ट है

APK बनाते समय, फ़िल्टर करने के लिए डेंसिटी. स्क्रीन के साथ काम करने वाली स्क्रीन मेनिफ़ेस्ट में सेक्शन तब भी जोड़ा जाएगा, जब उसमें पहले से कोई Superset StarlarkListing.
enable_data_binding

बूलियन; False डिफ़ॉल्ट है

अगर सही है, तो इस नियम को प्रोसेस किया जाता है डेटा बाइंडिंग रेफ़रंस, जिनका इस्तेमाल इस टेस्ट में इस्तेमाल होने वाली डेटा-बाइंडिंग चालू डिपेंडेंसी में किया जाता है. इसके बिना इस सेटिंग में, डेटा-बाइंडिंग डिपेंडेंसी के लिए ज़रूरी बाइनरी-लेवल कोड जनरेशन नहीं होगा, साथ ही, इन वजहों से बिल्ड फ़ेल हो सकता है.
javacopts

स्ट्रिंग की सूची; [] डिफ़ॉल्ट है

इस लाइब्रेरी के लिए कंपाइलर के ज़्यादा विकल्प. "वैरिएबल बनाएं" के विकल्प पर निर्भर करता है और बोर्न शेल टोकनाइज़ेशन.

ग्लोबल कंपाइलर विकल्पों के बाद, ये कंपाइलर विकल्प javac को पास किए जाते हैं.

jvm_flags

स्ट्रिंग की सूची; [] डिफ़ॉल्ट है

इस बाइनरी को चलाने के लिए जनरेट की गई रैपर स्क्रिप्ट में एम्बेड करने के लिए फ़्लैग की सूची. यह $(location) और "वैरिएबल बनाएं" विकल्प बोर्न शेल टोकनाइज़ेशन.

Java बाइनरी के लिए रैपर स्क्रिप्ट में एक CLASSPATH परिभाषा शामिल है (सभी डिपेंडेंट जार ढूंढने के लिए) और सही Java इंटरप्रेटर को शुरू करता है. रैपर स्क्रिप्ट से जनरेट की गई कमांड लाइन में मुख्य क्लास के बाद "$@", ताकि आप परीक्षा पास कर सकें आर्ग्युमेंट को कॉपी करें. हालांकि, पार्स करने के लिए बनाए गए तर्क के ज़रिए JVM को कमांड पर क्लासनाम से पहले तय किया जाना चाहिए लाइन. jvm_flags के कॉन्टेंट को रैपर में जोड़ दिया जाता है स्क्रिप्ट को सूची में शामिल करें.

ध्यान दें कि इस एट्रिब्यूट का *_deploy.jar पर कोई असर नहीं पड़ता आउटपुट.

manifest

लेबल; डिफ़ॉल्ट रूप से None है

Android मेनिफ़ेस्ट फ़ाइल का नाम, आम तौर पर AndroidManifest.xml. यह तय करना ज़रूरी है कि रिसॉर्स_फ़ाइलों या ऐसेट के बारे में जानकारी दी गई हो या इनमें से किसी जांच की जा रही लाइब्रेरी में minSdkVersion टैग मौजूद है.
manifest_values

शब्दकोश: स्ट्रिंग -> String; {} डिफ़ॉल्ट है

मेनिफ़ेस्ट में बदली जाने वाली वैल्यू की डिक्शनरी. साइट पर ${name} का कोई भी इंस्टेंस मेनिफ़ेस्ट को इस शब्दकोश में नाम के मुताबिक मान से बदल दिया जाएगा. applicationId, versionCode, versionName, minSdkVersion, targetSdkVersion, और maxSdkVersion, इससे जुड़े एट्रिब्यूट को भी बदल देगा के मेनिफ़ेस्ट और का इस्तेमाल करता है. packageName को अनदेखा कर दिया जाएगा और इसे इनमें से किसी एक पर सेट किया जाएगा applicationId अगर बताया गया हो या फिर मेनिफ़ेस्ट में पैकेज शामिल हो. Manifest_values का इस्तेमाल करने के लिए, नियम में मेनिफ़ेस्ट होना ज़रूरी नहीं है.
nocompress_extensions

स्ट्रिंग की सूची; [] डिफ़ॉल्ट है

संसाधन apk में बिना कंप्रेस किए छोड़ने के लिए फ़ाइल एक्सटेंशन की सूची.
plugins

लेबल की सूची; डिफ़ॉल्ट रूप से [] है

कंपाइलर के समय चलाए जाने वाले Java कंपाइलर प्लगिन. इस एट्रिब्यूट में दी गई हर java_plugin, जब भी यह नियम लागू होगा, तब ट्रिगर की जाएगी बनाया जाता है. कोई लाइब्रेरी उन डिपेंडेंसी से प्लगिन भी इनहेरिट कर सकती है जिनका इस्तेमाल किया जाता है exported_plugins. रिसोर्स प्लगिन से जनरेट की गई वैल्यू को इस नियम के नतीजे में मिलने वाले जार में शामिल किया जाएगा.
resource_configuration_filters

स्ट्रिंग की सूची; [] डिफ़ॉल्ट है

संसाधन कॉन्फ़िगरेशन के फ़िल्टर की सूची, जैसे कि 'en' इससे संसाधनों को सीमित कर दिया जाएगा apk केवल 'en' में मौजूद लोगों को apk कॉन्फ़िगरेशन.
resource_jars

लेबल की सूची; डिफ़ॉल्ट रूप से [] है

यह सुविधा अब काम नहीं करती: इसके बजाय, java_Import और deps या बनाए गए रनटाइम_deps का इस्तेमाल करें.
resource_strip_prefix

String; "" डिफ़ॉल्ट है

Java संसाधनों से स्ट्रिप करने के लिए पाथ प्रीफ़िक्स.

अगर बताया गया है, तो resources में मौजूद हर फ़ाइल से इस पाथ प्रीफ़िक्स को हटा दिया जाएगा एट्रिब्यूट की वैल्यू सबमिट करें. किसी संसाधन फ़ाइल को इस डायरेक्ट्री के अंदर न होने की एक गड़बड़ी होती है. अगर नहीं (डिफ़ॉल्ट रूप से), संसाधन फ़ाइल का पाथ लॉजिक को सोर्स फ़ाइलों के Java पैकेज के तौर पर सेट करें. उदाहरण के लिए, stuff/java/foo/bar/a.txt का पता foo/bar/a.txt है.

runtime_deps

लेबल की सूची; डिफ़ॉल्ट रूप से [] है

ऐसी लाइब्रेरी जिन्हें सिर्फ़ रनटाइम के समय पर फ़ाइनल बाइनरी या टेस्ट के लिए उपलब्ध कराया जाना है. सामान्य deps की तरह, ये रनटाइम क्लासपाथ पर दिखेंगे. हालांकि, ये इनकी तरह नहीं दिखेंगे नहीं, कंपाइल-टाइम क्लासपाथ पर. सिर्फ़ रनटाइम के दौरान ज़रूरी डिपेंडेंसी जो यहाँ सूचीबद्ध हैं. डिपेंडेंसी विश्लेषण टूल को उन टारगेट पर ध्यान नहीं देना चाहिए जो दोनों runtime_deps और deps.
stamp

पूर्णांक; 0 डिफ़ॉल्ट है

बिल्ड की जानकारी को बाइनरी में एन्कोड करना है या नहीं. वैल्यू, इनमें से कोई हो सकती है:
  • stamp = 1: बिल्ड जानकारी को हमेशा बाइनरी में स्टैंप करें, भले ही --nostamp बिल्ड. यह सेटिंग से बचना चाहिए, क्योंकि यह बाइनरी और ऐसी डाउनस्ट्रीम कार्रवाइयां जो उस पर निर्भर करती हैं.
  • stamp = 0: बिल्ड की जानकारी को हमेशा कॉन्सटैंट वैल्यू से बदलें. यह अच्छे बिल्ड परिणाम को कैश मेमोरी में सेव करता है.
  • stamp = -1: बिल्ड की जानकारी को एम्बेड करने का कंट्रोल, --[no]stamp फ़्लैग.

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

test_class

String; "" डिफ़ॉल्ट है

जांच करने वाले रनर की ओर से लोड की जाने वाली Java क्लास.

यह एट्रिब्यूट, उस Java क्लास का नाम बताता है जिसे चलाना है करें. इसे सेट करने की ज़रूरत कभी-कभार ही होती है. अगर यह आर्ग्युमेंट छोड़ दिया जाता है, तो Java क्लास जिसका नाम इसकी name से मेल खाता हो android_local_test नियम का इस्तेमाल किया जाएगा. टेस्ट क्लास के बारे में org.junit.runner.RunWith के साथ जानकारी देना ज़रूरी है.

use_launcher

बूलियन; True डिफ़ॉल्ट है

बाइनरी को कस्टम लॉन्चर का इस्तेमाल करना चाहिए या नहीं.

अगर इस एट्रिब्यूट को 'गलत' पर सेट किया जाता है, तो लॉन्चर एट्रिब्यूट और मिलते-जुलते एट्रिब्यूट --java_launcher फ़्लैग को इस टारगेट के लिए अनदेखा कर दिया जाएगा.

android_device

नियम का सोर्स देखें
android_device(name, cache, compatible_with, default_properties, deprecation, distribs, exec_compatible_with, exec_properties, features, horizontal_resolution, licenses, platform_apks, ram, restricted_to, screen_density, system_image, tags, target_compatible_with, testonly, vertical_resolution, visibility, vm_heap)

यह नियम दिए गए टूल के साथ कॉन्फ़िगर किया गया Android एम्युलेटर बनाता है खास जानकारी. इस एम्युलेटर को बेज़ल रन से चालू किया जा सकता है आदेश या जनरेट की गई स्क्रिप्ट को सीधे एक्ज़ीक्यूट करके. यह इस बात पर निर्भर रहना चाहिए कि android_device के नियमों के हिसाब से तय करें.

यह नियम --un_under फ़्लैग के लिए बेज़ल टेस्ट और ब्लेज़ के लिए सही टारगेट है दौड़ना. यह एक एम्युलेटर शुरू करता है, टेस्ट किए जा रहे टारगेट को एम्युलेटर पर कॉपी करता है/चलाता है, और उसकी जांच करता है या ज़रूरत के हिसाब से काम करता है.

android_device के तहत केवीएम इमेज बनाई जा सकती हैं, अगर system_image X86 पर आधारित है और यह इसे I686 सीपीयू आर्किटेक्चर के लिए ऑप्टिमाइज़ किया गया है. केवीएम ऐड का इस्तेमाल करने के लिए android_device नियम में tags = ['requires-kvm'] .

इंप्लिसिट आउटपुट टारगेट

  • name_images/userdata.dat: इसमें एम्युलेटर शुरू करने के लिए इमेज फ़ाइलें और स्नैपशॉट शामिल हैं
  • name_images/emulator-meta-data.pb: इसमें एम्युलेटर को पास करने के लिए, क्रम से लगाई गई जानकारी शामिल होती है इसे रीस्टार्ट करें.

उदाहरण

नीचे दिया गया उदाहरण android_device को इस्तेमाल करने का तरीका दिखाता है. //java/android/helloandroid/BUILD में शामिल है

android_device(
    name = "nexus_s",
    cache = 32,
    default_properties = "nexus_s.properties",
    horizontal_resolution = 480,
    ram = 512,
    screen_density = 233,
    system_image = ":emulator_images_android_16_x86",
    vertical_resolution = 800,
    vm_heap = 32,
)

filegroup(
    name = "emulator_images_android_16_x86",
    srcs = glob(["androidsdk/system-images/android-16/**"]),
)

//java/android/helloandroid/nexus_s.properties में शामिल है:

ro.product.brand=google
ro.product.device=crespo
ro.product.manufacturer=samsung
ro.product.model=Nexus S
ro.product.name=soju

इस नियम से इमेज और एक स्टार्ट स्क्रिप्ट जनरेट होगी. एम्युलेटर को चालू किया जा सकता है स्थानीय रूप से यह चलाने के लिए बेज़ल रन :Nexus_s -- --action=start. स्क्रिप्ट दिखाती है ये फ़्लैग:

  • --adb_port: adb को बाहर रखना है. अगर आपको adb जारी करना है एम्युलेटर को निर्देश दें. यह वह पोर्ट है जिसे आप adb कनेक्ट जारी करेंगे से.
  • --emulator_port: एम्युलेटर के टेलनेट मैनेजमेंट को दिखाने वाला पोर्ट चालू करें.
  • --enable_display: एम्युलेटर को सही होने पर डिसप्ले से शुरू करता है (डिफ़ॉल्ट गलत पर सेट करें).
  • --कार्रवाई: या तो शुरू करो या मार दो.
  • --apks_to_install: एम्युलेटर पर इंस्टॉल किए जाने वाले apks की सूची.

तर्क

विशेषताएं
name

नाम; आवश्यक

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

cache

पूर्णांक; आवश्यक

एम्युलेटर के कैश मेमोरी वाले हिस्से का साइज़, मेगाबाइट में. इसका कम से कम मान 16 मेगाबाइट होता है.
default_properties

लेबल; डिफ़ॉल्ट रूप से None है

एम्युलेटर पर /default.prop में रखी जाने वाली एक प्रॉपर्टी फ़ाइल. इससे नियम के लेखक को एम्युलेटर को और कॉन्फ़िगर करने की अनुमति मिलती है, ताकि वह इस तरह का दिख सके असली डिवाइस (खास तौर पर, अपनी UserAgent स्ट्रिंग और दूसरी चीज़ों को कंट्रोल करना) ऐसा व्यवहार जिसकी वजह से, कोई ऐप्लिकेशन या सर्वर अलग तरह से काम कर सकता है खास डिवाइस). इस फ़ाइल में मौजूद प्रॉपर्टी सिर्फ़ रीड ओनली को बदलेंगी प्रॉपर्टी आम तौर पर एम्युलेटर की मदद से सेट की जाती हैं, जैसे कि ro.product.model.
horizontal_resolution

पूर्णांक; आवश्यक

एम्युलेट करने के लिए, पिक्सल में हॉरिज़ॉन्टल स्क्रीन रिज़ॉल्यूशन. कम से कम वैल्यू 240 है.
platform_apks

लेबल की सूची; डिफ़ॉल्ट रूप से [] है

बूट के समय डिवाइस पर इंस्टॉल किए जाने वाले apks की सूची.
ram

पूर्णांक; आवश्यक

डिवाइस के लिए अनुकरण करने के लिए मेगाबाइट में रैम की मात्रा. यह सिर्फ़ डिवाइस पर इंस्टॉल किए गए किसी ऐप्लिकेशन के लिए ही नहीं, बल्कि पूरे डिवाइस के लिए है. कॉन्टेंट बनाने कम से कम वैल्यू 64 मेगाबाइट है.
screen_density

पूर्णांक; आवश्यक

एम्युलेट की गई स्क्रीन का घनत्व, पिक्सल प्रति इंच के हिसाब से. इसकी वैल्यू कम से कम 30 पीपीआई होनी चाहिए.
system_image

लेबल; आवश्यक

एक फ़ाइलग्रुप, जिसमें ये फ़ाइलें होती हैं:
  • System.img: सिस्टम पार्टिशन
  • kernel-qemu: एम्युलेटर, Linux कर्नेल लोड होगा
  • ramdisk.img: बूट के समय इस्तेमाल की जाने वाली पहली इमेज
  • userdata.img: उपयोगकर्ता के डेटा का शुरुआती हिस्सा
  • source.property: एक प्रॉपर्टी फ़ाइल जिसमें इमेज
ये फ़ाइलें android sdk का हिस्सा हैं या उन्हें तीसरे पक्ष की मदद से उपलब्ध कराई गई हैं (इसके लिए उदाहरण के लिए, Intel x86 इमेज उपलब्ध कराता है).
vertical_resolution

पूर्णांक; आवश्यक

एम्युलेट करने के लिए, पिक्सल में वर्टिकल स्क्रीन रिज़ॉल्यूशन. कम से कम वैल्यू 240 है.
vm_heap

पूर्णांक; आवश्यक

Android पर वर्चुअल मशीन हीप का साइज़, मेगाबाइट में हर प्रोसेस के लिए इस्तेमाल किया जाएगा. कम से कम वैल्यू 16 मेगाबाइट है.

android_ndk_repository

नियम का सोर्स देखें
android_ndk_repository(name, api_level, path, repo_mapping)

इससे Baज़ल को Android एनडीके (NDK) का इस्तेमाल करके कॉन्फ़िगर किया जाता है, ताकि नेटिव विज्ञापन के साथ Android टारगेट बनाने में मदद मिल सके कोड.

ध्यान दें कि android_ndk_repository को लागू करने की इस प्रोसेस को Starlark में लागू करने की प्रोसेस. एनडीके के 25 और इसके बाद के वर्शन के साथ काम करने की सुविधा android_ndk_repository के Starlark वर्शन में लागू की जाएगी. यहां जाएं: Starlark के लिए rules_android_ndk वर्शन है.

ध्यान दें कि Android के लिए बनाने के लिए आपकेandroid_sdk_repository WORKSPACE फ़ाइल.

ज़्यादा जानकारी के लिए, Basel के साथ Android NDK का इस्तेमाल करने से जुड़े पूरे दस्तावेज़.

उदाहरण

android_ndk_repository(
    name = "androidndk",
)

ऊपर दिया गया उदाहरण, $ANDROID_NDK_HOME से आपके Android एनडीके (NDK) का पता लगाएगा और का एपीआई लेवल सेट करना होगा.

android_ndk_repository(
    name = "androidndk",
    path = "./android-ndk-r20",
    api_level = 24,
)

ऊपर दिया गया उदाहरण, आपके फ़ाइल फ़ोल्डर में मौजूद Android NDK ./android-ndk-r20. यह जेएनआई को कंपाइल करते समय, एपीआई लेवल 24 लाइब्रेरी का इस्तेमाल करेगा कोड.

सीपीयू फीचर्स

Android NDK में cpufeatures लाइब्रेरी जिसकी मदद से रनटाइम के दौरान किसी डिवाइस के सीपीयू का पता लगाया जा सकता है. नीचे दिए गए उदाहरण में, बेज़ल के साथ cpufeatures.

# jni.cc
#include "ndk/sources/android/cpufeatures/cpu-features.h"
...
# BUILD
cc_library(
    name = "jni",
    srcs = ["jni.cc"],
    deps = ["@androidndk//:cpufeatures"],
)

तर्क

विशेषताएं
name

नाम; आवश्यक

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

api_level

पूर्णांक; कॉन्फ़िगर नहीं किया जा सकता; डिफ़ॉल्ट रूप से 0 है

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

String; कॉन्फ़िगर नहीं किया जा सकता; डिफ़ॉल्ट रूप से "" है

किसी Android एनडीके का ऐब्सलूट या रिलेटिव पाथ. यह एट्रिब्यूट या $ANDROID_NDK_HOME एनवायरमेंट वैरिएबल सेट करना ज़रूरी है.

Android NDK को यहां से डाउनलोड किया जा सकता है Android डेवलपर साइट .

repo_mapping

शब्दकोश: स्ट्रिंग -> String; {} डिफ़ॉल्ट है

लोकल रिपॉज़िटरी के नाम से लेकर ग्लोबल रिपॉज़िटरी के नाम तक का डिक्शनरी. इससे आपको इन चीज़ों पर कंट्रोल मिलेगा इस रिपॉज़िटरी की डिपेंडेंसी के लिए वर्कस्पेस डिपेंडेंसी का रिज़ॉल्यूशन.

उदाहरण के लिए, "@foo": "@bar" एंट्री से पता चलता है कि किसी भी समय डेटा स्टोर करने की जगह, "@foo" पर निर्भर करती है (जैसे, डेटा स्टोर करने की जगह "@foo//some:target"), तो इसे वास्तव में दुनिया भर में एलान किया गया "@bar" ("@bar//some:target").

android_sdk_repository

नियम का सोर्स देखें
android_sdk_repository(name, api_level, build_tools_version, path, repo_mapping)

इस नीति से, Basel को स्थानीय Android SDK टूल का इस्तेमाल करने के लिए कॉन्फ़िगर किया जाता है, ताकि Android टारगेट बनाने में मदद मिल सके.

उदाहरण

Basel के लिए Android SDK सेट अप करने के लिए कम से कम android_sdk_repository नियम होना चाहिए नाम "androidsdk" अपनी WORKSPACE फ़ाइल में और $ANDROID_HOME सेट करें एनवायरमेंट वैरिएबल को ट्रांसफ़र करके. Baज़ल, Android API के सबसे नए लेवल का इस्तेमाल करेगा साथ ही, Android SDK में डिफ़ॉल्ट रूप से इंस्टॉल किए गए टूल वर्शन भी बना सकते हैं.
android_sdk_repository(
    name = "androidsdk",
)

फिर से बनाए जा सकने वाले बिल्ड पक्का करने के लिए, path, api_level और build_tools_version एट्रिब्यूट को खास वैल्यू पर सेट किया जा सकता है. बिल्ड काम नहीं करेगा, अगर Android SDK में, बताया गया एपीआई लेवल या बिल्ड टूल वर्शन इंस्टॉल नहीं किया गया है.

android_sdk_repository(
    name = "androidsdk",
    path = "./sdk",
    api_level = 19,
    build_tools_version = "25.0.0",
)

ऊपर दिए गए उदाहरण में, Android SDK के वर्कस्पेस से जुड़े पाथ का इस्तेमाल करने का तरीका भी बताया गया है. यह है तब काम का है, जब Android SDK आपके Basel Workspace का हिस्सा है (उदाहरण के लिए, अगर उसे वर्शन में चेक इन किया गया हो नियंत्रण).

सहायता लाइब्रेरी

सहायता लाइब्रेरी, Android SDK Manager में "Android सहायता डेटा स्टोर करने की जगह" के तौर पर उपलब्ध हैं. यह सामान्य Android लाइब्रेरी का एक वर्शन वाला सेट है, जैसे कि Support और AppCompat लाइब्रेरी, जिसे लोकल Maven रिपॉज़िटरी के तौर पर पैकेज किया जाता है. android_sdk_repository, Basel को जनरेट करता है में से प्रत्येक लाइब्रेरी के लिए लक्षित होते हैं जिनका उपयोग android_binary और android_library टारगेट.

जनरेट किए गए टारगेट के नाम, यहां दी गई लाइब्रेरी के Maven कोऑर्डिनेट से लिए जाते हैं: Android सहायता डेटा संग्रह स्थान, @androidsdk//${group}:${artifact}-${version} के फ़ॉर्मैट में. यहां दिए गए उदाहरण में बताया गया है कि android_library, कैसे v7 appcompet लाइब्रेरी पर अपडेट करें.

android_library(
    name = "lib",
    srcs = glob(["*.java"]),
    manifest = "AndroidManifest.xml",
    resource_files = glob(["res/**"]),
    deps = ["@androidsdk//com.android.support:appcompat-v7-25.0.0"],
)

तर्क

विशेषताएं
name

नाम; आवश्यक

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

api_level

पूर्णांक; कॉन्फ़िगर नहीं किया जा सकता; डिफ़ॉल्ट रूप से 0 है

डिफ़ॉल्ट रूप से बनाया जाने वाला Android एपीआई लेवल. अगर इसके लिए वैल्यू तय नहीं की गई है, तो एपीआई लेवल की सबसे ज़्यादा वैल्यू होने पर इंस्टॉल किया जाएगा.

किसी दिए गए बिल्ड के लिए इस्तेमाल किए गए एपीआई लेवल को android_sdk से बदला जा सकता है फ़्लैग करें. android_sdk_repository इसके लिए android_sdk का टारगेट बनाता है SDK टूल में इंस्टॉल किए गए हर एपीआई लेवल को, @androidsdk//:sdk-${level} नाम से इंस्टॉल किया जाता है, यह एट्रिब्यूट तय किया गया है या नहीं. उदाहरण के लिए, नॉन-डिफ़ॉल्ट एपीआई को लागू करने के लिए लेवल: bazel build --android_sdk=@androidsdk//:sdk-19 //java/com/example:app.

android_sdk_repository के जनरेट किए गए सभी android_sdk टारगेट देखने के लिए, bazel query "kind(android_sdk, @androidsdk//...)" चलाया जा सकता है.

build_tools_version

String; कॉन्फ़िगर नहीं किया जा सकता; डिफ़ॉल्ट रूप से "" है

Android SDK में इस्तेमाल करने के लिए, Android बिल्ड टूल का वर्शन. अगर इसके बारे में नहीं बताया गया है, बिल्ड टूल के इंस्टॉल किए गए सबसे नए वर्शन का इस्तेमाल किया जाएगा.

Baज़र के लिए, बिल्ड टूल का 30.0.0 या उसके बाद का वर्शन होना ज़रूरी है.

path

String; कॉन्फ़िगर नहीं किया जा सकता; डिफ़ॉल्ट रूप से "" है

किसी Android SDK टूल का ऐब्सलूट या रिलेटिव पाथ. यह एट्रिब्यूट या $ANDROID_HOME एनवायरमेंट वैरिएबल सेट करना ज़रूरी है.

Android SDK टूल को यहां से डाउनलोड किया जा सकता है Android डेवलपर साइट पर जाकर देखें.

repo_mapping

शब्दकोश: स्ट्रिंग -> String; {} डिफ़ॉल्ट है

लोकल रिपॉज़िटरी के नाम से लेकर ग्लोबल रिपॉज़िटरी के नाम तक का डिक्शनरी. इससे आपको इन चीज़ों पर कंट्रोल मिलेगा इस रिपॉज़िटरी की डिपेंडेंसी के लिए वर्कस्पेस डिपेंडेंसी का रिज़ॉल्यूशन.

उदाहरण के लिए, "@foo": "@bar" एंट्री से पता चलता है कि किसी भी समय डेटा स्टोर करने की जगह, "@foo" पर निर्भर करती है (जैसे, डेटा स्टोर करने की जगह "@foo//some:target"), तो इसे वास्तव में दुनिया भर में एलान किया गया "@bar" ("@bar//some:target").