Android Gradle প্লাগ-ইন 9.0.1 (জানুয়ারি ২০২৬)

Android Gradle প্লাগ-ইন 9.0 হল একটি বড় রিলিজ যা API এবং আচরণে পরিবর্তন নিয়ে আসে।

Android Gradle প্লাগ-ইন 9.0.1-এ আপডেট করতে, Android Gradle প্লাগ-ইন আপগ্রেড অ্যাসিস্ট্যান্ট ব্যবহার করুন। AGP আপগ্রেড অ্যাসিস্ট্যান্ট আপনার প্রজেক্ট আপগ্রেড করার সময় উপযুক্ত হলে আগেকার আচরণ বজায় রাখতে সাহায্য করে, তাই AGP 9.0-এর সব নতুন ডিফল্ট গ্রহণ করার জন্য প্রস্তুত না থাকলেও আপনি AGP 9.0 ব্যবহার করার জন্য নিজের প্রজেক্ট আপগ্রেড করতে পারবেন।

আপগ্রেড করার প্রসেস আরও সহজ করতে, দুটি এজেন্ট স্কিলও উপলভ্য আছে। KMP নয় এমন অ্যাপের জন্য, Android স্কিল রিপোজিটরি থেকে AGP 9 আপগ্রেড স্কিল ব্যবহার করে দেখুন। KMP অ্যাপের জন্য, JetBrains-এর AGP 9 আপগ্রেড দক্ষতা ব্যবহার করে দেখুন। Android Studio-তে স্কিল ব্যবহার করা সম্পর্কে আরও জানতে, স্কিলের মাধ্যমে এজেন্ট মোড এক্সটেন্ড করা দেখুন।

মানানসই

Android Gradle plugin 9.0-এর সাথে কাজ করে এমন সর্বাধিক API লেভেল হল API লেভেল 36.1. এখানে অন্যান্য কম্প্যাটিবিলিটি সংক্রান্ত তথ্য দেওয়া হল:

android DSL ক্লাস এখন শুধুমাত্র নতুন পাবলিক ইন্টারফেস প্রয়োগ করে

গত কয়েক বছর ধরে, আমরা DSL ও API-এর জন্য নতুন ইন্টারফেস চালু করেছি যাতে কোন API সর্বজনীন হবে তা আরও ভালোভাবে নিয়ন্ত্রণ করা যায়। AGP ভার্সন ৭.x ও ৮.x এখনও পুরনো DSL ধরন (যেমন BaseExtension) ব্যবহার করে যা নতুন পাবলিক ইন্টারফেসও প্রয়োগ করে, যাতে ইন্টারফেসের কাজ এগিয়ে নিয়ে যাওয়ার সময় সামঞ্জস্য বজায় রাখা যায়।

AGP 9.0 শুধুমাত্র আমাদের নতুন DSL ইন্টারফেস ব্যবহার করে, এবং প্রয়োগ করার পদ্ধতি পরিবর্তন করে নতুন ধরনের করা হয়েছে যা সম্পূর্ণভাবে লুকানো থাকে। এছাড়াও, এটি পুরনো, অননুমোদিত ভ্যারিয়েন্ট API-তে অ্যাক্সেস সরিয়ে দেয়।

AGP 9.0-তে আপডেট করতে, আপনাকে হয়ত নিম্নলিখিত কাজগুলি করতে হবে:

• আপনার প্রোজেক্ট বিল্ট-ইন Kotlin-এর সাথে মানানসই কিনা তা নিশ্চিত করুন: নতুন DSL-এর সাথে org.jetbrains.kotlin.android প্লাগ-ইন মানানসই নয়।

• KMP প্রোজেক্টকে KMP-এর জন্য Android Gradle Library Plugin-এ পরিবর্তন করুন: com.android.library এবং com.android.application প্লাগ-ইনের মতো একই Gradle সাবপ্রোজেক্টে org.jetbrains.kotlin.multiplatform প্লাগ-ইন ব্যবহার করা নতুন DSL-এর সাথে মানানসই নয়।

• আপনার বিল্ড ফাইল আপডেট করুন: ইন্টারফেসের পরিবর্তন DSL-কে যতটা সম্ভব একই রকম রাখার জন্য করা হলেও, এর মধ্যে কিছু ছোটখাটো পরিবর্তন থাকতে পারে।

• নতুন DSL ও API-কে রেফারেন্স হিসেবে ব্যবহার করার জন্য আপনার কাস্টম বিল্ড লজিক আপডেট করুন: ইন্টার্নাল DSL-এর যেকোনও রেফারেন্সকে পাবলিক DSL ইন্টারফেস দিয়ে পাল্টে দিন। বেশিরভাগ ক্ষেত্রে এটি একটির পরিবর্তে একটি হবে। applicationVariants ও একই ধরনের API-এর যেকোনও ব্যবহার নতুন androidComponents API দিয়ে পরিবর্তন করুন। এটি আরও জটিল হতে পারে, কারণ androidComponents API প্লাগ-ইনকে আরও বেশি দিন মানানসই রাখার জন্য আরও স্থিতিশীল করে তোলার জন্য ডিজাইন করা হয়েছে। উদাহরণ দেখতে, আমাদের Gradle রেসিপি দেখুন।

• থার্ড-পার্টি প্লাগ-ইন আপডেট করুন: কিছু থার্ড-পার্টি প্লাগ-ইন এখনও ইন্টারফেস বা API-এর উপর নির্ভর করতে পারে যেগুলি আর এক্সপোজ করা হয় না। AGP 9.0-এর সাথে মানানসই সেইসব প্লাগ-ইনের ভার্সনে মাইগ্রেট করুন।

নতুন DSL ইন্টারফেসে পরিবর্তন করার ফলে, প্লাগ-ইন ও Gradle বিল্ড স্ক্রিপ্ট বিভিন্ন পুরনো API ব্যবহার করতে পারে না, এর মধ্যে এগুলি অন্তর্ভুক্ত:

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

আপনি যদি মানানসই নয় এমন থার্ড-পার্টি প্লাগ-ইন দ্বারা ব্লক হয়ে থাকেন, তাহলে আপনি অপ্ট-আউট করতে এবং DSL-এর জন্য পুরনো ইমপ্লিমেন্টেশন, সেইসাথে পুরনো ভেরিয়েন্ট API ফিরে পেতে পারেন। এটি করার সময়, নতুন ইন্টারফেসও উপলভ্য থাকে এবং আপনি এখনও নতুন API-তে নিজের বিল্ড লজিক আপডেট করতে পারবেন। বিকল্প ছেড়ে বেরিয়ে আসতে, আপনার gradle.properties ফাইলে এই লাইনটি যোগ করুন:

android.newDsl=false

অথবা, আরও ধীরে ধীরে মাইগ্রেশনের জন্য, AGP 9.4 আপনাকে আলাদা আলাদা মডিউল অপ্ট-আউট করতে দেয়। কীভাবে তা জানুন, Variant API মডিউল অপ্ট-আউট দেখুন।

AGP 9.0-এ আগের ক্লাসগুলি 'সঞ্চালনের অনুপযুক্ত' হিসেবে চিহ্নিত করা হয়েছে। এর অর্থ হল, newDsl ফ্ল্যাগ থেকে অপ্ট-আউট করা প্রোজেক্ট android ব্লক সহ ডেপ্রিকেশন সংক্রান্ত সতর্কতা দেখতে পাবে।

এছাড়াও, AGP 9.0-তে আপগ্রেড করার আগে আপনি নতুন API-তে আপগ্রেড করা শুরু করতে পারবেন। নতুন ইন্টারফেসগুলি অনেক AGP ভার্সনে উপস্থিত রয়েছে এবং তাই আপনার কাছে নতুন এবং পুরনো ইন্টারফেসের মিশ্রণ থাকতে পারে। AGP API রেফারেন্স ডকুমেন্ট প্রতিটি AGP ভার্সনের জন্য API সারফেস এবং প্রতিটি ক্লাস, মেথড ও ফিল্ড কখন যোগ করা হয়েছে তা দেখায়।

সাধারণত ব্যবহৃত প্লাগ-ইনগুলির লেখকদের সাথে যোগাযোগ করে তাদের নতুন মোডের সাথে মানিয়ে নিতে এবং সম্পূর্ণভাবে মানানসই প্লাগ-ইন রিলিজ করতে সাহায্য করছি। এছাড়াও, মাইগ্রেশন প্রক্রিয়াতে আপনাকে গাইড করার জন্য Android Studio-তে AGP আপগ্রেড অ্যাসিস্ট্যান্টকে আরও উন্নত করার কাজ চালিয়ে যাব।

আপনি যদি দেখেন যে নতুন DSL বা Variant API-তে কোনও ক্ষমতা বা ফিচার নেই, তাহলে যত তাড়াতাড়ি সম্ভব একটি সমস্যা ফাইল করুন।

বিল্ট-ইন Kotlin

Android Gradle প্লাগ-ইন 9.0 বিল্ট-ইন Kotlin সহায়তা নিয়ে আসে এবং ডিফল্ট হিসেবে এটি চালু করে । এর অর্থ হল, Kotlin সোর্স ফাইল কম্পাইল করার জন্য আপনাকে আর বিল্ড ফাইলেorg.jetbrains.kotlin.android (বা kotlin-android) প্লাগ-ইন প্রয়োগ করতে হবে না। এটি AGP-র সাথে Kotlin ইন্টিগ্রেশনকে সহজ করে, পুরনো হয়ে যাওয়া API-এর ব্যবহার এড়ায় এবং কিছু ক্ষেত্রে পারফর্ম্যান্স উন্নত করে।

তাই, আপনার প্রোজেক্ট AGP 9.0-তে আপগ্রেড করলে, আপনাকেও বিল্ট-ইন Kotlin-এ মাইগ্রেট করতে হবে অথবা অপ্ট-আউট করতে হবে।

এছাড়াও, Kotlin সোর্স নেই এমন Gradle সাবপ্রজেক্টের জন্য আপনি বেছে বেছে বিল্ট-ইন Kotlin সাপোর্ট বন্ধ করতে পারবেন।

Kotlin Gradle প্লাগ-ইনের উপর রানটাইম নির্ভরতা

বিল্ট-ইন Kotlin সহায়তা প্রদান করতে, Android Gradle প্লাগ-ইন 9.0-এ এখন Kotlin Gradle প্লাগ-ইন (KGP) 2.2.10-এর উপর রানটাইম নির্ভরতা আছে। এর অর্থ হল, আপনাকে আর KGP ভার্সন ঘোষণা করতে হবে না এবং আপনি 2.2.10-এর থেকে কম KGP ভার্সন ব্যবহার করলে, Gradle অটোমেটিক আপনার KGP ভার্সন 2.2.10-এ আপগ্রেড করে দেবে। একইভাবে, আপনি যদি 2.2.10-2.0.2-এর থেকে কম KSP ভার্সন ব্যবহার করেন, তাহলে KGP ভার্সনের সাথে ম্যাচ করাতে AGP এটিকে 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.devtools.ksp:symbol-processing-gradle-plugin:KSP_VERSION")
    }
}

নিচের KGP ভার্সনে ডাউনগ্রেড করা

আপনি KGP ভার্সন তখনই ডাউনগ্রেড করতে পারবেন, যদি আপনি বিল্ট-ইন কোটলিন থেকে অপ্ট-আউট করে থাকেন। এর কারণ হল, 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 (Preview) আপনাকে একাধিক লাইব্রেরি একটি Android Library AAR হিসেবে প্রকাশ করতে দেয়। এর ফলে আপনার প্রকাশিত আর্টিফ্যাক্টের উপর নির্ভর করা আপনার ব্যবহারকারীদের পক্ষে সহজ হতে পারে।

শুরু করা সম্পর্কিত তথ্যের জন্য, Fused Library-এর মাধ্যমে একাধিক 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 তৈরি করার সহায়তা সরিয়ে দেয়। কার্যকারিতা এবং সম্পর্কিত API সরিয়ে দেওয়া হয়েছে। AGP 9.0 বা তার পরের যেকোনও ভার্সন ব্যবহার করে স্ক্রিন ডেনসিটি অনুযায়ী APK স্প্লিট করতে, অ্যাপ বান্ডেল ব্যবহার করুন।

পরিবর্তিত DSL

Android Gradle প্লাগ-ইন 9.0-তে নিম্নলিখিত DSL পরিবর্তনগুলি করা হয়েছে:

• 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 ভার্সনের একটি রেঞ্জকে টার্গেট করে, সেগুলির জন্য সরাসরি গেটার ব্যবহার করলে ৯.০-এর আগের AGP ভার্সনের সাথে বাইনারি মানানসই হয়।

সরানো DSL

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 Instant-এর জন্য উপযোগী ছিল, এটি এখন আর ব্যবহার করা হয় না।

• DensitySplit, কারণ ফিচারটি আর কাজ করে না। এর পরিবর্তে অ্যাপ বান্ডেল ব্যবহার করা হয়।

সরিয়ে দেওয়া API

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 সরিয়ে দেওয়া হয়েছে এবং এর পরিবর্তে আরও ধারাবাহিকভাবে নাম দেওয়া enableUnitTest ব্যবহার করা হয়েছে, যা VariantBuilder সাবটাইপ এক্সটেনশন HasUnitTestBuilder।

• VariantOutput.enable. এটি কি enabled দিয়ে পরিবর্তন করা হয়েছে

• বন্ধ করা ও কাজ না করা FeaturePlugin ও FeatureExtension।

• পুরনো হয়ে যাওয়া ও বন্ধ করে দেওয়া BaseExtension.registerTransform API, যেগুলি শুধুমাত্র লেটেস্ট AGP ভার্সনের সাথে কম্পাইল করার অনুমতি দেওয়ার জন্য AGP 4.2 বা তার আগের ভার্সনে টার্গেট করার সময় থেকে গেছে।

সরিয়ে দেওয়া Gradle প্রপার্টি

ডিফল্ট হিসেবে চালু থাকা ফিচারগুলি বিশ্বব্যাপী বন্ধ করার উপায় হিসেবে নিম্নলিখিত Gradle প্রপার্টিগুলি প্রাথমিকভাবে যোগ করা হয়েছিল।

AGP 8.0 বা এর আগের ভার্সন থেকে এইসব ফিচার সাধারণত বন্ধ থাকে। আরও দক্ষ বিল্ডের জন্য শুধুমাত্র সেইসব সাব-প্রোজেক্টে এই ফিচারগুলি চালু করুন যেগুলিতে সেগুলি ব্যবহার করা হয়।

android {
  buildFeatures {
    aidl = true
  }
}

android {
  buildFeatures {
    renderScript = true
  }
}

বাধ্যতামূলক Gradle প্রপার্টি

আপনি নিম্নলিখিত Gradle প্রপার্টি সেট করলে AGP 9.0 একটি সমস্যা দেখায়।

Android Gradle প্লাগ-ইন আপগ্রেড অ্যাসিস্ট্যান্ট এইসব প্রপার্টি ব্যবহার করে এমন প্রোজেক্টকে AGP 9.0-তে আপগ্রেড করবে না।

R8 পরিবর্তন

AGP 9.0.0-এ নিম্নলিখিত R8 পরিবর্তন অন্তর্ভুক্ত করা হয়েছে।

নতুন কনফিগারেশন বিকল্প -processkotlinnullchecks

Kotlin নাল চেক প্রসেস করার জন্য R8 কনফিগার করতে আমরা নতুন 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 এর যেকোনও স্পেসিফিকেশন সেটি ওভাররাইড করবে। একাধিকবার উল্লেখ করা হলে, সবচেয়ে শক্তিশালী ভ্যালু ব্যবহার করা হয়।

কম্প্যানিয়ন পদ্ধতিতে Keep সংক্রান্ত তথ্য প্রোপাগেট করা বন্ধ করা

কীপ রুল, ডিসুগারিংয়ের অধীন ইন্টারফেস পদ্ধতির সাথে ম্যাচ করলে, R8 আগে ইন্টার্নালি সিন্থেসাইজ করা কম্প্যানিয়ন পদ্ধতিতে অপ্টিমাইজেশন ডিসঅ্যালাও এবং সংকোচন ডিসঅ্যালাও বিট ট্রান্সফার করত।

AGP 9.0 থেকে শুরু করে, কীপ নিয়ম আর কম্প্যানিয়ন পদ্ধতির ক্ষেত্রে প্রযোজ্য হবে না। এটি এই সত্যের সাথে সামঞ্জস্যপূর্ণ যে, কিপ নিয়মগুলি অন্যান্য কম্পাইলার সিন্থেসাইজড ফিল্ড/মেথড/ক্লাসের ক্ষেত্রে প্রযোজ্য নয়।

অপ্টিমাইজ করার অনুমতি নেই এবং ছোট করার অনুমতি নেই বিটগুলি কম্প্যানিয়ন পদ্ধতিতে ট্রান্সফার করার মাধ্যমে, নিম্নলিখিত ব্যবহারের ক্ষেত্রে আগে কাজ করত:

1. default/static/private ইন্টারফেস পদ্ধতি সহ লাইব্রেরি কম্পাইল করুন minSdk < ২৪ এবং ইন্টারফেস পদ্ধতি বজায় রাখে এমন নিয়ম সহ DEX-এ।
2. ক্লাসপাথ ও -applymapping-এ লাইব্রেরি সহ অ্যাপ কম্পাইল করুন।
3. অ্যাপ ও লাইব্রেরি মার্জ করুন।

মনে রাখবেন, এটি শুধুমাত্র -applymapping-এর সাথে কাজ করে, কারণ disallow obfuscation বিটটি কম্প্যানিয়ন পদ্ধতিতে ট্রান্সফার করা হয় না—অর্থাৎ, ১ম ধাপ থেকে তৈরি কম্প্যানিয়ন ক্লাসে অস্পষ্ট করা পদ্ধতির নাম থাকবে।

ভবিষ্যতে minSdk < 24-এর জন্য এই ব্যবহার আর কাজ করবে না। এর বিকল্প সমাধান হল নিম্নলিখিত কাজগুলি করা:

1. default/static/private ইন্টারফেস পদ্ধতির মাধ্যমে লাইব্রেরিকে ডিসুগার করুন যাতে minSdk < ২৪ সহ ক্লাস ফাইল থাকে।
2. R8 এবং এমন নিয়ম ব্যবহার করে ডেসুগার করা আর্টিফ্যাক্ট কম্পাইল করুন যা কম্প্যানিয়ন ক্লাসে মেথড রাখে।
3. ক্লাসপাথে লাইব্রেরি সহ অ্যাপটি কম্পাইল করুন।
4. অ্যাপ ও ডিসেগার করা আর্টিফ্যাক্ট মার্জ করুন।

এর আরেকটি পার্শ্বপ্রতিক্রিয়া হল যে ইন্টারফেস কম্প্যানিয়ন পদ্ধতির মধ্যে অ্যানোনিমাস এবং লোকাল ক্লাসের জন্য ইনার ক্লাস এবং এনক্লোজিং মেথড অ্যাট্রিবিউট আর রাখা সম্ভব নয়।

ডিফল্ট নির্গত সোর্স ফাইল পরিবর্তন করে r8-map-id-<MAP_ID> করুন

এই পরিবর্তন AGP-তে ৮.১২.০ ভার্সন থেকে শুরু হচ্ছে।

রিট্রেসিংয়ের প্রয়োজন হলে (অর্থাৎ, অফস্কেশন বা অপ্টিমাইজেশন চালু থাকলে), কোনও ক্লাসের জন্য ডিফল্ট এমিটেড সোর্স ফাইল অ্যাট্রিবিউট 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 (কোর লাইব্রেরি ডিসুগারিং) কনফিগার করে যাতে DEX ফাইলে থাকা সব j$ ক্লাসে সিন্থেটিক ক্লাসের জন্য নতুন ছোট করা ক্লাসের নাম ফর্ম্যাট ব্যবহার করা হয়। নতুন ক্লাসের নামে সাংখ্যিক আইডি (যেমন, $1) ব্যবহার করা হয়।

-addconfigurationdebugging-এর জন্য সহায়তা সরিয়ে দিন

AGP 9.0, -addconfigurationdebugging-এর জন্য সহায়তা সরিয়ে দেয়। ফ্ল্যাগ ব্যবহার করা হলে, কম্পাইলার এখন একটি সতর্কতা জানায়।

D8/R8 থেকে L8 নিয়ম জেনারেট করার সুবিধা সরিয়ে দেওয়া

এই পরিবর্তনটি শুধুমাত্র D8/R8 কমান্ড লাইন বা সরাসরি API ব্যবহার করা ডেভেলপারদের জন্য প্রাসঙ্গিক।

D8 ও R8 থেকে L8-এর জন্য কীপ নিয়ম জেনারেট করার সুবিধা R8 9.0 সরিয়ে দেয়। এই উদ্দেশ্যে আপনাকে TraceReferences ব্যবহার করতে হবে।

আরও নির্দিষ্টভাবে, D8Command.builder.setDesugaredLibraryKeepRuleConsumer এবং R8Command.Builder.setDesugaredLibraryKeepRuleConsumer পদ্ধতি সরিয়ে দেওয়া হয়েছে এবং D8 ও R8-এর কমান্ড লাইন বিকল্প থেকে --desugared-lib-pg-conf-output-এর জন্য সাপোর্ট সরিয়ে দেওয়া হয়েছে।

সমাধান করা সমস্যা

Android Gradle প্লাগ-ইন 9.0.0