Android Gradle प्लग इन की झलक के बारे में जानकारी वाला दस्तावेज़

इस पेज पर, Android Gradle प्लगिन (एजीपी) की प्रीव्यू रिलीज़ के लिए रिलीज़ नोट दिए गए हैं.

Android Gradle प्लगिन 9.0

Android Gradle प्लग इन 9.0, AGP का नया मेजर वर्शन है. इसमें एपीआई और व्यवहार से जुड़े बदलाव किए गए हैं.

Android Gradle प्लग इन 9.0.0-alpha11 पर अपडेट करने के लिए, Android Studio Otter 2 Feature Drop | 2025.2.2 में Android Gradle प्लग इन अपग्रेड असिस्टेंट का इस्तेमाल करें.

AGP अपग्रेड असिस्टेंट, आपके प्रोजेक्ट को अपग्रेड करते समय मौजूदा व्यवहारों को बनाए रखने में मदद करता है. इससे आपको AGP 9.0 का इस्तेमाल करने के लिए, अपने प्रोजेक्ट को अपग्रेड करने की सुविधा मिलती है. भले ही, आप AGP 9.0 में सभी नए डिफ़ॉल्ट सेटिंग को अपनाने के लिए तैयार न हों.

इनके साथ काम करता है

Android Gradle प्लग इन 9.0.0-alpha11, ज़्यादा से ज़्यादा Android API लेवल 36 के साथ काम करता है.

Android Gradle प्लग इन 9.0.0-alpha11 के लिए, Gradle 9.0.0 की ज़रूरत होती है.

android डीएसएल क्लास अब सिर्फ़ नए सार्वजनिक इंटरफ़ेस लागू करती हैं

पिछले कुछ सालों में, हमने अपने डीएसएल और एपीआई के लिए नए इंटरफ़ेस लॉन्च किए हैं. इससे यह बेहतर तरीके से कंट्रोल किया जा सकता है कि कौनसे एपीआई सार्वजनिक हैं. AGP के 7.x और 8.x वर्शन में अब भी पुराने डीएसएल टाइप (उदाहरण के लिए, BaseExtension) का इस्तेमाल किया जाता है. इनमें नए सार्वजनिक इंटरफ़ेस भी लागू किए गए हैं, ताकि इंटरफ़ेस पर काम जारी रहने के दौरान भी कंपैटिबिलिटी बनी रहे.

AGP 9.0 में, सिर्फ़ हमारे नए डीएसएल इंटरफ़ेस का इस्तेमाल किया जाता है. साथ ही, लागू करने के तरीके को नए टाइप में बदल दिया गया है, जो पूरी तरह से छिपे हुए हैं. इससे, काम न करने वाले पुराने वैरिएंट एपीआई का ऐक्सेस भी हट जाता है.

AGP 9.0 पर अपडेट करने के लिए, आपको ये काम करने पड़ सकते हैं:

• पक्का करें कि आपका प्रोजेक्ट, पहले से मौजूद Kotlin के साथ काम करता हो: org.jetbrains.kotlin.android प्लगिन, नए डीएसएल के साथ काम नहीं करता.

• KMP प्रोजेक्ट को Android Gradle Library Plugin for KMP पर स्विच करें: org.jetbrains.kotlin.multiplatform प्लगिन का इस्तेमाल, com.android.library और com.android.application प्लगिन के साथ एक ही Gradle सबप्रोजेक्ट में नहीं किया जा सकता. यह नए डीएसएल के साथ काम नहीं करता.

• अपनी बिल्ड फ़ाइलें अपडेट करें: इंटरफ़ेस में बदलाव करने का मकसद, डीएसएल को ज़्यादा से ज़्यादा एक जैसा रखना है. हालांकि, इसमें कुछ छोटे बदलाव हो सकते हैं.

• अपने कस्टम बिल्ड लॉजिक को अपडेट करके, नए डीएसएल और एपीआई का रेफ़रंस दें: इंटरनल डीएसएल के सभी रेफ़रंस को, सार्वजनिक डीएसएल इंटरफ़ेस से बदलें. ज़्यादातर मामलों में, यह एक-से-एक रिप्लेसमेंट होगा. applicationVariants और इसी तरह के अन्य एपीआई की जगह, नए androidComponents एपीआई का इस्तेमाल करें. यह प्रोसेस ज़्यादा मुश्किल हो सकती है, क्योंकि androidComponents API को ज़्यादा स्थिर बनाने के लिए डिज़ाइन किया गया है, ताकि प्लगिन लंबे समय तक काम कर सकें. उदाहरणों के लिए, हमारे Gradle Recipes देखें.

• तीसरे पक्ष के प्लगिन अपडेट करें: ऐसा हो सकता है कि तीसरे पक्ष के कुछ प्लगिन अब भी उन इंटरफ़ेस या एपीआई पर निर्भर हों जो अब उपलब्ध नहीं हैं. उन प्लगिन के ऐसे वर्शन पर माइग्रेट करें जो AGP 9.0 के साथ काम करते हैं.

नए डीएसएल इंटरफ़ेस पर स्विच करने से, प्लगिन और Gradle बिल्ड स्क्रिप्ट को इन एपीआई का इस्तेमाल करने से रोका जा सकता है:

androidComponents {
    onVariants() { variant ->
        variant.signingConfig
            .enableV1Signing.set(false)
    }
}

androidComponents {
    beforeVariants(
        selector()
            .withBuildType("debug")
            .withFlavor("color", "blue")
    ) { variantBuilder ->
        variantBuilder.enable = false
    }
  }

अगर आपने AGP 9.0 पर अपडेट किया है और आपको गड़बड़ी का यह मैसेज दिखता है, तो इसका मतलब है कि आपका प्रोजेक्ट अब भी कुछ पुराने टाइप के रेफ़रंस दे रहा है:

java.lang.ClassCastException: class com.android.build.gradle.internal.dsl.ApplicationExtensionImpl$AgpDecorated_Decorated
cannot be cast to class com.android.build.gradle.BaseExtension

अगर तीसरे पक्ष के ऐसे प्लगिन की वजह से आपको ब्लॉक किया गया है जो काम नहीं करते हैं, तो आपके पास ऑप्ट आउट करने का विकल्प होता है. ऐसा करने पर, आपको डीएसएल के साथ-साथ पुराने वैरिएंट एपीआई के लिए, पुराने तरीके से लागू किए गए कोड वापस मिल जाएंगे. ऐसा करते समय, नए इंटरफ़ेस भी उपलब्ध होते हैं. साथ ही, आपके पास अब भी अपने बिल्ड लॉजिक को नए एपीआई में अपडेट करने का विकल्प होता है. ऑप्ट आउट करने के लिए, अपनी gradle.properties फ़ाइल में यह लाइन शामिल करें:

android.newDsl=false

AGP 9.0 पर अपग्रेड करने से पहले, नए एपीआई पर अपग्रेड किया जा सकता है. नए इंटरफ़ेस, AGP के कई वर्शन में मौजूद हैं. इसलिए, आपके पास नए और पुराने इंटरफ़ेस का मिक्सचर हो सकता है. AGP API के रेफ़रंस दस्तावेज़ों में, AGP के हर वर्शन के लिए एपीआई सर्फ़ेस दिखाया गया है. साथ ही, यह भी बताया गया है कि हर क्लास, तरीके, और फ़ील्ड को कब जोड़ा गया था.

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

अगर आपको लगता है कि नए डीएसएल या वैरिएंट एपीआई में कुछ सुविधाएं या फ़ंक्शन मौजूद नहीं हैं, तो कृपया जल्द से जल्द समस्या की शिकायत करें.

Kotlin में पहले से मौजूद

Android Gradle प्लग इन 9.0 में, Kotlin के लिए पहले से मौजूद सहायता की सुविधा जोड़ी गई है. साथ ही, इसे डिफ़ॉल्ट रूप से चालू किया गया है. इसका मतलब है कि अब आपको Kotlin सोर्स फ़ाइलों को कंपाइल करने के लिए, अपनी बिल्ड फ़ाइलों में org.jetbrains.kotlin.android (या kotlin-android) प्लगिन लागू करने की ज़रूरत नहीं है. इससे AGP के साथ Kotlin को इंटिग्रेट करना आसान हो जाता है. साथ ही, इससे बंद किए गए एपीआई का इस्तेमाल नहीं करना पड़ता और कुछ मामलों में परफ़ॉर्मेंस बेहतर होती है.

इसलिए, जब अपने प्रोजेक्ट को AGP 9.0 पर अपग्रेड किया जाता है, तब आपको बिल्ट-इन Kotlin पर माइग्रेट करना या ऑप्ट आउट करना होगा.

Kotlin Gradle प्लगिन 2.2.10 पर रनटाइम डिपेंडेंसी

Android Gradle प्लग इन 9.0 को Kotlin Gradle प्लग इन (KGP) 2.2.10 की ज़रूरत होती है. यह Kotlin के साथ काम करने वाले बिल्ट-इन टूल के लिए ज़रूरी कम से कम वर्शन है.

इसका मतलब है कि अगर आपने Kotlin के बिल्ट-इन वर्शन का इस्तेमाल नहीं किया है और KGP का 2.2.10 से कम वर्शन इस्तेमाल किया है, तो Gradle, KGP के वर्शन को अपने-आप 2.2.10 पर अपग्रेड कर देगा.

इसी तरह, अगर KSP का इस्तेमाल किया जा रहा है और उसका वर्शन 2.2.10-2.0.2 से कम है, तो AGP, KSP के वर्शन को 2.2.10-2.0.2 पर अपग्रेड कर देगा, ताकि वह KGP के वर्शन से मैच हो सके.

इसलिए, अगर आपको Kotlin के बिल्ट-इन वर्शन का इस्तेमाल नहीं करना है और KGP या KSP के पुराने वर्शन का इस्तेमाल करना है, तो आपको टॉप-लेवल की बिल्ड फ़ाइल में यह कोड जोड़ना होगा:

buildscript {
    dependencies {
        classpath("org.jetbrains.kotlin:kotlin-gradle-plugin") {
            version { strictly("KGP_VERSION") }
        }
        classpath("com.google.devtoolsksp:symbol-processing-gradle-plugin") {
            version { strictly("KSP_VERSION") }
        }
    }
}

टेस्ट फ़िक्चर के लिए IDE की सुविधा

AGP 9.0 में, Android Studio IDE के लिए टेस्ट फ़िक्चर की सुविधा पूरी तरह से उपलब्ध है. इस सुविधा का इस्तेमाल करने के लिए, AGP 9.0.0-alpha07 या इसके बाद के वर्शन का इस्तेमाल करें.

व्यवहार में बदलाव

Android Gradle प्लग इन 9.0 में ये नई सुविधाएं जोड़ी गई हैं:

AGP 9.0 में, Gradle की इन प्रॉपर्टी की डिफ़ॉल्ट वैल्यू अपडेट की गई हैं. इससे आपको अपग्रेड करते समय, AGP 8.13 के व्यवहार को बनाए रखने का विकल्प मिलता है:

android {
  buildFeatures {
    resValues = true
  }
}

android {
  buildFeatures {
    shaders = true
  }
}

हटाई गई सुविधाएं

Android Gradle प्लग इन 9.0 में, ये सुविधाएं हटा दी गई हैं:

• Wear OS ऐप्लिकेशन को एम्बेड करने की सुविधा
  AGP 9.0 में, Wear OS ऐप्लिकेशन को एम्बेड करने की सुविधा हटा दी गई है. यह सुविधा अब Play में काम नहीं करती. इसमें wearApp कॉन्फ़िगरेशन और AndroidSourceSet.wearAppConfigurationName डीएसएल को हटाना शामिल है. Wear OS पर अपना ऐप्लिकेशन पब्लिश करने का तरीका जानने के लिए, Wear OS पर ऐप्लिकेशन उपलब्ध कराना लेख पढ़ें.
• androidDependencies और sourceSets रिपोर्ट टास्क

बदला गया डीएसएल

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

• CommonExtension के पैरामीटर को हटा दिया गया है.

  यह बदलाव सिर्फ़ सोर्स लेवल पर किया गया है, ताकि आने वाले समय में सोर्स लेवल पर होने वाले बदलावों से बचा जा सके. हालांकि, इसका यह भी मतलब है कि ब्लॉक करने के तरीकों को CommonExtension से ApplicationExtension, LibraryExension, DynamicFeatureExtension, और TestExtension पर ले जाना होगा.

  अपने प्रोजेक्ट को AGP 9.0 पर अपग्रेड करते समय, Gradle प्लगिन कोड को फिर से फ़ैक्टर करें. यह कोड, उन पैरामीटर या ब्लॉक के तरीकों का इस्तेमाल करता है. उदाहरण के लिए, टाइप पैरामीटर को हटाने के लिए इस प्लगिन को अपडेट किया गया है. साथ ही, अब यह हटाए गए ब्लॉक के तरीकों पर निर्भर नहीं करता:

  AGP 8.13

  val commonExtension: CommonExtension<*, *, *, *, *, *> =
          extensions.getByType(CommonExtension::class)
  commonExtension.apply {
      defaultConfig {
          minSdk {
              version = release(28)
          }
      }
  }
  

  AGP 9.0

  val commonExtension: CommonExtension =
          extensions.getByType(CommonExtension::class)
  commonExtension.apply {
      defaultConfig.apply {
          minSdk {
              version = release(28)
          }
      }
  }
  

  AGP के अलग-अलग वर्शन को टारगेट करने वाले प्लगिन के लिए, सीधे तौर पर getter का इस्तेमाल करना, AGP के 9.0 से पहले के वर्शन के साथ बाइनरी के तौर पर काम करता है.

डीएसएल हटाया गया

Android Gradle प्लग इन 9.0 में ये सुविधाएं हटा दी गई हैं:

• AndroidSourceSet.jni, क्योंकि यह काम नहीं कर रहा था.

• AndroidSourceSet.wearAppConfigurationName, क्योंकि यह Wear OS ऐप्लिकेशन के लिए एम्बेड की गई सुविधा को हटाने से जुड़ा है.

• BuildType.isRenderscriptDebuggable, क्योंकि यह काम नहीं कर रहा था.

• DependencyVariantSelection. इसे DependencySelection से बदल दिया गया है. इसे kotlin.android.localDependencySelection के तौर पर दिखाया जाता है

• Installation.installOptions(String). इसे Installation.installOptions की बदली जा सकने वाली प्रॉपर्टी से बदल दिया गया है.

• एक्सपेरिमेंट के तौर पर उपलब्ध, लेकिन कभी भी स्थिर नहीं होने वाला PostProcessing ब्लॉक.

• ProductFlavor.setDimension, जिसे dimension प्रॉपर्टी से बदल दिया गया है

• LanguageSplitOptions, जो सिर्फ़ Google Play झटपट के लिए काम का था. हालांकि, अब यह काम नहीं करता.

हटाए गए एपीआई

Android Gradle प्लग इन 9.0 में ये सुविधाएं हटा दी गई हैं:

• AndroidComponentsExtension.finalizeDSl. इसे finalizeDsl से बदल दिया गया है

• Component.transformClassesWith. इसे Instrumentation.transformClassesWith से बदल दिया गया है

• Component.setAsmFramesComputationMode. इसे Instrumentation.setAsmFramesComputationMode से बदल दिया गया है

• ComponentBuilder.enabled. इसकी जगह ComponentBuilder.enable ने ले ली है.

• DependenciesInfoBuilder.includedInApk. इसे includeInApk से बदल दिया गया है

• DependenciesInfoBuilder.includedInBundle. इसे includeInBundle से बदल दिया गया है

• GeneratesApk.targetSdkVersion. इसे targetSdk से बदल दिया गया है

• Variant.minSdkVersion. इसे minSdk से बदल दिया गया है

• Variant.maxSdkVersion. इसे maxSdk से बदल दिया गया है

• Variant.targetSdkVersion. इसे targetSdk से बदल दिया गया है

• Variant.unitTest, क्योंकि यह com.android.test प्लगिन पर लागू नहीं होता था. unitTest, VariantBuilder के सबटाइप पर उपलब्ध है. यह HasUnitTest तक उपलब्ध है.

• VariantBuilder.targetSdk और targetSdkPreview, क्योंकि ये लाइब्रेरी में काम के नहीं थे. इसके बजाय, GeneratesApkBuilder.targetSdk या GeneratesApkBuilder.targetSdkPreview का इस्तेमाल करें.

• VariantBuilder.enableUnitTest, क्योंकि यह com.android.test प्लगिन पर लागू नहीं होता था. enableUnitTest, VariantBuilder के सबटाइप पर उपलब्ध है. यह HasUnitTestBuilder तक उपलब्ध है.

• VariantBuilder के HasUnitTestBuilder एक्सटेंड करने वाले सबटाइप पर, VariantBuilder.unitTestEnabled को हटा दिया गया है. इसकी जगह, enableUnitTest का इस्तेमाल किया जाएगा.

• VariantOutput.enable. इसे enabled से बदल दिया गया है

• FeaturePlugin और FeatureExtension के इस्तेमाल पर रोक लगा दी गई है और इन्हें बंद कर दिया गया है.

• बंद किए गए और बंद किए गए BaseExtension.registerTransform एपीआई. इनका इस्तेमाल सिर्फ़ इसलिए किया जाता था, ताकि AGP 4.2 या इससे पहले के वर्शन पर चलने वाले ऐप्लिकेशन को टारगेट करते समय, उन्हें AGP के सबसे नए वर्शन के साथ कंपाइल किया जा सके.

हटाई गई Gradle प्रॉपर्टी

शुरुआत में, इन Gradle प्रॉपर्टी को डिफ़ॉल्ट रूप से चालू की गई सुविधाओं को ग्लोबल लेवल पर बंद करने के तरीकों के तौर पर जोड़ा गया था.

AGP 8.0 या इससे पहले के वर्शन में, ये सुविधाएं डिफ़ॉल्ट रूप से बंद कर दी गई हैं. इन सुविधाओं को सिर्फ़ उन उप-प्रोजेक्ट में चालू करें जिनमें इनका इस्तेमाल किया जाता है, ताकि ज़्यादा असरदार तरीके से बनाया जा सके.

android {
  buildFeatures {
    aidl = true
  }
}

android {
  buildFeatures {
    renderScript = true
  }
}

लागू की गई Gradle प्रॉपर्टी

अगर आपने Gradle की इन प्रॉपर्टी को सेट किया है, तो AGP 9.0 में गड़बड़ी होगी.

Android Gradle प्लगिन अपग्रेड असिस्टेंट, इन प्रॉपर्टी का इस्तेमाल करने वाले प्रोजेक्ट को AGP 9.0 पर अपग्रेड नहीं करेगी.

ठीक की गई समस्याएं

Android Gradle प्लगिन 9.0.0-alpha10

Android Gradle प्लगिन 9.0.0-alpha09

Android Gradle प्लगिन 9.0.0-alpha08

Android Gradle प्लगिन 9.0.0-alpha07

Android Gradle प्लगिन 9.0.0-alpha06

Android Gradle प्लगिन 9.0.0-alpha05

Android Gradle प्लगिन 9.0.0-alpha04

Android Gradle प्लग इन 9.0.0-alpha03

Android Gradle प्लग-इन 9.0.0-alpha02

Android Gradle प्लगिन 9.0.0-alpha01