Android Gradle প্লাগ-ইন DSL/API মাইগ্রেশন টাইমলাইন

Android Gradle Plugin (AGP) হল Android অ্যাপ্লিকেশনের জন্য কাজ করে এমন বিল্ড সিস্টেম এবং এতে বিভিন্ন ধরনের সোর্স কম্পাইল করার জন্য এবং সেগুলিকে একসাথে একটি অ্যাপ্লিকেশনে লিঙ্ক করার জন্য সহায়তা অন্তর্ভুক্ত রয়েছে যা আপনি একটি ফিজিক্যাল Android ডিভাইস বা এমুলেটরে চালাতে পারেন।

নিম্নলিখিত বিভাগে AGP-এর DSL ও API-এর পরিকল্পিত বিবর্তন বর্ণনা করা হয়েছে। স্টেবল রিলিজে নতুন API যোগ করা হলে, পুরনো API-কে বন্ধ হয়ে যাওয়া হিসেবে চিহ্নিত করা হবে। সেইসব বন্ধ হয়ে যাওয়া API পরবর্তী স্টেবল রিলিজে আর উপলভ্য থাকবে না। নিম্নলিখিত বিভাগগুলি প্রতিটি প্রধান AGP রিলিজে আসন্ন পরিবর্তন সম্পর্কে তথ্য প্রদান করে।

AGP API বন্ধ করা বা সরিয়ে দেওয়ার বিষয়ে আরও বিস্তারিত লগের জন্য, AGP API আপডেট দেখুন।

AGP 10.0 (২০২৬-এর শেষের দিকে)

Android Gradle Plugin 10.0 API-তে পরিবর্তন ও আধুনিকীকরণ

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

লেজি বিল্ড মডেল কেন?

লেগেসি, নন-লেজি বিল্ড মডেলে, Gradle প্রতিটি সিঙ্ক বা বিল্ড ইনভোকেশনের সময় সমস্ত প্রোজেক্ট মডিউল জুড়ে অবজেক্ট, কোয়েরি ভেরিয়েন্ট ডেটা এবং কনফিগার টাস্কগুলি আগ্রহের সাথে মূল্যায়ন করে। এই ইগার ইভ্যালুয়েশন, ভ্যারিয়েন্ট ও টাস্কের ক্ষেত্রে সিপিইউ টাইম ও মেমরি নষ্ট করে যেগুলি চলছে না এবং জটিল বিল্ড স্ক্রিপ্ট জুড়ে ইভ্যালুয়েশন অর্ডারিং সংক্রান্ত সমস্যা সৃষ্টি করে।

লেজি প্রোভাইডার (Provider<T>) এবং আধুনিক ভ্যারিয়েন্ট API (androidComponents {}) ব্যবহার করে সম্পূর্ণ লেজি বিল্ড মডেলে ট্রানজিশন করার মাধ্যমে, অ্যাক্টিভ বিল্ড এক্সিকিউশন গ্রাফের প্রয়োজন হলেই প্রপার্টি এবং টাস্ক ওয়্যারিং লেজি অন-ডিমান্ড হিসেবে গণনা করা হয়।

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

মূল আর্কিটেকচারাল পার্থক্য

পুরনো BaseVariant API (applicationVariants.all {}) ছিল ইগার এবং টাস্ক-কেন্দ্রিক। এটি কনফিগারেশন ফেজ চলাকালীন ডেভেলপারদের Gradle টাস্ক এবং ইন্টার্নাল কনফিগারেশনে সরাসরি অ্যাক্সেস দেয়, যা সহজাতভাবে আধুনিক Gradle পারফর্ম্যান্স ফিচারকে ভেঙে দেয়।

নতুন ভ্যারিয়েন্ট API (androidComponents {}) হল লেজি ও আর্টিফ্যাক্ট-কেন্দ্রিক। এটি Gradle-এর প্রপার্টি API ব্যাপকভাবে ব্যবহার করে এবং Task ও TaskProvider-এর সমস্ত রেফারেন্স সম্পূর্ণভাবে সরিয়ে দেয়, যার ফলে আপনাকে অন্তর্নিহিত টাস্কের পরিবর্তে ইনপুট এবং আউটপুটের (Variant.artifacts) সাথে পরিষ্কারভাবে ইন্টার‍্যাক্ট করতে হয়।

কী সরানো ও পরিবর্তন করা হচ্ছে

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

সরিয়ে দেওয়া API বা ফিচার পরিবর্তন বা ব্যবস্থা নিতে হবে
সরাসরি টাস্ক অ্যাক্সেস:
  • getJavaCompile()
  • getMergeResourcesProvider()
  • getAssembleProvider()
আর্টিফ্যাক্ট API: টাস্কের আচরণ পরিবর্তন করার জন্য সেটি ফেচ করার পরিবর্তে, টাস্কের মধ্যে পাস করা আসল ফাইল (আর্টিফ্যাক্ট) যোগ, পরিবর্তন বা প্রতিস্থাপন করতে variant.artifacts ব্যবহার করুন।
ইগার সোর্স রেজিস্ট্রেশন:
  • registerJavaGeneratingTask()
  • registerResGeneratingTask()
Sources API: variant.sources.java.addGeneratedSourceDirectory(...) ব্যবহার করে আপনার কাস্টম টাস্কের আউটপুট ডিরেক্টরি ওয়্যার করুন।
ক্লাসপাথ / কনফিগারেশন অ্যাক্সেস:
  • getCompileConfiguration()
  • getCompileClasspath()
Instrumentation API: বাইটকোড পরিবর্তন বা পরীক্ষা করতে (ক্লাসপাথ অ্যাক্সেসের সবচেয়ে সাধারণ ব্যবহার), AsmClassVisitorFactory ব্যবহার করে variant.instrumentation.transformClassesWith(...) ব্যবহার করুন।
ইগার প্রপার্টি মিউটেশন:
  • buildConfigField()
  • resValue()
লেজি `MapProperty` ইনস্ট্যান্স: variant.buildConfigFields.put(...) এবং variant.manifestPlaceholders.put(...) ব্যবহার করুন।
অপ্ট-আউট ফ্ল্যাগ:
  • android.newDsl
  • android.builtInKotlin
সরাসরি পরিবর্তন করা যাবে না। gradle.properties থেকে এইসব ফ্ল্যাগ সরিয়ে দিন; আধুনিক DSL এবং বিল্ট-ইন Kotlin কঠোরভাবে এনফোর্স করা হয়।
লিগ্যাসি ভ্যারিয়েন্ট API এক্সটেনশন:
  • applicationVariants
  • libraryVariants
  • testVariants
  • unitTestVariants
androidComponents.onVariants() দিয়ে পাল্টান।
ভেরিয়েন্ট ফিল্টারিং (variantFilter ব্লক) ভেরিয়েন্ট সিলেক্টর ব্যবহার করে androidComponents.beforeVariants() দিয়ে পরিবর্তন করুন।
SDK ও NDK কম্পোনেন্ট:
  • sdkDirectory
  • ndkDirectory
  • bootClasspath
  • adbExecutable
androidComponents.sdkComponents ব্যবহার করে SDK কম্পোনেন্ট অ্যাক্সেস করুন।
টেস্ট এনভায়রনমেন্ট:
  • deviceProvider
  • testServer
কাস্টম টেস্ট ডিভাইস রেজিস্ট্রেশন Gradle-এর ম্যানেজ করা ডিভাইসে মাইগ্রেট করুন।
পুরনো রেজিস্ট্রেশন API:
  • registerArtifactType
  • registerBuildTypeSourceProvider
  • registerProductFlavorSourceProvider
  • registerJavaArtifact
  • registerMultiFlavorSourceProvider
  • wrapJavaSourceSet
সরাসরি রিপ্লেসমেন্ট ছাড়াই মুছে ফেলা হয়েছে।
Transform API Artifacts API এবং AsmClassVisitorFactory-এর মাধ্যমে ট্রান্সফর্ম প্রতিস্থাপন করুন।

সব রিপ্লেসমেন্ট DSL ও ভ্যারিয়েন্ট API (androidComponents {}) ইন্টারফেস ও ক্লাস অ্যাক্সেস করতে, কাস্টম Gradle প্লাগ-ইন বা বিল্ড লজিক ডেভেলপ করার সময় সবসময় gradle-api আর্টিফ্যাক্ট ব্যবহার করুন।

মাইগ্রেশনের ধাপ

AGP 10.0-এ আপনার আপগ্রেডকে নির্বিঘ্ন এবং অনুমানযোগ্য করতে সাহায্য করার জন্য, এই মাইগ্রেশন পদ্ধতিগুলি অনুসরণ করুন:

  1. AGP আপগ্রেড অ্যাসিস্ট্যান্ট রান করুন: সরাসরি 10.0-এ আপগ্রেড করার আগে, Android Studio (Tools > AGP Upgrade Assistant)-তে অফিসিয়াল AGP আপগ্রেড অ্যাসিস্ট্যান্ট রান করুন। এটি একাধিক সাধারণ DSL এবং বিল্ড স্ক্রিপ্ট মাইগ্রেশন অটোমেট করে এবং আগে থেকে থাকা বিল্ড আচরণ বজায় রাখতে সাহায্য করে।
  2. Android Studio-তে এজেন্ট মোড স্কিল ব্যবহার করা: AI আপগ্রেড স্কিলের (যেমন Android স্কিল রিপোজিটরি-তে উপলভ্য AGP আপগ্রেড স্কিল) সুবিধা নিন, যাতে Android Studio-র মধ্যে জটিল বিল্ড লজিক ও DSL মাইগ্রেট করার প্রসেস অটোমেট ও সহজ করা যায়।
  3. প্রথমে AGP 9.x-এ ডেপ্রিকেশন সংক্রান্ত সতর্কতা ঠিক করুন: আপনার প্রোজেক্ট লেটেস্ট AGP 9.x রিলিজে আপগ্রেড করুন এবং আগে থেকে থাকা সব ডেপ্রিকেশন সংক্রান্ত সতর্কতা সমাধান করুন। আপনার প্রোজেক্ট 9.x-এর সাথে কোনও সতর্কতা ছাড়াই এবং android.newDsl=false বা android.builtInKotlin=false-এর উপর নির্ভর না করে কাজ করলে, 10.0-এ পরিবর্তন করা সহজ হবে।
  4. থার্ড-পার্টি Gradle প্লাগ-ইন অডিট করুন: থার্ড-পার্টি প্লাগ-ইন AGP 10.0-এর সাথে মানানসই ভার্সনে আপগ্রেড করা হয়েছে কিনা তা নিশ্চিত করুন। পুরনো এক্সটেনশনের ধরনের উপর এখনও নির্ভর করে থাকা প্লাগ-ইন ClassCastException: ... cannot be cast to class BaseExtension-এর মতো বিল্ড সংক্রান্ত সমস্যা তৈরি করবে।
  5. অফিসিয়াল মাইগ্রেশন রেসিপি ব্যবহার করুন: জটিল, বাস্তব-জগতের মাইগ্রেশন উদাহরণ এবং পাশাপাশি তুলনার জন্য, অফিসিয়াল gradle-recipes GitHub রিপোজিটরি দেখুন।

Here is a before-and-after comparison showing how to migrate from eagerly querying legacy variants to lazily configuring variants using androidComponents {}:

আগে: লিগ্যাসি ভ্যারিয়েন্ট API (AGP 10.0-এ সরানো হয়েছে)

// Eager evaluation using the legacy Variant API
android {
    applicationVariants.all { variant ->
        if (variant.buildType.name == "release") {
            // Eagerly queries and modifies properties during evaluation
        }
    }
}

পরে: আধুনিক ভ্যারিয়েন্ট API (androidComponents {})

// Lazy, Configuration Cache compatible Variant API
androidComponents {
    onVariants(selector().withBuildType("release")) { variant ->
        // Safely and lazily configures properties
    }
}

AGP 9.x-এ AGP 10.0-এর আচরণ কীভাবে পরীক্ষা করবেন

AGP 10.0 রিলিজ হওয়ার জন্য আপনাকে অপেক্ষা করতে হবে না, আপনি এখনই এর বিল্ড আচরণ পরীক্ষা করা এবং কম্প্যাটিবিলিটি যাচাই করা শুরু করতে পারেন। যেকোনও AGP 9.x রিলিজ চালানোর সময়, আপনি স্পষ্টভাবে AGP 10.0 আচরণ এনফোর্স করতে পারবেন। এর জন্য আপনাকে যাচাই করতে হবে যে আপনার gradle.properties যেকোনও অপ্ট-আউট বন্ধ করে এবং নিম্নলিখিত কঠোর আচরণ ফ্ল্যাগ সেট করে:

# Enforce modern DSL and Variant API interfaces exclusively
android.newDsl=true

# Enforce built-in Kotlin support without optional opt-out
android.builtInKotlin=true

android.newDsl=true এবং android.builtInKotlin=true এনফোর্স করার মাধ্যমে, আপনি যাচাই করতে পারবেন যে আপনার কাস্টম বিল্ড লজিক এবং থার্ড-পার্টি প্লাগ-ইনগুলি AGP 10.0-এর কঠোর API প্রয়োজনীয়তার সাথে সম্পূর্ণ মানানসই।

মাইগ্রেশনের সময় বেছে নেওয়া সাব-প্রোজেক্ট থেকে বেরিয়ে আসা

আপনি যদি আধুনিক আচরণ পরীক্ষা করার জন্য আপনার প্রোজেক্ট জুড়ে বিশ্বব্যাপী android.newDsl=true সক্ষম করতে চান, কিন্তু নির্দিষ্ট সাব-প্রোজেক্টগুলি মাইগ্রেট করার জন্য আরও সময় প্রয়োজন, আপনি AGP 9.4.0-alpha04 থেকে শুরু করে পৃথক মডিউলগুলি বেছে বেছে অপ্ট আউট করতে পারেন। প্রোজেক্ট পাথ উল্লেখ করে gradle.properties-এ android.newDsl.optOut যোগ করুন:

# Enable modern DSL globally across the build
android.newDsl=true

# Selectively opt out specific sub-projects that still require legacy DSL APIs
android.newDsl.optOut=:lib

প্রতি মডিউলে বেছে নেওয়া বিল্ট-ইন Kotlin বন্ধ করা

আপনি যদি আপনার প্রোজেক্ট জুড়ে বিশ্বব্যাপী বিল্ট-ইন Kotlin চালু করতে চান (android.builtInKotlin=true), কিন্তু নির্দিষ্ট সাব-প্রোজেক্ট kotlin-android থেকে মাইগ্রেট করতে আরও সময় প্রয়োজন (বা Kotlin কোড ছাড়া মডিউলের জন্য), প্রোজেক্ট লেভেলের পরিবর্তে DSL লেভেলে সেই মডিউলগুলি কনফিগার করুন। মডিউলের বিল্ড ফাইলের মধ্যে enableKotlin = false সেট করুন:

android {
    enableKotlin = false
}

মতামত ও বাগ রিপোর্টিং ওয়ার্কফ্লো

আমরা নিশ্চিত করতে চাই যে নতুন ভেরিয়েন্ট API আপনার প্রয়োজনীয় ব্যবহারের ক্ষেত্রে সহায়তা করে। পুরনো API থেকে মাইগ্রেট করার সময় আপনি যদি কোনও সমস্যার সম্মুখীন হন যেখানে নতুন ভেরিয়েন্ট API আপনার ব্যবহারের ক্ষেত্রে মানানসই নয়, তাহলে মতামত জানাতে এই ধাপগুলি অনুসরণ করুন:

  1. আগে থেকে থাকা আইটেম চেক করুন: প্রথমে, AGP 10.0 Variant API Global Tracking Bug চেক করে দেখুন যে আপনার মাইগ্রেশন ব্লকার আগে থেকেই জানা আছে কিনা এবং সমস্যাটিতে +১ করুন।
  2. অনুপস্থিত API সম্পর্কে অভিযোগ জানান: আপনার ব্যবহারের ক্ষেত্র অনন্য হলে, নতুন ফিচার অনুরোধ ফাইল করুন, আমাদের নির্দিষ্ট AGP 10.0 টেমপ্লেট ব্যবহার করে যাতে আমরা তদন্ত করতে এবং সহায়তা করতে পারি।

(সম্ভাব্য) ব্যক্তিগত ইন্টার্নাল AGP ক্লাসের অ্যাক্সেস সরিয়ে দেওয়া হয়েছে

gradle আর্টিফ্যাক্টের উপর নির্ভরতা এখন সব ইন্টার্নাল ক্লাস লুকিয়ে রাখে এবং শুধুমাত্র gradle-api আর্টিফ্যাক্টে উপলভ্য ইন্টারফেস ও ক্লাসে কম্পাইলেশন অ্যাক্সেস দেয়। এটি প্লাগ-ইন কম্পাইলেশনকে প্রভাবিত করে।

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

AGP 9.0 (জানুয়ারি ২০২৬)

নতুন ভেরিয়েন্ট API স্টেবল, পুরনো API অননুমোদিত

Variant API যা 4.1 ও 4.2-এ ইনকিউবেট করা হচ্ছিল, তা এখন স্টেবল এবং gradle-api আর্টিফ্যাক্টে রয়েছে। পুরনো ভেরিয়েন্ট API-তে ব্যবহৃত আগের ইন্টারফেস ও ক্লাস এখন বাতিল করা হয়েছে এবং ব্যবহার করার জন্য স্পষ্টভাবে অপ্ট-ইন করতে হবে।

নতুন DSL ইন্টারফেস স্থিতিশীল, পুরনোটি বন্ধ করা হয়েছে

4.1, 4.2 ও 7.0 ভার্সনে ইনকিউবেট করা DSL ইন্টারফেস এখন স্টেবল এবং gradle-api আর্টিফ্যাক্টে রয়েছে। DSL-এ ব্যবহৃত আগের ইন্টারফেস ও ক্লাস এখন বাতিল করা হয়েছে এবং ব্যবহার করার জন্য স্পষ্টভাবে অপ্ট-ইন করতে হবে।

ব্যক্তিগত ইন্টার্নাল AGP ক্লাস এখনও অ্যাক্সেস করা যাবে

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