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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

gradle wrapper --gradle-version 9.4.1

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

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

Android Gradle प्लगिन और Android Studio की कंपैटिबिलिटी

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

Android Gradle प्लगिन में नई सुविधाओं के बारे में जानने के लिए, Android Gradle प्लगिन की रिलीज़ से जुड़ी जानकारी देखें.

Android API लेवल के लिए टूल के ज़रूरी सबसे पुराने वर्शन

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

Android Studio और AGP के सबसे पुराने वर्शन यहां दिए गए हैं: