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

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

Android Gradle प्लग इन 9.0

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

Android Gradle प्लग इन 9.0.0-alpha04 पर अपडेट करने के लिए, Android Studio Narwhal 4 Feature Drop | 2025.1.4 में Android Gradle प्लग इन अपग्रेड असिस्टेंट का इस्तेमाल करें.

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

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

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

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

इंटरनल डीएसएल लागू करने और बंद किए गए वैरिएंट एपीआई के लिए, अब साफ़ तौर पर ऑप्ट इन करना ज़रूरी है

Android Gradle प्लगिन में अब एक तय एपीआई सर्फ़ेस है. इसमें काम करने वाले एपीआई, com.android.tools.build:gradle-api maven आर्टफ़ैक्ट में तय किए गए हैं.

मौजूदा बाइनरी प्लगिन और बिल्ड स्क्रिप्ट के साथ काम करने के लिए, एपीआई की तय की गई सतह से पहले के डीएसएल को AGP 8.13 और इससे पहले के वर्शन में डिफ़ॉल्ट रूप से दिखाया जाता था. इससे Gradle प्लगिन और बिल्ड स्क्रिप्ट में मौजूद कोड, डीएसएल की इंटरनल इंप्लीमेंटेशन की जानकारी के साथ-साथ, बंद किए गए android.applicationVariants, android.libraryVariants, android.testVariants, और android.unitTestVariants एपीआई को भी ऐक्सेस कर सकता है. इन एपीआई को AGP 10 में 2026 में हटा दिया जाएगा.

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

हटाए गए एपीआई का इस्तेमाल करने के लिए, gradle.properties में android.newDsl=false सेट करके, फिर से ऑप्ट-इन किया जा सकता है.

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

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

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

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

android.builtInKotlin=false को सेट करके, 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 {
    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, क्योंकि यह काम नहीं कर रहा था.

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

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

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

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

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

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

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

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

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

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

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

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

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

android {
  buildFeatures {
    aidl = true
  }
}

android {
  buildFeatures {
    renderScript = true
  }
}

हटाए गए एपीआई

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

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

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

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

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