ध्यान दें: Android 9.0 (एपीआई लेवल 28) के रिलीज़ होने के साथ, AndroidX नाम की सहायता लाइब्रेरी का नया वर्शन उपलब्ध है. यह Jetpack का हिस्सा है.
AndroidX लाइब्रेरी में, मौजूदा सहायता लाइब्रेरी के साथ-साथ, Jetpack के नए कॉम्पोनेंट भी शामिल हैं.
सहायता लाइब्रेरी का इस्तेमाल जारी रखा जा सकता है.
ऐतिहासिक आर्टफ़ैक्ट (जो 27 और उससे पुराने वर्शन के हैं और android.support.*
के तौर पर पैकेज किए गए हैं)
ये Google Maven पर उपलब्ध रहेंगे. हालांकि, लाइब्रेरी से जुड़ा सारा नया डेवलपमेंट, AndroidX लाइब्रेरी में किया जाएगा.
हमारा सुझाव है कि सभी नए प्रोजेक्ट में AndroidX लाइब्रेरी का इस्तेमाल करें. आपको मौजूदा प्रोजेक्ट को भी AndroidX पर माइग्रेट करना चाहिए.
अपने डेवलपमेंट प्रोजेक्ट में Android Support Library को सेट अप करने का तरीका, इस बात पर निर्भर करता है कि किन सुविधाओं का इस्तेमाल किया जा रहा है आपको Android प्लैटफ़ॉर्म के किस वर्शन का इस्तेमाल करना है और का इस्तेमाल करें.
इस दस्तावेज़ में आपको सपोर्ट लाइब्रेरी पैकेज डाउनलोड करने और लाइब्रेरी जोड़ने का तरीका बताया गया है पर्यावरण को बेहतर बनाने में मदद करें.
सहायता लाइब्रेरी अब Google के Maven के ज़रिए उपलब्ध हैं डेटा स्टोर करने की जगह. अब SDK मैनेजर की मदद से लाइब्रेरी डाउनलोड नहीं की जा सकतीं. यह सुविधा जल्द ही हटा दी जाएगी.
सपोर्ट लाइब्रेरी चुनना
अपने ऐप्लिकेशन में सहायता लाइब्रेरी जोड़ने से पहले, तय करें कि आप किन सुविधाओं को शामिल करना चाहते हैं साथ ही, Android के जिन वर्शन पर काम करना है. सुविधाओं के बारे में ज़्यादा जानकारी पाने के लिए, अन्य लाइब्रेरी द्वारा उपलब्ध कराए गए हैं, तो देखें लाइब्रेरी की सुविधाओं में मदद करना.
सहायता लाइब्रेरी जोड़ना
सहायता लाइब्रेरी का उपयोग करने के लिए, आपको अपने ऐप्लिकेशन के प्रोजेक्ट को संशोधित करना होगा क्लासपाथ डिपेंडेंसी के लिए अपने डेवलपमेंट एनवायरमेंट का इस्तेमाल करें. आपको हर उस सहायता लाइब्रेरी के लिए यह तरीका अपनाना होगा जिसका इस्तेमाल करना है.
अपने ऐप्लिकेशन प्रोजेक्ट में सहायता लाइब्रेरी जोड़ने के लिए:
- अपने प्रोजेक्ट में, Google की Maven रिपॉज़िटरी शामिल करें
settings.gradle
फ़ाइल.dependencyResolutionManagement { repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS) repositories { google() // If you're using a version of Gradle lower than 4.1, you must // instead use: // // maven { // url 'https://maven.google.com' // } } }
- हर उस मॉड्यूल के लिए जिसमें आपको सपोर्ट लाइब्रेरी का इस्तेमाल करना है, लाइब्रेरी को
मॉड्यूल की
build.gradle
फ़ाइल काdependencies
ब्लॉक. उदाहरण के लिए, v4 core-utils लाइब्रेरी जोड़ने के लिए, यह जोड़ें:dependencies { ... implementation "com.android.support:support-core-utils:28.0.0" }
चेतावनी: डाइनैमिक डिपेंडेंसी (उदाहरण के लिए,
palette-v7:23.0.+
) का इस्तेमाल करने से, वर्शन के अनचाहे अपडेट और रिग्रेशन के साथ काम न करने की समस्याएं हो सकती हैं. हमारा सुझाव है कि आप लाइब्रेरी के वर्शन (उदाहरण के लिए, palette-v7:28.0.0
) के बारे में साफ़ तौर पर बताएं.
Support Library API का इस्तेमाल करना
मौजूदा फ़्रेमवर्क के एपीआई के लिए सहायता देने वाली लाइब्रेरी क्लास में आम तौर पर,
ये फ़्रेमवर्क क्लास के नाम से मिलते-जुलते हैं, लेकिन ये android.support
क्लास पैकेज में मौजूद हैं,
या उसमें *Compat
सफ़िक्स लगा हो.
चेतावनी: Support Library की क्लास का इस्तेमाल करते समय, पक्का करें कि आपने क्लास को सही पैकेज से इंपोर्ट किया हो. उदाहरण के लिए, ActionBar
क्लास को लागू करते समय:
- सहायता लाइब्रेरी का इस्तेमाल करते समय
android.support.v7.app.ActionBar
. - सिर्फ़ एपीआई लेवल 11 या उसके बाद के लेवल के लिए डेवलप करते समय
android.app.ActionBar
.
ध्यान दें: अपने ऐप्लिकेशन प्रोजेक्ट में सहायता लाइब्रेरी शामिल करने के बाद, हमारा सुझाव है कि आप रिलीज़ के लिए अपने ऐप्लिकेशन को छोटा करें, उसे धुंधला करें, और ऑप्टिमाइज़ करें. अपने सोर्स कोड को अस्पष्ट बनाने के अलावा, छोटा करके ऐसी किसी भी लाइब्रेरी से इस्तेमाल न हुई क्लास हटा देता है जिसे आपने अपने ऐप्लिकेशन में शामिल किया है. इससे ऐप्लिकेशन के डाउनलोड साइज़ को जितना हो सके उतना छोटा रखें.
Support Library की कुछ सुविधाओं का इस्तेमाल करने के बारे में ज़्यादा जानकारी, Android डेवलपर के लिए उपलब्ध ट्रेनिंग क्लास, गाइड, और सैंपल में दी गई है. अलग-अलग सहायता लाइब्रेरी की क्लास और तरीकों के बारे में ज़्यादा जानकारी के लिए, देखें
एपीआई के रेफ़रंस में android.support
पैकेज दिए गए हैं.
मेनिफ़ेस्ट के एलान में किए गए बदलाव
अगर आपको अपने मौजूदा ऐप्लिकेशन के पुराने सिस्टम के साथ काम करने की सुविधा को पहले वाले वर्शन पर सेट करना है, तो
का उपयोग कर सकते हैं, तो अपने ऐप्लिकेशन के
मेनिफ़ेस्ट. खास तौर पर, आपको android:minSdkVersion
को अपडेट करना चाहिए
का एलिमेंट
मेनिफ़ेस्ट में नए और पुराने वर्शन के नंबर पर इस तरह से <uses-sdk>
टैग लगाएं
नीचे दी गई जानकारी देखें:
<uses-sdk android:minSdkVersion="14" android:targetSdkVersion="23" />
मेनिफ़ेस्ट सेटिंग से Google Play को पता चलता है कि आपका ऐप्लिकेशन, Android 4.0 (एपीआई लेवल 14) और उसके बाद के वर्शन वाले डिवाइसों पर इंस्टॉल किया जा सकता है.
अगर Gradle बिल्ड फ़ाइलों का इस्तेमाल किया जा रहा है, तो बिल्ड फ़ाइल में minSdkVersion
सेटिंग
मेनिफ़ेस्ट सेटिंग को बदल देता है.
plugins { id 'com.android.application' } android { ... defaultConfig { minSdkVersion 16 ... } ... }
इस मामले में, बिल्ड फ़ाइल की सेटिंग से Google Play को पता चलता है कि ऐप्लिकेशन को Android 4.1 (एपीआई लेवल 16) और इसके बाद के वर्शन वाले डिवाइस पर इंस्टॉल किया जा सकता है. बिल्ड वैरिएंट के बारे में ज़्यादा जानकारी के लिए, बिल्ड सिस्टम की खास जानकारी देखें.
ध्यान दें: अगर आपने कई सहायक लाइब्रेरी शामिल की हैं, तो SDK टूल का कम से कम वर्शन, बताई गई किसी भी लाइब्रेरी के लिए ज़रूरी सबसे ज़्यादा वर्शन होना चाहिए. उदाहरण के लिए, अगर आपके ऐप्लिकेशन में v14 प्राथमिकता सहायता लाइब्रेरी और v17 Leanback लाइब्रेरी, आपकी कम से कम SDK टूल का वर्शन 17 या उसके बाद का होना चाहिए.