অ্যান্ড্রয়েড গ্রেডল প্লাগইন পূর্বরূপের জন্য নোট রিলিজ করুন

এই পৃষ্ঠায় অ্যান্ড্রয়েড গ্রেডল প্লাগইন (AGP) এর প্রিভিউ রিলিজের জন্য রিলিজ নোট রয়েছে।

অ্যান্ড্রয়েড গ্রেডল প্লাগইন 9.0

অ্যান্ড্রয়েড গ্রেডল প্লাগইন ৯.০ হল AGP-এর একটি নতুন প্রধান সংস্করণ, এবং এটি API এবং আচরণগত পরিবর্তন নিয়ে আসে।

Android Gradle প্লাগইন 9.0.0-alpha11 এ আপডেট করতে, Android Studio Otter 2 Feature Drop | 2025.2.2 এ Android Gradle প্লাগইন আপগ্রেড সহকারী ব্যবহার করুন।

AGP আপগ্রেড সহকারী আপনার প্রকল্প আপগ্রেড করার সময় বিদ্যমান আচরণগুলি সংরক্ষণ করতে সাহায্য করে, যখনই উপযুক্ত হবে, আপনাকে AGP 9.0 ব্যবহারের জন্য আপনার প্রকল্প আপগ্রেড করতে দেয়, এমনকি যদি আপনি AGP 9.0-এর সমস্ত নতুন ডিফল্ট গ্রহণ করতে প্রস্তুত না হন।

সামঞ্জস্য

Android Gradle প্লাগইন 9.0.0-alpha11 সর্বোচ্চ যে Android API লেভেলটি সমর্থন করে তা হল API লেভেল 36।

অ্যান্ড্রয়েড গ্র্যাডেল প্লাগইন 9.0.0-alpha11 এর জন্য গ্র্যাডেল 9.0.0 প্রয়োজন।

android ডিএসএল ক্লাসগুলি এখন কেবল নতুন পাবলিক ইন্টারফেস বাস্তবায়ন করে

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

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

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

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

• 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 ইন্টারফেসে স্যুইচ করার ফলে বিভিন্ন অবচিত 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.0 তে আপগ্রেড করার আগে আপনি নতুন API গুলিতে আপগ্রেড শুরু করতে পারেন। অনেক AGP সংস্করণের জন্য নতুন ইন্টারফেসগুলি উপস্থিত রয়েছে এবং তাই আপনি নতুন এবং পুরাতন উভয়ের মিশ্রণ পেতে পারেন। AGP API রেফারেন্স ডক্স প্রতিটি AGP সংস্করণের API পৃষ্ঠ এবং প্রতিটি ক্লাস, পদ্ধতি এবং ক্ষেত্র কখন যুক্ত করা হয়েছিল তা দেখায়।

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

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

বিল্ট-ইন কোটলিন

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

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

কোটলিন গ্র্যাডেল প্লাগইন 2.2.10 এর উপর রানটাইম নির্ভরতা

অ্যান্ড্রয়েড গ্রেডল প্লাগইন ৯.০-এর রানটাইম নির্ভরতা কোটলিন গ্রেডল প্লাগইন (কেজিপি) ২.২.১০-এর উপর, যা বিল্ট-ইন কোটলিন সাপোর্টের জন্য প্রয়োজনীয় সর্বনিম্ন সংস্করণ।

এর মানে হল আপনি যদি বিল্ট-ইন কোটলিন বেছে নেন এবং 2.2.10 এর চেয়ে কম KGP সংস্করণ ব্যবহার করেন, তাহলে Gradle স্বয়ংক্রিয়ভাবে KGP সংস্করণটিকে 2.2.10 এ আপগ্রেড করবে।

একইভাবে, যদি আপনি 2.2.10-2.0.2 এর চেয়ে কম KSP সংস্করণ ব্যবহার করেন, তাহলে AGP KGP সংস্করণের সাথে মিল রেখে KSP সংস্করণটিকে 2.2.10-2.0.2 এ আপগ্রেড করবে।

অতএব, যদি আপনি বিল্ট-ইন কোটলিন ব্যবহার বন্ধ করে দেন এবং KGP অথবা KSP এর পুরোনো সংস্করণ ব্যবহার করতে চান, তাহলে আপনার টপ-লেভেল বিল্ড ফাইলে নিম্নলিখিতগুলি যোগ করতে হবে:

buildscript {
    dependencies {
        classpath("org.jetbrains.kotlin:kotlin-gradle-plugin") {
            version { strictly("KGP_VERSION") }
        }
        classpath("com.google.devtoolsksp:symbol-processing-gradle-plugin") {
            version { strictly("KSP_VERSION") }
        }
    }
}

পরীক্ষার ফিক্সচারের জন্য IDE সমর্থন

AGP 9.0 পরীক্ষার ফিক্সচারের জন্য সম্পূর্ণ Android Studio IDE সমর্থন প্রদান করে। এই সমর্থন পেতে, AGP 9.0.0-alpha07 বা উচ্চতর ব্যবহার করুন।

আচরণগত পরিবর্তন

অ্যান্ড্রয়েড গ্রেডল প্লাগইন 9.0-এ নিম্নলিখিত নতুন আচরণ রয়েছে:

AGP 9.0-এ নিম্নলিখিত Gradle প্রোপার্টিগুলির ডিফল্ট আপডেট অন্তর্ভুক্ত রয়েছে। এটি আপনাকে আপগ্রেড করার সময় AGP 8.13 আচরণ সংরক্ষণ করার বিকল্প দেয়:

android {
  buildFeatures {
    resValues = true
  }
}

android {
  buildFeatures {
    shaders = true
  }
}

সরানো বৈশিষ্ট্যগুলি

অ্যান্ড্রয়েড গ্রেডল প্লাগইন 9.0 নিম্নলিখিত কার্যকারিতা সরিয়ে দেয়:

• এমবেডেড ওয়্যার ওএস অ্যাপ সাপোর্ট
  AGP 9.0 Wear OS অ্যাপ এম্বেড করার জন্য সমর্থন সরিয়ে দেয়, যা আর Play তে সমর্থিত নয়। এর মধ্যে wearApp কনফিগারেশন এবং AndroidSourceSet.wearAppConfigurationName DSL অপসারণ অন্তর্ভুক্ত। Wear OS তে আপনার অ্যাপটি কীভাবে প্রকাশ করবেন তা জানতে Distribute to Wear OS দেখুন।
• androidDependencies এবং sourceSets রিপোর্ট টাস্ক

পরিবর্তিত DSL

অ্যান্ড্রয়েড গ্রেডল প্লাগইন 9.0-এ নিম্নলিখিত ব্রেকিং DSL পরিবর্তনগুলি রয়েছে:

• CommonExtension এর প্যারামিটারাইজেশন সরানো হয়েছে।

  নিজেই, এটি শুধুমাত্র একটি সোর্স-লেভেল ব্রেকিং পরিবর্তন যা ভবিষ্যতে সোর্স-লেভেল ব্রেকিং পরিবর্তন এড়াতে সাহায্য করবে, তবে এর অর্থ হল ব্লক পদ্ধতিগুলিকে CommonExtension থেকে ApplicationExtension , LibraryExension , DynamicFeatureExtension এবং TestExtension এ স্থানান্তর করতে হবে।

  আপনার প্রকল্পটি AGP 9.0 তে আপগ্রেড করার সময়, Gradle প্লাগইন কোডটি রিফ্যাক্টর করুন যা ঐ প্যারামিটারগুলি বা ব্লক পদ্ধতিগুলি ব্যবহার করে। উদাহরণস্বরূপ, নিম্নলিখিত প্লাগইনটি টাইপ প্যারামিটারটি অপসারণ করার জন্য আপডেট করা হয়েছে এবং সরানো ব্লক পদ্ধতিগুলির উপর নির্ভর করে না:

  এজিপি ৮.১৩

  val commonExtension: CommonExtension<*, *, *, *, *, *> =
          extensions.getByType(CommonExtension::class)
  commonExtension.apply {
      defaultConfig {
          minSdk {
              version = release(28)
          }
      }
  }
  

  এজিপি ৯.০

  val commonExtension: CommonExtension =
          extensions.getByType(CommonExtension::class)
  commonExtension.apply {
      defaultConfig.apply {
          minSdk {
              version = release(28)
          }
      }
  }
  

  যেসব প্লাগইন AGP ভার্সনের একটি পরিসরকে লক্ষ্য করে, তাদের জন্য সরাসরি গেটার ব্যবহার করা 9.0 এর চেয়ে কম AGP ভার্সনের সাথে বাইনারি সামঞ্জস্যপূর্ণ।

ডিএসএল সরানো হয়েছে

অ্যান্ড্রয়েড গ্রেডল প্লাগইন 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 এর জন্য কার্যকর ছিল, যা বন্ধ করা হয়েছে।

সরানো API গুলি

অ্যান্ড্রয়েড গ্রেডল প্লাগইন 9.0 অপসারণ করে:

• AndroidComponentsExtension.finalizeDSl । এটি finalizeDsl দ্বারা প্রতিস্থাপিত হয়।

• Component.transformClassesWith । এটি Instrumentation.transformClassesWith দ্বারা প্রতিস্থাপিত হয়।

• Component.setAsmFramesComputationMode । এটি Instrumentation.setAsmFramesComputationMode দ্বারা প্রতিস্থাপিত হয়।

• ComponentBuilder.enabled । এটি ComponentBuilder.enable দ্বারা প্রতিস্থাপিত হয়।

• DependenciesInfoBuilder.includedInApk । Is কে includeInApk দ্বারা প্রতিস্থাপিত করা হয়েছে।

• DependenciesInfoBuilder.includedInBundle । Is কে includeInBundle দ্বারা প্রতিস্থাপিত করা হয়।

• GeneratesApk.targetSdkVersion । Is targetSdk দ্বারা প্রতিস্থাপিত হয়

• Variant.minSdkVersion . Is minSdk দ্বারা প্রতিস্থাপিত হয়

• Variant.maxSdkVersion . Is কে maxSdk দ্বারা প্রতিস্থাপিত করা হয়েছে

• Variant.targetSdkVersion . Is targetSdk দ্বারা প্রতিস্থাপিত হয়

• Variant.unitTest , কারণ এটি com.android.test প্লাগইনের ক্ষেত্রে প্রযোজ্য ছিল না। unitTest HasUnitTest সম্প্রসারিত VariantBuilder সাবটাইপে উপলব্ধ।

• VariantBuilder.targetSdk এবং targetSdkPreview , কারণ এগুলি লাইব্রেরিতে অর্থবহ ছিল না। পরিবর্তে GeneratesApkBuilder.targetSdk অথবা GeneratesApkBuilder.targetSdkPreview ব্যবহার করুন।

• VariantBuilder.enableUnitTest , কারণ এটি com.android.test প্লাগইনের ক্ষেত্রে প্রযোজ্য ছিল না। enableUnitTest HasUnitTestBuilder সম্প্রসারিত VariantBuilder সাবটাইপে উপলব্ধ।

• HasUnitTestBuilder সম্প্রসারিত VariantBuilder সাবটাইপগুলিতে আরও ধারাবাহিকভাবে নামকরণ করা enableUnitTest এর পক্ষে VariantBuilder.unitTestEnabled সরানো হয়েছে।

• VariantOutput.enable . এটি enabled দ্বারা প্রতিস্থাপিত হয়

• অবচিত এবং নিষ্ক্রিয় FeaturePlugin এবং FeatureExtension ।

• অবচিত এবং নিষ্ক্রিয় BaseExtension.registerTransform API গুলি, যা কেবলমাত্র AGP 4.2 বা তার নিচের সংস্করণে চলমান লক্ষ্যবস্তুতে সর্বশেষ AGP সংস্করণের বিরুদ্ধে কম্পাইল করার অনুমতি দেয়।

Gradle বৈশিষ্ট্যগুলি সরানো হয়েছে

ডিফল্টরূপে সক্রিয় থাকা বৈশিষ্ট্যগুলিকে বিশ্বব্যাপী অক্ষম করার উপায় হিসেবে প্রাথমিকভাবে নিম্নলিখিত গ্রেডল বৈশিষ্ট্যগুলি যুক্ত করা হয়েছিল।

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

android {
  buildFeatures {
    aidl = true
  }
}

android {
  buildFeatures {
    renderScript = true
  }
}

জোরপূর্বক গ্রেডল বৈশিষ্ট্য

নিম্নলিখিত Gradle বৈশিষ্ট্যগুলি সেট করলে AGP 9.0 একটি ত্রুটি ঠেলে দেয়।

অ্যান্ড্রয়েড গ্রেডল প্লাগইন আপগ্রেড অ্যাসিস্ট্যান্ট এই বৈশিষ্ট্যগুলি ব্যবহার করে এমন প্রকল্পগুলিকে AGP 9.0 তে আপগ্রেড করবে না।

সমস্যা সমাধান করা হয়েছে

অ্যান্ড্রয়েড গ্রেডল প্লাগইন 9.0.0-alpha10

অ্যান্ড্রয়েড গ্রেডল প্লাগইন 9.0.0-alpha09

অ্যান্ড্রয়েড গ্রেডল প্লাগইন 9.0.0-alpha08

অ্যান্ড্রয়েড গ্রেডল প্লাগইন 9.0.0-alpha07

অ্যান্ড্রয়েড গ্রেডল প্লাগইন 9.0.0-alpha06

অ্যান্ড্রয়েড গ্রেডল প্লাগইন 9.0.0-alpha05

অ্যান্ড্রয়েড গ্রেডল প্লাগইন 9.0.0-alpha04

অ্যান্ড্রয়েড গ্রেডল প্লাগইন 9.0.0-alpha03

অ্যান্ড্রয়েড গ্রেডল প্লাগইন 9.0.0-alpha02

অ্যান্ড্রয়েড গ্রেডল প্লাগইন 9.0.0-alpha01