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

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

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

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

Android Gradle প্লাগইন 9.0.0-alpha05-এ আপডেট করতে, Android Studio Narwhal 4 Feature Drop-এ Android Gradle প্লাগইন আপগ্রেড সহকারী ব্যবহার করুন। 2025.1.4.

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

সামঞ্জস্য

Android Gradle প্লাগইন 9.0.0-alpha05 সমর্থন করে সর্বাধিক Android API স্তর হল API স্তর 36৷

Android Gradle প্লাগইন 9.0.0-alpha05 এর জন্য Gradle 9.0.0 প্রয়োজন।

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

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

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

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

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

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

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

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

• তৃতীয় পক্ষের প্লাগইনগুলি আপডেট করুন: কিছু তৃতীয় পক্ষের প্লাগইনগুলি এখনও ইন্টারফেস বা APIগুলির উপর নির্ভর করতে পারে যা আর প্রকাশ করা হয় না৷ AGP 9.0 এর সাথে সামঞ্জস্যপূর্ণ প্লাগইনগুলির সংস্করণগুলিতে স্থানান্তর করুন৷

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

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

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

অন্তর্নির্মিত কোটলিন

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

অ্যান্ড্রয়েড গ্রেডল প্লাগইন 9.0-এর কোটলিন গ্রেডল প্লাগইন 2.2.10-এর উপর একটি রানটাইম নির্ভরতা রয়েছে, যা অন্তর্নির্মিত কোটলিন সমর্থনের জন্য প্রয়োজনীয় নূন্যতম সংস্করণ।

আপনি 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
        }
    }
}

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

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

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

android {
  buildFeatures {
    resValues = true
  }
}

android {
  buildFeatures {
    shaders = true
  }
}

অপসারিত বৈশিষ্ট্য

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

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

ডিএসএল পরিবর্তন করা হয়েছে

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

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

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

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

  এজিপি ৮.১৩

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

  এজিপি 9.0

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

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

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

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

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

• AndroidSourceSet.jni , কারণ এটি কার্যকরী ছিল না।

• AndroidSourceSet.wearAppConfigurationName , কারণ এটি সরানো এমবেড করা Wear OS অ্যাপ সমর্থনের সাথে সম্পর্কিত।

• BuildType.isRenderscriptDebuggable , কারণ এটি কার্যকরী ছিল না।

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

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

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

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

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

• DependencyVariantSelection নির্বাচন। এটি DependencySelection দ্বারা প্রতিস্থাপিত হয়েছে, যা kotlin.android হিসাবে প্রকাশ করা হয়েছে

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

• Installation.installOptions(String) । এটি Installation.installOptions এর পরিবর্তনযোগ্য সম্পত্তি দ্বারা প্রতিস্থাপিত হয়।

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

• Variant.maxSdkVersion । maxSdk দ্বারা প্রতিস্থাপিত হয়

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

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

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

• পরীক্ষামূলক, কিন্তু কখনই PostProcessing ব্লককে স্থির করেনি।

• ProductFlavor.setDimension , যা dimension বৈশিষ্ট্য দ্বারা প্রতিস্থাপিত হয়

• LanguageSplitOptions , যেটি শুধুমাত্র Google Play Instant-এর জন্য উপযোগী ছিল, যা বাতিল করা হয়েছে।

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

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

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

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

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

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

android {
  buildFeatures {
    aidl = true
  }
}

android {
  buildFeatures {
    renderScript = true
  }
}

সরানো APIs

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

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

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

প্রয়োগকৃত Gradle বৈশিষ্ট্য

আপনি যদি নিম্নলিখিত Gradle বৈশিষ্ট্যগুলি সেট করেন তাহলে AGP 9.0 একটি ত্রুটি নিক্ষেপ করে৷

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