सहायता लाइब्रेरी सेटअप करना

ध्यान दें: Android 9.0 (एपीआई लेवल 28) के रिलीज़ होने के बाद, सहायता लाइब्रेरी के नए वर्शन को AndroidX, जो Jetpack का हिस्सा है. AndroidX लाइब्रेरी इसमें मौजूदा सपोर्ट लाइब्रेरी और Jetpack के सबसे नए कॉम्पोनेंट शामिल हैं.

सहायता लाइब्रेरी का इस्तेमाल जारी रखा जा सकता है. ऐतिहासिक आर्टफ़ैक्ट (जो 27 और उससे पुराने वर्शन के हैं और android.support.* के तौर पर पैकेज किए गए हैं) ये Google Maven पर उपलब्ध रहेंगे. हालांकि, सभी नई लाइब्रेरी में AndroidX लाइब्रेरी में दिखेगा.

हमारा सुझाव है कि सभी नए प्रोजेक्ट में AndroidX लाइब्रेरी का इस्तेमाल करें. आपको यह भी समझना चाहिए कि साथ ही, मौजूदा प्रोजेक्ट को AndroidX पर माइग्रेट करना होगा.

अपने डेवलपमेंट प्रोजेक्ट में Android Support Library को सेटअप करने का तरीका, इस बात पर निर्भर करता है कि किन सुविधाओं का इस्तेमाल किया जा रहा है आपको Android प्लैटफ़ॉर्म के किस वर्शन का इस्तेमाल करना है और का इस्तेमाल करें.

इस दस्तावेज़ में आपको सपोर्ट लाइब्रेरी पैकेज डाउनलोड करने और लाइब्रेरी जोड़ने का तरीका बताया गया है पर्यावरण को बेहतर बनाने में मदद करें.

सहायता लाइब्रेरी अब Google के Maven के ज़रिए उपलब्ध हैं डेटा स्टोर करने की जगह. हम अब SDK टूल से लाइब्रेरी डाउनलोड नहीं करते मैनेजर है और उस सुविधा को जल्द ही हटा दिया जाएगा.

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

अपने ऐप्लिकेशन में सहायता लाइब्रेरी जोड़ने से पहले, तय करें कि आप किन सुविधाओं को शामिल करना चाहते हैं साथ ही, Android के जिन वर्शन पर काम करना है. सुविधाओं के बारे में ज़्यादा जानकारी पाने के लिए, अन्य लाइब्रेरी द्वारा उपलब्ध कराए गए हैं, तो देखें लाइब्रेरी की सुविधाओं में मदद करना.

सहायता लाइब्रेरी जोड़ना

सहायता लाइब्रेरी का उपयोग करने के लिए, आपको अपने ऐप्लिकेशन के प्रोजेक्ट को संशोधित करना होगा आपके डेवलपमेंट एनवायरमेंट में क्लासपाथ डिपेंडेंसी के हिसाब से डेटा इस्तेमाल करती हैं. आपको यह प्रक्रिया इसके लिए करनी चाहिए हर सहायता लाइब्रेरी का इस्तेमाल करें जिसका आपको इस्तेमाल करना है.

अपने ऐप्लिकेशन प्रोजेक्ट में सहायता लाइब्रेरी जोड़ने के लिए:

1. अपने प्रोजेक्ट में, 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'
           // }
       }
   }
   

2. हर उस मॉड्यूल के लिए जिसमें आपको सपोर्ट लाइब्रेरी का इस्तेमाल करना है, लाइब्रेरी को मॉड्यूल की 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 सफ़िक्स लगा हो.

ध्यान दें: आपके ऐप्लिकेशन प्रोजेक्ट में सहायता लाइब्रेरी को शामिल करने के बाद, हम सुझाव है कि आप इसे छोटा करें, उलझा, और ऑप्टिमाइज़ करें अपना ऐप्लिकेशन रिलीज़ करें. अपने सोर्स कोड को अस्पष्ट बनाने के अलावा, छोटा करके ऐसी किसी भी लाइब्रेरी से इस्तेमाल न हुई क्लास हटा देता है जिसे आपने अपने ऐप्लिकेशन में शामिल किया है. इससे ऐप्लिकेशन के डाउनलोड साइज़ को जितना हो सके उतना कम रखें.

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 या उसके बाद का होना चाहिए.