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

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

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

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

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

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

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

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

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

Kotlin

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
}

Groovy

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.+'. इस सुविधा का इस्तेमाल करने से, वर्शन में अचानक अपडेट हो सकते हैं. साथ ही, वर्शन में अंतर को ठीक करने में मुश्किल आ सकती है.

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

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

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

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

प्लगिन का वर्शनGradle का कम से कम ज़रूरी वर्शन
9.49.6.0
9.39.5.0
9.29.4.1
9.19.3.1
9.09.1.0
8.138.13
8.128.13
8.118.13
8.108.11.1
8.98.11.1
8.88.10.2
8.78.9
8.68.7
8.58.7
8.48.6
8.38.4
8.28.2
8.18.0
8.08.0

पुराने संस्करण

प्लगिन का वर्शनGradle का ज़रूरी वर्शन
7.47.5
7.37.4
7.27.3.3
7.17.2
7.07.0
4.2.0+6.7.1
4.1.0+6.5+
4.0.0+6.1.1+
3.6.0 - 3.6.45.6.4+
3.5.0 - 3.5.45.4.1+
3.4.0 - 3.4.35.1.1+
3.3.0 - 3.3.34.10.1+
3.2.0 - 3.2.14.6+
3.1.0+4.4+
3.0.0+4.1+
2.3.0 या इसके बाद के वर्शन3.3+
2.1.3 - 2.2.32.14.1 - 3.5
2.0.0 - 2.1.22.10 - 2.13
1.5.02.2.1 - 2.13
1.2.0 - 1.3.12.2.1 - 2.9
1.0.0 - 1.1.32.2.1 - 2.3

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

gradle wrapper --gradle-version 9.6.0

हालांकि, कुछ मामलों में ऐसा नहीं हो सकता. उदाहरण के लिए, अगर आपने अभी-अभी AGP अपडेट किया है और वह 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 प्लगिन (AGP) कई ऐसी सुविधाएं जोड़ता है जो Android ऐप्लिकेशन बनाने के लिए खास तौर पर डिज़ाइन की गई हैं. यहां दी गई टेबल में बताया गया है कि Android Studio के हर वर्शन के लिए, AGP का कौनसा वर्शन ज़रूरी है.

Android Studio का वर्शन एजीपी का ज़रूरी वर्शन
Rabbit 1 | 2026.2.1 7.1-9.4
Quail 4 | 2026.1.4 7.1-9.4
Quail 3 | 2026.1.3 7.1-9.3
Quail 2 | 2026.1.2 7.1-9.3
Quail 1 | 2026.1.1 7.1-9.2
Panda 4 | 2025.3.4 7.1-9.2
Panda 3 | 2025.3.3 7.0-9.1
Panda 2 | 2025.3.2 7.0-9.1
Panda 1 | 2025.3.1 7.0-9.0
Otter 3 Feature Drop | 2025.2.3 4.2-9.0
Otter 2 Feature Drop | 2025.2.2 4.1-8.13
Otter | 2025.2.1 4.0-8.13
Narwhal 4 Feature Drop | 2025.1.4 4.0-8.13
Narwhal 3 Feature Drop | 2025.1.3 4.0-8.13
Narwhal Feature Drop | 2025.1.2 4.0-8.12
Narwhal | 2025.1.1 3.2-8.11
Meerkat की नई सुविधाओं वाला सॉफ़्टवेयर अपडेट | 2024.3.2 3.2-8.10
Meerkat | 2024.3.1 3.2-8.9

पुराने संस्करण

Android Studio का वर्शन एजीपी का ज़रूरी वर्शन
Ladybug Feature Drop | 2024.2.2 3.2-8.8
Ladybug | 2024.2.1 3.2-8.7
Koala Feature Drop | 2024.1.2 3.2-8.6
Koala | 2024.1.1 3.2-8.5
Jellyfish | 2023.3.1 3.2-8.4
इगुआना | 2023.2.1 3.2-8.3
Hedgehog | 2023.1.1 3.2-8.2
Giraffe | 2022.3.1 3.2-8.1
Flamingo | 2022.2.1 3.2-8.0
Electric Eel | 2022.1.1 3.2-7.4
Dolphin | 2021.3.1 3.2-7.3
Chipmunk | 2021.2.1 3.2-7.2
Bumblebee | 2021.1.1 3.2-7.1
Arctic Fox | 2020.3.1 3.1-7.0

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

Android API लेवल के लिए टूल के कम से कम वर्शन

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

Android Studio और AGP के कम से कम वर्शन ये होने चाहिए:

API स्तर Android Studio का कम से कम वर्शन एजीपी का सबसे पुराना वर्शन
37.0 Panda 3 | 2025.3.3 Patch 1 9.1.1
36.1 Narwhal 3 Feature Drop | 2025.1.3 8.13.0
36 Meerkat | 2024.3.1 Patch 1 8.9.1
35 Koala Feature Drop | 2024.2.1 8.6.0
34 Hedgehog | 2023.1.1 8.1.1
33 Flamingo | 2022.2.1 7.2