Android Gradle प्लगिन 9.0.1 (जनवरी 2026)

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

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

अपग्रेड करने की प्रोसेस को आसान बनाने के लिए, एजेंट के पास दो कौशल भी उपलब्ध हैं. अगर आपको KMP के अलावा किसी दूसरे ऐप्लिकेशन के लिए, AGP 9 को अपग्रेड करने का तरीका जानना है, तो Android skills repository पर जाएं. KMP ऐप्लिकेशन के लिए, JetBrains की AGP 9 अपग्रेड करने की सुविधा आज़माएं. Android Studio में स्किल इस्तेमाल करने के बारे में ज़्यादा जानने के लिए, स्किल की मदद से एजेंट मोड को बेहतर बनाना लेख पढ़ें.

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

Android Gradle प्लगिन 9.0, ज़्यादा से ज़्यादा एपीआई लेवल 36.1 के साथ काम करता है. Android Gradle प्लगिन 8.6 के साथ काम करने वाले टूल वर्शन से जुड़ी अन्य ज़रूरी जानकारी यहां देखें:

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

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

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

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

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

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

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

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

• तीसरे पक्ष के प्लगिन अपडेट करें: ऐसा हो सकता है कि तीसरे पक्ष के कुछ प्लगिन अब भी उन इंटरफ़ेस या एपीआई पर निर्भर हों जो अब उपलब्ध नहीं हैं. उन प्लगिन के ऐसे वर्शन पर माइग्रेट करें जो 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 में, पिछली क्लास को बंद की जा चुकी क्लास के तौर पर मार्क किया गया है. इसका मतलब है कि जिन प्रोजेक्ट ने newDsl फ़्लैग से ऑप्ट आउट किया है उन्हें बंद होने की चेतावनियां दिखेंगी. ये चेतावनियां, newDsl ब्लॉक पर भी दिखेंगी.android

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

हम सबसे ज़्यादा इस्तेमाल किए जाने वाले प्लगिन के लेखकों से संपर्क कर रहे हैं, ताकि वे नए मोड के साथ पूरी तरह से काम करने वाले प्लगिन को अडैप्ट और रिलीज़ कर सकें. साथ ही, हम 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 के नए वर्शन का इस्तेमाल करने के लिए, टॉप-लेवल की build फ़ाइल में यह जानकारी जोड़ें:

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

        // For KSP
        classpath("com.google.devtools.ksp: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.devtools.ksp:symbol-processing-gradle-plugin") {
            version { strictly("KSP_VERSION") }
        }
    }
}

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

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

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 DSL को हटाना शामिल है. अपने ऐप्लिकेशन को 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.unitTestEnabled को हटा दिया गया है. इसकी जगह, VariantBuilder सबटाइप पर enableUnitTest का इस्तेमाल किया जाएगा. enableUnitTest का नाम VariantBuilder.unitTestEnabled से ज़्यादा एक जैसा है. VariantBuilder सबटाइप, HasUnitTestBuilder के साथ काम करते हैं.

• 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 प्रॉपर्टी

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

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

R8 में हुए बदलाव

AGP 9.0.0 में, R8 से जुड़े ये बदलाव शामिल हैं.

कॉन्फ़िगरेशन का नया विकल्प -processkotlinnullchecks

हमने Kotlin में नल वैल्यू की जांच करने के लिए, R8 को कॉन्फ़िगर करने का नया विकल्प -processkotlinnullchecks जोड़ा है. इस विकल्प के लिए, एक ज़रूरी तर्क दिया जाता है. यह तर्क, इन तीन वैल्यू में से कोई एक होना चाहिए: keep, remove_message, और remove. यह विकल्प, Kotlin कंपाइलर की ओर से जोड़े गए इन नल चेक को प्रोसेस करता है:

class kotlin.jvm.internal.Intrinsics {
  void checkNotNull(java.lang.Object);
  void checkNotNull(java.lang.Object, java.lang.String);
  void checkExpressionValueIsNotNull(
      java.lang.Object, java.lang.String);
  void checkNotNullExpressionValue(
      java.lang.Object, java.lang.String);
  void checkReturnedValueIsNotNull(
      java.lang.Object, java.lang.String);
  void checkReturnedValueIsNotNull(
      java.lang.Object, java.lang.String, java.lang.String);
  void checkFieldIsNotNull(java.lang.Object, java.lang.String);
  void checkFieldIsNotNull(
      java.lang.Object, java.lang.String, java.lang.String);
  void checkParameterIsNotNull(java.lang.Object, java.lang.String);
  void checkNotNullParameter(java.lang.Object, java.lang.String);
}

विकल्पों की वैल्यू को सबसे कम से लेकर सबसे ज़्यादा तक के क्रम में लगाया गया है. इनका असर इस तरह पड़ता है:

• keep से जांचों में कोई बदलाव नहीं होता.
• remove_message, हर चेक मेथड कॉल को कॉल के पहले आर्ग्युमेंट पर getClass() के कॉल में बदलता है. इससे, शून्य की जांच को असरदार तरीके से बनाए रखा जाता है, लेकिन बिना किसी मैसेज के.
• remove से जांचें पूरी तरह हट जाती हैं.

डिफ़ॉल्ट रूप से R8, remove_message का इस्तेमाल करता है. -processkotlinnullchecks की कोई भी जानकारी, इसे ओवरराइड कर देगी. इस एट्रिब्यूट की वैल्यू एक से ज़्यादा बार सबमिट करने पर, सबसे सटीक वैल्यू का इस्तेमाल किया जाता है.

कंपैनियन तरीकों के लिए, जानकारी सेव करने की सुविधा को बंद करना

जब कीप नियम, इंटरफ़ेस के उन तरीकों से मेल खाते हैं जिन पर डिसुगरिंग लागू होती है, तो R8 पहले disallow optimization और disallow shrinking बिट को सिंथेसाइज़ किए गए कंपैनियन तरीकों में इंटरनल तौर पर ट्रांसफ़र करता था.

AGP 9.0 से, कंपैनियन तरीकों पर कीप के नियम लागू नहीं होते. यह इस बात से मेल खाता है कि कीप नियमों को कंपाइलर के बनाए गए अन्य फ़ील्ड/तरीकों/क्लास पर लागू नहीं किया जाता.

ऑप्टिमाइज़ेशन की अनुमति न दें और सिकुड़ने की अनुमति न दें बिट को कंपैनियन तरीकों में ट्रांसफ़र करके, पहले इस्तेमाल के इस उदाहरण के लिए सहायता दी जाती थी:

1. default/static/private इंटरफ़ेस के तरीकों वाली लाइब्रेरी को minSdk < 24 के साथ DEX में कंपाइल करें. साथ ही, ऐसे नियम बनाएं जिनसे इंटरफ़ेस के तरीके बने रहें.
2. क्लाथपाथ और -applymapping पर लाइब्रेरी के साथ ऐप्लिकेशन कंपाइल करें.
3. ऐप्लिकेशन और लाइब्रेरी को मर्ज करें.

ध्यान दें कि यह सिर्फ़ -applymapping के साथ काम करता है, क्योंकि disallow obfuscation बिट को कंपैनियन तरीकों में ट्रांसफ़र नहीं किया जाता. इसका मतलब है कि पहले चरण में जनरेट की गई कंपैनियन क्लास में, तरीके के नाम छिपाए गए होंगे.

आगे से, minSdk <24 के लिए, इस इस्तेमाल के उदाहरण का समर्थन नहीं किया जाएगा. इस समस्या को हल करने के लिए, यह तरीका अपनाएं:

1. minSdk < 24 वाले क्लास फ़ाइलों के लिए, default/static/private इंटरफ़ेस के तरीकों का इस्तेमाल करके लाइब्रेरी को डीसुगर करें.
2. R8 और उन नियमों का इस्तेमाल करके, डीशुगर किए गए आर्टफ़ैक्ट को कंपाइल करें जो इंटरफ़ेस के तरीकों को कंपैनियन क्लास पर रखते हैं.
3. ऐप्लिकेशन को क्लासपाथ पर मौजूद लाइब्रेरी के साथ कंपाइल करें.
4. ऐप्लिकेशन और डीशुगर किए गए आर्टफ़ैक्ट को मर्ज करें.

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

डिफ़ॉल्ट रूप से जनरेट होने वाली सोर्स फ़ाइल को r8-map-id-<MAP_ID> में बदलें

यह बदलाव, AGP के 8.12.0 वर्शन से लागू है.

जब रीट्रैसिंग की ज़रूरत होती है, तब किसी क्लास के लिए डिफ़ॉल्ट रूप से जनरेट होने वाले सोर्स फ़ाइल एट्रिब्यूट की वैल्यू SourceFile से बदलकर r8-map-id-<MAP_ID> हो जाती है. रीट्रैसिंग की ज़रूरत तब होती है, जब ओब्फ़स्केशन या ऑप्टिमाइज़ेशन चालू हो.

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

अगर कस्टम सोर्स फ़ाइल एट्रिब्यूट (-renamesourcefileattribute) का इस्तेमाल किया जाता है, तो इस कस्टम सोर्स फ़ाइल एट्रिब्यूट को प्राथमिकता मिलती रहेगी.

ProGuard के साथ काम करने वाले मोड में (जब gradle.properties में android.enableR8.fullMode=false शामिल हो), r8-map-id-<MAP_ID> के सोर्स फ़ाइल एट्रिब्यूट को सिर्फ़ तब लागू किया जाता है, जब SourceFile एट्रिब्यूट को नहीं रखा जाता है. ProGuard के कंपैटिबिलिटी मोड का इस्तेमाल करने वाले ऐप्लिकेशन, अगर अपने स्टैक ट्रेस में मैपिंग फ़ाइल आईडी शामिल करना चाहते हैं, तो उन्हें -keepattributes SourceFile हटाना होगा या R8 के फ़ुल मोड पर माइग्रेट करना होगा.

r8-map-id-<MAP_ID> में इस्तेमाल किया गया मैप आईडी, मैप का पूरा हैश है. यह मैप के हैश का सात वर्णों वाला प्रीफ़िक्स नहीं है, जिसका इस्तेमाल पहले किया जाता था.

L8 डिसुगरिंग में, छोटे किए गए सिंथेटिक नामों के इस्तेमाल की सुविधा चालू करें

D8 से जनरेट की गई सिंथेटिक क्लास के नाम में आम तौर पर सबस्ट्रिंग $$ExternalSynthetic शामिल होता है. इससे पता चलता है कि यह D8 से जनरेट की गई सिंथेटिक क्लास है. इसके अलावा, सिंथेटिक के नाम में सिंथेटिक का टाइप भी शामिल होता है. उदाहरण के लिए, Backport, Lambda. इससे DEX के साइज़ पर बुरा असर पड़ता है, क्योंकि क्लास के नाम स्ट्रिंग पूल में ज़्यादा जगह लेते हैं.

AGP 9.0, L8 (कोर लाइब्रेरी डिसुगरिंग) को कॉन्फ़िगर करता है, ताकि सभी j$ क्लास वाली DEX फ़ाइल, सिंथेटिक क्लास के लिए क्लास के नाम के नए छोटे फ़ॉर्मैट का इस्तेमाल करे. क्लास के नए नाम में न्यूमेरिक आईडी का इस्तेमाल किया जाता है. उदाहरण के लिए, $1.

-addconfigurationdebugging के लिए सहायता हटाएं

AGP 9.0 में, -addconfigurationdebugging के लिए सहायता हटा दी गई है. अब कंपाइलर, इस फ़्लैग का इस्तेमाल करने पर चेतावनी दिखाता है.

D8/R8 से L8 के नियम जनरेट करने की सुविधा हटा दी गई है

यह बदलाव सिर्फ़ उन डेवलपर के लिए है जो D8/R8 कमांड लाइन या एपीआई का सीधे तौर पर इस्तेमाल करते हैं.

R8 9.0, D8 और R8 से L8 के लिए कीप रूल जनरेट करने की सुविधा हटा देता है. इसके बजाय, आपको TraceReferences का इस्तेमाल करना चाहिए.

खास तौर पर, D8Command.builder.setDesugaredLibraryKeepRuleConsumer और R8Command.Builder.setDesugaredLibraryKeepRuleConsumer तरीकों को हटा दिया गया है. साथ ही, D8 और R8 के कमांड लाइन विकल्पों से --desugared-lib-pg-conf-output के लिए सहायता हटा दी गई है.

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

Android Gradle प्लगिन 9.0.0