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

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

Android Gradle प्लगिन 9.0

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

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

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

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

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

Android Gradle प्लग इन 9.0.0-rc02 के लिए, 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 पर स्विच करें: com.android.library और com.android.application प्लगिन के साथ-साथ, org.jetbrains.kotlin.multiplatform प्लगिन का इस्तेमाल करना नए डीएसएल के साथ काम नहीं करता.

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

• अपने कस्टम बिल्ड लॉजिक को अपडेट करके, नए डीएसएल और एपीआई का रेफ़रंस दें: इंटरनल डीएसएल के सभी रेफ़रंस को, सार्वजनिक डीएसएल इंटरफ़ेस से बदलें. ज़्यादातर मामलों में, यह एक-से-एक रिप्लेसमेंट होगा. 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 पर माइग्रेट करना या ऑप्ट आउट करना होगा.

आपके पास उन Gradle सबप्रोजेक्ट के लिए, Kotlin के साथ काम करने की सुविधा को चुनिंदा तौर पर बंद करने का विकल्प भी है जिनमें Kotlin सोर्स नहीं हैं.

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

Kotlin को पहले से मौजूद सहायता देने के लिए, Android Gradle प्लग इन 9.0 में अब Kotlin Gradle प्लग इन (KGP) 2.2.10 पर रनटाइम डिपेंडेंसी है. इसका मतलब है कि अब आपको KGP वर्शन के बारे में जानकारी नहीं देनी होगी. साथ ही, अगर KGP के 2.2.10 से कम वर्शन का इस्तेमाल किया जाता है, तो Gradle आपके KGP वर्शन को अपने-आप 2.2.10 पर अपग्रेड कर देगा. इसी तरह, अगर KSP का इस्तेमाल किया जा रहा है और उसका वर्शन 2.2.10-2.0.2 से कम है, तो AGP उसे KGP के वर्शन से मैच करने के लिए 2.2.10-2.0.2 पर अपग्रेड कर देगा.

KGP के नए वर्शन पर अपग्रेड करना

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

buildscript {
    dependencies {
        // For KGP
        classpath("org.jetbrains.kotlin:kotlin-gradle-plugin:KGP_VERSION")

        // For KSP
        classpath("com.google.devtoolsksp:symbol-processing-gradle-plugin:KSP_VERSION")
    }
}

KGP के पुराने वर्शन पर डाउनग्रेड करना

KGP के वर्शन को सिर्फ़ तब डाउनग्रेड किया जा सकता है, जब आपने बिल्ट-इन Kotlin से ऑप्ट आउट किया हो. ऐसा इसलिए है, क्योंकि AGP 9.0 में Kotlin को डिफ़ॉल्ट रूप से चालू किया जाता है. साथ ही, Kotlin के लिए KGP 2.2.10 या इसके बाद के वर्शन की ज़रूरत होती है.

KGP या KSP के पुराने वर्शन का इस्तेमाल करने के लिए, टॉप-लेवल की अपनी बिल्ड फ़ाइल में उस वर्शन की जानकारी दें. इसके लिए, स्ट्रिक्ट वर्शन का एलान करें:

buildscript {
    dependencies {
        // For KGP
        classpath("org.jetbrains.kotlin:kotlin-gradle-plugin") {
            version { strictly("KGP_VERSION") }
        }

        // For KSP
        classpath("com.google.devtoolsksp:symbol-processing-gradle-plugin") {
            version { strictly("KSP_VERSION") }
        }
    }
}

ध्यान दें कि KGP के 2.0.0 वर्शन पर डाउनग्रेड किया जा सकता है.

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

AGP 9.0 में, Android Studio IDE के साथ टेस्ट फ़िक्चर का इस्तेमाल किया जा सकता है.

Fused Library Plugin

फ़्यूज़्ड लाइब्रेरी प्लगिन (प्रीव्यू) की मदद से, एक से ज़्यादा लाइब्रेरी को एक Android लाइब्रेरी एएआर के तौर पर पब्लिश किया जा सकता है. इससे आपके उपयोगकर्ताओं के लिए, पब्लिश किए गए आर्टफ़ैक्ट पर भरोसा करना आसान हो सकता है.

शुरू करने के बारे में जानकारी के लिए, फ़्यूज़्ड लाइब्रेरी की मदद से, एक से ज़्यादा Android लाइब्रेरी को एक के तौर पर पब्लिश करना लेख पढ़ें.

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

Android Gradle प्लग इन 9.0 में ये नए बदलाव किए गए हैं:

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

android {
  defaultConfig {
    testInstrumentationRunner = "..."
  }
}

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 की रिपोर्ट करने का टास्क
• डेंसिटी के हिसाब से स्प्लिट किए गए APK के लिए सहायता
  AGP 9.0 में, स्क्रीन डेंसिटी के हिसाब से स्प्लिट किए गए APK बनाने की सुविधा हटा दी गई है. इस सुविधा और इससे जुड़े एपीआई को हटा दिया गया है. AGP 9.0 या उसके बाद के वर्शन का इस्तेमाल करके, स्क्रीन डेंसिटी के आधार पर APK को स्प्लिट करने के लिए, ऐप्लिकेशन बंडल का इस्तेमाल करें.

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

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

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

  यह बदलाव सिर्फ़ सोर्स लेवल पर किया गया है, ताकि आने वाले समय में सोर्स लेवल पर होने वाले बदलावों से बचा जा सके. हालांकि, इसका यह भी मतलब है कि ब्लॉक करने के तरीकों को CommonExtension से ApplicationExtension, LibraryExtension, 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 झटपट के लिए काम का था. हालांकि, अब यह सुविधा काम नहीं करती.

• DensitySplit, क्योंकि यह सुविधा अब काम नहीं करती है. ऐप्लिकेशन बंडल का इस्तेमाल करें.

हटाए गए एपीआई

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-rc02

Android Gradle प्लगिन 9.0.0-rc01

Android Gradle प्लगिन 9.0.0-beta05

Android Gradle प्लगिन 9.0.0-beta04

Android Gradle प्लगिन 9.0.0-beta03

Android Gradle प्लगिन 9.0.0-beta02

Android Gradle प्लगिन 9.0.0-beta01

Android Gradle प्लग इन 9.0.0-alpha14

Android Gradle प्लगिन 9.0.0-alpha13

Android Gradle प्लगिन 9.0.0-alpha12

Android Gradle प्लगिन 9.0.0-alpha11

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