Android Gradle प्लगिन के बारे में जानकारी

Android Studio का बिल्ड सिस्टम, Gradle पर आधारित है. साथ ही, Android Gradle प्लगिन में कई ऐसी सुविधाएं जोड़ी गई हैं जो खास तौर पर Android ऐप्लिकेशन बनाने के लिए हैं.

इस पेज पर, Gradle टूल को अप-टू-डेट रखने का तरीका बताया गया है. Android Gradle प्लगिन के रिलीज़ नोट के लिए, रिलीज़ नोट पेज देखें.

Android Gradle प्लगिन में होने वाले नुकसान पहुंचा सकने वाले बदलावों की खास जानकारी पाने के लिए, Android Gradle प्लगिन का रोडमैप देखें.

Gradle की मदद से Android बिल्ड को कॉन्फ़िगर करने के तरीके के बारे में ज़्यादा जानने के लिए, ये पेज देखें:

• अपना बिल्ड कॉन्फ़िगर करना
• Android Gradle प्लगिन डीएसएल रेफ़रंस
• Gradle डीएसएल रेफ़रंस
• Gradle की परफ़ॉर्मेंस के बारे में इस्तेमाल के लिए गाइड

Gradle बिल्ड सिस्टम के बारे में ज़्यादा जानने के लिए, Gradle इस्तेमाल करने के लिए गाइड देखें.

android skills add agp-9-upgrade

Android Gradle प्लगिन को अपडेट करना

Android Studio को अपडेट करने पर, आपको Android Gradle प्लगिन को उपलब्ध सबसे नए वर्शन पर अपने-आप अपडेट करने का प्रॉम्प्ट मिल सकता है. आपके पास अपडेट को स्वीकार करने या अपने प्रोजेक्ट की बिल्ड से जुड़ी ज़रूरी शर्तों के आधार पर, मैन्युअल तरीके से कोई वर्शन तय करने का विकल्प होता है.

प्लगिन का वर्शन, Android Studio में File > Project Structure > Project मेन्यू या टॉप-लेवल की build.gradle.kts फ़ाइल में बताया जा सकता है. प्लगिन का वर्शन, उस Android Studio प्रोजेक्ट में बनाए गए सभी मॉड्यूल पर लागू होता है. यहां दिए गए उदाहरण में, build.gradle.kts फ़ाइल से प्लगिन को 9.4.0 वर्शन पर सेट किया गया है:

plugins {
    id("com.android.application") version "9.4.0" apply false
    id("com.android.library") version "9.4.0" apply false
    id("org.jetbrains.kotlin.android") version "2.4.10" apply false
}

plugins {
    id 'com.android.application' version '9.4.0' apply false
    id 'com.android.library' version '9.4.0' apply false
    id 'org.jetbrains.kotlin.android' version '2.4.10' apply false
}

चेतावनी: आपको वर्शन नंबर में डाइनैमिक डिपेंडेंसी का इस्तेमाल नहीं करना चाहिए, जैसे कि 'com.android.tools.build:gradle:9.4.+'. इस सुविधा का इस्तेमाल करने से, वर्शन के अनचाहे अपडेट हो सकते हैं. साथ ही, वर्शन के बीच के अंतर को ठीक करने में समस्या आ सकती है.

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

Gradle को अपडेट करना

Android Studio को अपडेट करने पर, आपको Gradle को भी उपलब्ध नए वर्शन पर अपडेट करने का प्र��म्प्ट मिल सकता है. आपके पास अपडेट को स्वीकार करने या अपने प्रोजेक्ट की बिल्ड से जुड़ी ज़रूरी शर्तों के आधार पर, मैन्युअल तरीके से कोई वर्शन तय करने का विकल्प होता है.

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

Gradle का वर्शन तय करने के लिए, Android Studio में File > Project Structure > Project मेन्यू पर जाएं. इसके अलावा, कमांड लाइन का इस्तेमाल करके भी Gradle का वर्शन अपडेट किया जा सकता है. सबसे सही तरीका है कि Gradle Wrapper कमांड लाइन टूल का इस्तेमाल किया जाए. यह टूल, gradlew स्क्रिप्ट को अपडेट करता है. यहां दिए गए उदाहरण में, Gradle रैपर का इस्तेमाल करके Gradle वर्शन को 9.6.0 पर सेट किया गया है. ध्यान दें, Gradle और Gradle रैपर, दोनों को अपग्रेड करने के लिए, आपको यह निर्देश दो बार चलाना होगा. ज़्यादा जानकारी के लिए, Gradle रैपर को अपग्रेड करना लेख पढ़ें.

gradle wrapper --gradle-version 9.6.0

हालांकि, कुछ मामलों में ऐसा नहीं हो पाता. उदाहरण के लिए, अगर आपने अभी-अभी एजीपी को अपडेट किया है और वह Gradle के मौजूदा वर्शन के साथ काम नहीं करता है. इस मामले में, आपको gradle/wrapper/gradle-wrapper.properties फ़ाइल में Gradle डिस्ट्रिब्यूशन रेफ़रंस म���ं बदलाव करना होगा. यहां दिए गए उदाहरण में, gradle-wrapper.properties फ़ाइल में Gradle वर्शन को 9.6.0 पर सेट किया गया है.

...
distributionUrl = https\://services.gradle.org/distributions/gradle-9.6.0-bin.zip
...

Android Gradle प्लगिन और Android Studio के साथ काम करने की सुविधा

Android Studio का बिल्ड सिस्टम, Gradle पर आधारित है. साथ ही, Android Gradle प्लगिन (एजीपी) में ऐसी कई सुविधाएं जोड़ी गई हैं जो खास तौर पर Android ऐप्लिकेशन बनाने के लिए हैं. यहां दी गई टेबल में बताया गया है कि Android Studio के हर वर्शन के लिए, AGP के किस वर्शन की ज़रूरत होती है.

Android Gradle प्लगिन में नया क्या है, इस बारे में जानने के लिए, Android Gradle प्लगिन की रिलीज़ से जुड़ी जानकारी देखें.

Android एपीआई लेवल के लिए, टूल के कम से कम वर्शन

Android Studio और एजीपी के कुछ ऐसे वर्शन हैं जो किसी खास एपीआई लेवल के साथ काम करते हैं. अपने प्रोजेक्ट के targetSdk या compileSdk के लिए ज़रूरी वर्शन से पुराने Android Studio या एजीपी वर्शन का इस्तेमाल करने पर, आपको अनचाही समस्याएं आ सकती हैं. हमारा सुझाव है कि Android OS के प्रीव्यू वर्शन को टारगेट करने वाले प्रोजेक्ट पर काम करने के लिए, Android Studio और AGP के सबसे नए प्रीव्यू वर्शन का इस्तेमाल करें. Android Studio के स्टेबल वर्शन के साथ-साथ, इसके वर्शन की झलक भी इंस्टॉल की जा सकती है.

Android Studio और एजीपी के लिए, कम से कम ये वर्शन होने चाहिए: