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

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

Android Gradle प्लगिन 9.0

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

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

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

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

Android Gradle प्लगिन 9.0.0-alpha10, Android के एपीआई लेवल 36 तक के वर्शन के साथ काम करता है.

Android Gradle प्लग इन 9.0.0-alpha10 के लिए, 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 प्लग इन को बदला जा सकता है. इससे AGP के साथ इंटिग्रेशन आसान हो जाता है. साथ ही, बंद हो चुके एपीआई का इस्तेमाल करने से बचा जा सकता है और कुछ मामलों में परफ़ॉर्मेंस को बेहतर बनाया जा सकता है.

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

AGP 9.0 में Kotlin पहले से मौजूद होने की वजह से, Android Studio IDE में test-fixtures के लिए पूरी तरह से सहायता मिलती है. इस सुविधा को आज़माने के लिए, AGP 9.0.0-alpha07 या उसके बाद का वर्शन इस्तेमाल करें.

android.builtInKotlin=false को सेट करके, Kotlin में पहले से मौजूद सुविधाओं से ऑप्ट आउट किया जा सकता है.

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

buildscript {
    dependencies {
        classpath("org.jetbrains.kotlin:kotlin-gradle-plugin") {
            version { strictly("2.0.0") } // or another version that you want to use
        }
    }
}

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

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