KMP এর জন্য Android Gradle Library Plugin সেট আপ করুন

com.android.kotlin.multiplatform.library গ্রেডল প্লাগইনটি হলো একটি কোটলিন মাল্টিপ্ল্যাটফর্ম (KMP) লাইব্রেরি মডিউলে অ্যান্ড্রয়েড টার্গেট যোগ করার জন্য আনুষ্ঠানিকভাবে সমর্থিত টুল। এটি প্রোজেক্ট কনফিগারেশন সহজ করে, বিল্ড পারফরম্যান্স উন্নত করে এবং অ্যান্ড্রয়েড স্টুডিওর সাথে আরও ভালো ইন্টিগ্রেশন প্রদান করে।

KMP ডেভেলপমেন্টের জন্য com.android.library প্লাগইন ব্যবহার করা এমন কিছু Android Gradle Plugin API-এর উপর নির্ভরশীল, যেগুলো Android Gradle plugin 9.0 এবং তার পরবর্তী সংস্করণগুলোতে (২০২৫ সালের চতুর্থ ত্রৈমাসিক) অপ্রচলিত এবং ঐচ্ছিকভাবে ব্যবহারের প্রয়োজন হয় । আশা করা যায়, এই API-গুলো Android Gradle plugin 10.0 (২০২৬ সালের দ্বিতীয়ার্ধে) সংস্করণ থেকে সরিয়ে ফেলা হবে ।

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

AGP 9.0+ মাইগ্রেশনে সাহায্যের জন্য, আপনি JetBrains দ্বারা KMP অ্যাপের জন্য তৈরি এজেন্ট স্কিলটি ব্যবহার করতে পারেন। Android Studio-তে স্কিল ব্যবহার সম্পর্কে আরও তথ্যের জন্য, Extend Agent Mode with skills দেখুন। মনে রাখবেন যে AI-এর ফলাফল সম্পূর্ণরূপে অনুমানযোগ্য নয়।

মূল বৈশিষ্ট্য এবং পার্থক্য

Android-KMP প্লাগইনটি বিশেষভাবে KMP প্রোজেক্টের জন্য তৈরি করা হয়েছে এবং এটি সাধারণ com.android.library প্লাগইন থেকে কয়েকটি গুরুত্বপূর্ণ দিক দিয়ে ভিন্ন:

• একক ভ্যারিয়েন্ট আর্কিটেকচার: প্লাগইনটি প্রোডাক্ট ফ্লেভার এবং বিল্ড টাইপের সমর্থন বাদ দিয়ে একটিমাত্র ভ্যারিয়েন্ট ব্যবহার করে, যা কনফিগারেশনকে সহজ করে এবং বিল্ড পারফরম্যান্স উন্নত করে।

• KMP-এর জন্য অপ্টিমাইজ করা: প্লাগইনটি KMP লাইব্রেরির জন্য ডিজাইন করা হয়েছে, যা শেয়ার্ড কোটলিন কোড এবং ইন্টারঅপারেবিলিটির উপর মনোযোগ দেয় এবং অ্যান্ড্রয়েড-নির্দিষ্ট নেটিভ বিল্ড, AIDL, ও RenderScript-এর সমর্থন বাদ দেয়।

• ডিফল্টরূপে নিষ্ক্রিয় পরীক্ষাসমূহ: বিল্ডের গতি বাড়ানোর জন্য ইউনিট এবং ডিভাইস (ইনস্ট্রুমেন্টেশন) উভয় পরীক্ষাই ডিফল্টরূপে নিষ্ক্রিয় থাকে। প্রয়োজন হলে আপনি এগুলো সক্রিয় করতে পারেন।

• কোনো শীর্ষ-স্তরের অ্যান্ড্রয়েড এক্সটেনশন নেই: Gradle KMP DSL-এর মধ্যে একটি android ব্লকের মাধ্যমে কনফিগারেশন পরিচালিত হয়, যা একটি সামঞ্জস্যপূর্ণ KMP প্রজেক্ট কাঠামো বজায় রাখে। এখানে কোনো শীর্ষ-স্তরের android এক্সটেনশন ব্লক নেই।

• ঐচ্ছিক জাভা কম্পাইলেশন: জাভা কম্পাইলেশন ডিফল্টরূপে নিষ্ক্রিয় থাকে। এটি সক্রিয় করতে android ব্লকে withJava() ব্যবহার করুন। যখন জাভা কম্পাইলেশনের প্রয়োজন হয় না, তখন এটি বিল্ডের সময় উন্নত করে।

অ্যান্ড্রয়েড-কেএমপি লাইব্রেরি প্লাগইনের সুবিধাসমূহ

Android-KMP প্লাগইনটি KMP প্রোজেক্টের জন্য নিম্নলিখিত সুবিধাগুলো প্রদান করে:

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

• উন্নত IDE ইন্টিগ্রেশন: এটি KMP অ্যান্ড্রয়েড লাইব্রেরি নিয়ে কাজ করার সময় আরও ভালো কোড কমপ্লিশন, নেভিগেশন, ডিবাগিং এবং সার্বিক ডেভেলপার অভিজ্ঞতা প্রদান করে।

• সরলীকৃত প্রজেক্ট কনফিগারেশন: এই প্লাগইনটি বিল্ড ভ্যারিয়েন্টের মতো অ্যান্ড্রয়েড-নির্দিষ্ট জটিলতাগুলো দূর করে KMP প্রজেক্টের কনফিগারেশনকে সহজ করে তোলে। এর ফলে বিল্ড ফাইলগুলো আরও পরিচ্ছন্ন এবং সহজে রক্ষণাবেক্ষণযোগ্য হয়। পূর্বে, KMP প্রজেক্টে com.android.library প্লাগইন ব্যবহার করলে androidAndroidTest এর মতো বিভ্রান্তিকর সোর্স সেটের নাম তৈরি হতে পারত। সাধারণ KMP প্রজেক্ট কাঠামোর সাথে পরিচিত ডেভেলপারদের জন্য এই নামকরণের রীতিটি ততটা স্বজ্ঞাত ছিল না।

অসমর্থিত বৈশিষ্ট্যগুলির জন্য বিকল্প সমাধান

com.android.library প্লাগইনের সাথে KMP ইন্টিগ্রেশনের তুলনা করলে, com.android.kotlin.multiplatform.library প্লাগইনে কিছু ফিচার অনুপস্থিত। এই অসমর্থিত ফিচারগুলোর জন্য সমাধানগুলো নিচে দেওয়া হলো:

• বিভিন্ন নির্মাণ

  বিল্ড টাইপ এবং প্রোডাক্ট ফ্লেভার সমর্থিত নয়। এর কারণ হলো, নতুন প্লাগইনটি একটি সিঙ্গেল ভ্যারিয়েন্ট আর্কিটেকচার ব্যবহার করে, যা কনফিগারেশনকে সহজ করে এবং বিল্ড পারফরম্যান্স উন্নত করে।

  আপনার যদি বিল্ড ভ্যারিয়েন্টের প্রয়োজন হয়, তবে আমাদের পরামর্শ হলো com.android.library প্লাগইন ব্যবহার করে একটি পৃথক স্বতন্ত্র অ্যান্ড্রয়েড লাইব্রেরি মডিউল তৈরি করুন, সেই মডিউলের মধ্যে বিল্ড টাইপ এবং প্রোডাক্ট ফ্লেভার কনফিগার করুন, এবং তারপরে আপনার কোটলিন মাল্টিপ্ল্যাটফর্ম লাইব্রেরির androidMain সোর্স সেট থেকে এটিকে একটি স্ট্যান্ডার্ড প্রজেক্ট ডিপেন্ডেন্সি হিসেবে ব্যবহার করুন। আরও বিস্তারিত জানতে, "একটি অ্যান্ড্রয়েড লাইব্রেরি তৈরি করুন" এবং "বিল্ড ভ্যারিয়েন্ট কনফিগার করুন" দেখুন।

• ডেটা বাইন্ডিং এবং ভিউ বাইন্ডিং

  এগুলো হলো অ্যান্ড্রয়েড-নির্দিষ্ট UI ফ্রেমওয়ার্কের বৈশিষ্ট্য, যা অ্যান্ড্রয়েড ভিউ সিস্টেম এবং XML লেআউটের সাথে নিবিড়ভাবে সংযুক্ত। নতুন অ্যান্ড্রয়েড-KMP লাইব্রেরি প্লাগইনে আমরা আপনাকে Compose Multiplatform-এর মতো একটি মাল্টিপ্ল্যাটফর্ম ফ্রেমওয়ার্ক ব্যবহার করে UI পরিচালনা করার পরামর্শ দিই। ডেটা বাইন্ডিং এবং ভিউ বাইন্ডিংকে একটি চূড়ান্ত অ্যান্ড্রয়েড অ্যাপের বাস্তবায়নের খুঁটিনাটি বিষয় হিসেবে বিবেচনা করা হয়, কোনো শেয়ারযোগ্য লাইব্রেরি হিসেবে নয়।

• নেটিভ বিল্ড সমর্থন

  নতুন প্লাগইনটি অ্যান্ড্রয়েড টার্গেটের জন্য একটি স্ট্যান্ডার্ড AAR তৈরিতে মনোযোগ দেয়। Kotlin Multiplatform-এ নেটিভ কোড ইন্টিগ্রেশন সরাসরি KMP-এর নিজস্ব নেটিভ টার্গেট (যেমন androidNativeArm64 এবং androidNativeX86 ) এবং এর C-interop সক্ষমতা দ্বারা পরিচালিত হয়। যদি আপনার নেটিভ C/C++ কোড অন্তর্ভুক্ত করার প্রয়োজন হয়, তবে অ্যান্ড্রয়েড-নির্দিষ্ট externalNativeBuild মেকানিজম ব্যবহার না করে, সেটিকে একটি কমন বা নেটিভ সোর্স সেটের অংশ হিসাবে সংজ্ঞায়িত করা উচিত এবং kotlin ব্লকের মধ্যে C-interop কনফিগার করা উচিত।

  বিকল্পভাবে, যদি আপনার externalNativeBuild মাধ্যমে নেটিভ বিল্ড সাপোর্টের প্রয়োজন হয়, তবে আমাদের পরামর্শ হলো একটি পৃথক স্বতন্ত্র com.android.library মডিউল তৈরি করা, যেখানে আপনি নেটিভ কোড একীভূত করতে পারবেন এবং আপনার কোটলিন মাল্টিপ্ল্যাটফর্ম লাইব্রেরি প্রজেক্টের androidMain সোর্স সেট থেকে সেই স্বতন্ত্র লাইব্রেরিটি ব্যবহার করতে পারবেন। আরও বিস্তারিত জানতে, "একটি অ্যান্ড্রয়েড লাইব্রেরি তৈরি করুন" এবং "আপনার প্রজেক্টে C এবং C++ কোড যোগ করুন" দেখুন।

• BuildConfig ক্লাস

  BuildConfig ফিচারটি মাল্টি-ভেরিয়েন্ট পরিবেশে সবচেয়ে বেশি উপযোগী। যেহেতু নতুন Kotlin Multiplatform লাইব্রেরি প্লাগইনটি ভেরিয়েন্ট-অ্যাগনস্টিক এবং এতে বিল্ড টাইপ ও প্রোডাক্ট ফ্লেভারের সাপোর্ট নেই, তাই এই ফিচারটি ইমপ্লিমেন্ট করা হয়নি। বিকল্প হিসেবে, আমরা সমস্ত টার্গেটের জন্য মেটাডেটা তৈরি করতে BuildKonfig প্লাগইন বা অনুরূপ কমিউনিটি সলিউশন ব্যবহার করার পরামর্শ দিই।

পূর্বশর্ত

com.android.kotlin.multiplatform.library প্লাগইনটি ব্যবহার করার জন্য, আপনার প্রজেক্টটি অবশ্যই নিম্নলিখিত ন্যূনতম সংস্করণ বা তার চেয়ে উচ্চতর সংস্করণ দিয়ে কনফিগার করা থাকতে হবে:

• অ্যান্ড্রয়েড গ্রেডল প্লাগইন (এজিপি) : ৮.১০.০
• কোটলিন গ্রেডল প্লাগইন (কেজিপি) : ২.০.০

একটি বিদ্যমান মডিউলে Android-KMP প্লাগইন প্রয়োগ করুন

বিদ্যমান KMP লাইব্রেরি মডিউলে Android-KMP প্লাগইনটি প্রয়োগ করতে, এই ধাপগুলো অনুসরণ করুন:

1. ভার্সন ক্যাটালগে প্লাগইন ঘোষণা করুন। ভার্সন ক্যাটালগ TOML ফাইলটি (সাধারণত gradle/libs.versions.toml ) খুলুন এবং প্লাগইন ডেফিনিশন সেকশনটি যোগ করুন:

   # To check the version number of the latest Kotlin release, go to
   # https://kotlinlang.org/docs/releases.html
   
   [versions]
   androidGradlePlugin = "9.1.0"
   kotlin = "KOTLIN_VERSION"
   
   [plugins]
   kotlin-multiplatform = { id = "org.jetbrains.kotlin.multiplatform", version.ref = "kotlin" }
   android-kotlin-multiplatform-library = { id = "com.android.kotlin.multiplatform.library", version.ref = "androidGradlePlugin" }
   

2. রুট বিল্ড ফাইলে প্লাগইন ডিক্লারেশন প্রয়োগ করুন। আপনার প্রোজেক্টের রুট ডিরেক্টরিতে অবস্থিত build.gradle.kts ফাইলটি খুলুন। apply false ব্যবহার করে ` plugins ব্লকে প্লাগইন অ্যালিয়াসগুলো যোগ করুন। এর ফলে, রুট প্রোজেক্টে প্লাগইন লজিক প্রয়োগ না করেই প্লাগইন অ্যালিয়াসগুলো সমস্ত সাবপ্রোজেক্টের জন্য উপলব্ধ হয়।

   কোটলিন

   // Root build.gradle.kts file
   
   plugins {
      alias(libs.plugins.kotlin.multiplatform) apply false
   
      // Add the following
      alias(libs.plugins.android.kotlin.multiplatform.library) apply false
   }

   গ্রুভি

   // Root build.gradle file
   
   plugins {
      alias(libs.plugins.kotlin.multiplatform) apply false
   
      // Add the following
      alias(libs.plugins.android.kotlin.multiplatform.library) apply false
   }

3. একটি KMP লাইব্রেরি মডিউল বিল্ড ফাইলে প্লাগইনটি প্রয়োগ করুন। আপনার KMP লাইব্রেরি মডিউলের build.gradle.kts ফাইলটি খুলুন এবং ফাইলের শীর্ষে plugins ব্লকের মধ্যে প্লাগইনটি প্রয়োগ করুন:

   কোটলিন

   // Module-specific build.gradle.kts file
   
   plugins {
      alias(libs.plugins.kotlin.multiplatform)
   
      // Add the following
      alias(libs.plugins.android.kotlin.multiplatform.library)
   }

   গ্রুভি

   // Module-specific build.gradle file
   
   plugins {
      alias(libs.plugins.kotlin.multiplatform)
   
      // Add the following
      alias(libs.plugins.android.kotlin.multiplatform.library)
   }

4. অ্যান্ড্রয়েড কেএমপি টার্গেট কনফিগার করুন। অ্যান্ড্রয়েড টার্গেট নির্ধারণ করতে কোটলিন মাল্টিপ্ল্যাটফর্ম ব্লক ( kotlin ) কনফিগার করুন। kotlin ব্লকের মধ্যে, android : ব্যবহার করে অ্যান্ড্রয়েড টার্গেট নির্দিষ্ট করুন।

   কোটলিন

   kotlin {
      android {
          namespace = "com.example.kmpfirstlib"
          compileSdk = 33
          minSdk = 24
   
          withJava() // enable java compilation support
          withHostTestBuilder {}.configure {}
          withDeviceTestBuilder {
              sourceSetTreeName = "test"
          }
   
          compilerOptions.configure {
              jvmTarget.set(
                  org.jetbrains.kotlin.gradle.dsl.JvmTarget.JVM_1_8
              )
          }
      }
   
      sourceSets {
          androidMain {
              dependencies {
                  // Add Android-specific dependencies here
              }
          }
          getByName("androidHostTest") {
              dependencies {
              }
          }
   
          getByName("androidDeviceTest") {
              dependencies {
              }
          }
      }
      // ... other targets (JVM, iOS, etc.) ...
   }

   গ্রুভি

   kotlin {
      android {
          namespace = "com.example.kmpfirstlib"
          compileSdk = 33
          minSdk = 24
   
          withJava() // enable java compilation support
          withHostTestBuilder {}.configure {}
          withDeviceTestBuilder {
              it.sourceSetTreeName = "test"
          }
   
          compilerOptions.options.jvmTarget.set(
              org.jetbrains.kotlin.gradle.dsl.JvmTarget.JVM_1_8
          )
      }
   
      sourceSets {
          androidMain {
              dependencies {
              }
          }
          androidHostTest {
              dependencies {
              }
          }
          androidDeviceTest {
              dependencies {
              }
          }
      }
      // ... other targets (JVM, iOS, etc.) ...
   }

5. পরিবর্তনগুলি প্রয়োগ করুন। প্লাগইনটি প্রয়োগ এবং kotlin ব্লকটি কনফিগার করার পরে, পরিবর্তনগুলি প্রয়োগ করতে আপনার গ্রেডল প্রজেক্টটি সিঙ্ক করুন।

লিগ্যাসি প্লাগইন থেকে মাইগ্রেট করুন

এই নির্দেশিকাটি আপনাকে পুরোনো com.android.library প্লাগইন থেকে com.android.kotlin.multiplatform.library প্লাগইনে স্থানান্তরিত হতে সাহায্য করবে।

১. উৎস পরিবর্তন

আগের প্লাগইনটি আপনাকে src/ src/androidMain , src/test androidHostTest, এবং src/androidTest এর পাশাপাশি src/ src/main , src/androidHostTest , এবং src/androidDeviceTest সোর্সসেটগুলো ব্যবহার করার সুযোগ দিত। নতুন প্লাগইনটি শুধুমাত্র শেষের সোর্স ডিরেক্টরিগুলো ব্যবহার করে, তাই আপনাকে সোর্সগুলো src/main থেকে src/androidMain এ, src/test থেকে src/androidHostTest এ, এবং src/androidTest থেকে src/androidDeviceTest এ সরিয়ে নিতে হবে।

২. নির্ভরতা ঘোষণা করা

অ্যান্ড্রয়েড-নির্দিষ্ট সোর্স সেটের জন্য ডিপেন্ডেন্সি ঘোষণা করা একটি সাধারণ কাজ। পূর্বে ব্যবহৃত সাধারণ dependencies ব্লকের পরিবর্তে, নতুন প্লাগইনটির জন্য এগুলিকে স্পষ্টভাবে sourceSets ব্লকের মধ্যে রাখতে হবে।

// build.gradle.kts

kotlin {
    android {}
    //... other targets

    sourceSets {
        commonMain.dependencies {
            implementation("org.jetbrains.kotlinx:kotlinx-coroutines-core:1.8.0")
        }

        // Dependencies are now scoped to the specific Android source set
        androidMain.dependencies {
            implementation("androidx.appcompat:appcompat:1.7.0")
            implementation("com.google.android.material:material:1.11.0")
        }
    }
}

// build.gradle.kts

kotlin {
    android {
        compilations.getByName("deviceTest") {
            kotlinOptions.languageVersion = "2.0"
        }
    }
}

// build.gradle.kts

kotlin {
  androidTarget()
  //... other targets
}

// Dependencies for all source sets were often mixed in one block
dependencies {
  // Common dependencies
  commonMainImplementation("org.jetbrains.kotlinx:kotlinx-coroutines-core:1.8.0")

  // Android-specific dependencies
  implementation("androidx.appcompat:appcompat:1.7.0")
  implementation("com.google.android.material:material:1.11.0")
}

৩. অ্যান্ড্রয়েড রিসোর্স সক্রিয় করা

বিল্ড পারফরম্যান্স অপ্টিমাইজ করার জন্য নতুন প্লাগইনটিতে অ্যান্ড্রয়েড রিসোর্স ( res ফোল্ডার)-এর সাপোর্ট ডিফল্টরূপে সক্রিয় করা নেই। এগুলো ব্যবহার করার জন্য আপনাকে অবশ্যই অপ্ট-ইন করতে হবে। এই পরিবর্তনটি নিশ্চিত করতে সাহায্য করে যে, যেসব প্রোজেক্টে অ্যান্ড্রয়েড-নির্দিষ্ট রিসোর্সের প্রয়োজন নেই, সেগুলো যেন এর সাথে সম্পর্কিত বিল্ড ওভারহেডের ভারে জর্জরিত না হয়।

// build.gradle.kts

kotlin {
  android {
    // ...
    // Enable Android resource processing
    androidResources {
      enable = true
    }
  }
}

// Project Structure
// └── src
//     └── androidMain
//         └── res
//             ├── values
//             │   └── strings.xml
//             └── drawable
//                 └── icon.xml

// build.gradle.kts

android {
    namespace = "com.example.library"
    compileSdk = 34
    // No extra configuration was needed to enable resources.
}

// Project Structure
// └── src
//     └── main
//         └── res
//             ├── values
//             │   └── strings.xml
//             └── drawable
//                 └── icon.xml

৪. হোস্ট এবং ডিভাইস পরীক্ষা কনফিগার করা

নতুন প্লাগইনটির একটি উল্লেখযোগ্য পরিবর্তন হলো , অ্যান্ড্রয়েড হোস্ট-সাইড (ইউনিট) এবং ডিভাইস-সাইড (ইনস্ট্রুমেন্টেড) টেস্টগুলো ডিফল্টরূপে নিষ্ক্রিয় থাকে । টেস্ট সোর্স সেট এবং কনফিগারেশন তৈরি করার জন্য আপনাকে স্পষ্টভাবে সম্মতি জানাতে হবে, যেখানে পুরানো প্লাগইনটি এগুলো স্বয়ংক্রিয়ভাবে তৈরি করত।

এই অপ্ট-ইন মডেলটি যাচাই করতে সাহায্য করে যে আপনার প্রজেক্টটি যেন স্বল্পব্যয়ী থাকে এবং এতে কেবল সেই বিল্ড লজিক ও সোর্স সেটগুলোই অন্তর্ভুক্ত থাকে যা আপনি সক্রিয়ভাবে ব্যবহার করেন।

// build.gradle.kts

kotlin {
  android {
    // ...

    // Opt-in to enable and configure host-side (unit) tests
    withHostTest {
      isIncludeAndroidResources = true
    }

    // Opt-in to enable and configure device-side (instrumented) tests
    withDeviceTest {
      instrumentationRunner = "androidx.test.runner.AndroidJUnitRunner"
      execution = "HOST"
    }
  }
}

// Project Structure (After Opt-in)
// └── src
//     ├── androidHostTest
//     └── androidDeviceTest

// build.gradle.kts

android {
  defaultConfig {
    // Runner was configured in defaultConfig
    testInstrumentationRunner = "androidx.test.runner.AndroidJUnitRunner"
  }

  testOptions {
    // Configure unit tests (for the 'test' source set)
    unitTests.isIncludeAndroidResources = true

    // Configure device tests (for the 'androidTest' source set)
    execution = "HOST"
  }
}

// Project Structure (Defaults)
// └── src
//     ├── test
//     └── androidTest

৫. জাভা সোর্স কম্পাইলেশন সক্রিয় করুন

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

// build.gradle.kts

kotlin {
  android {
    //  Opt-in to enable Java source compilation
    withJava()
    // Configure the JVM target for both Kotlin and Java sources
    compilerOptions {
      jvmTarget.set(org.jetbrains.kotlin.gradle.dsl.JvmTarget.JVM_1_8)
    }
  }
  // ...
}

// Project Structure:
// └── src
//     └── androidMain
//         ├── kotlin
//         │   └── com/example/MyKotlinClass.kt
//         └── java
//             └── com.example/MyJavaClass.java

// build.gradle.kts

android {
  // ...
  compileOptions {
    sourceCompatibility = JavaVersion.VERSION_1_8
    targetCompatibility = JavaVersion.VERSION_1_8
  }
}

kotlin {
  androidTarget {
    compilations.all {
      kotlinOptions.jvmTarget = "1.8"
    }
  }
}

৬. androidComponents ব্যবহার করে বিল্ড ভ্যারিয়েন্টগুলোর সাথে ইন্টারঅ্যাক্ট করুন

বিল্ড আর্টিফ্যাক্টগুলোর সাথে প্রোগ্রাম্যাটিকভাবে কাজ করার জন্য androidComponents এক্সটেনশনটি এখনও উপলব্ধ আছে। যদিও Variant এপিআই-এর বেশিরভাগই একই রয়েছে, নতুন AndroidKotlinMultiplatformVariant ইন্টারফেসটি আরও সীমিত, কারণ প্লাগইনটি কেবল একটি ভ্যারিয়েন্ট তৈরি করে।

ফলস্বরূপ, বিল্ড টাইপ এবং প্রোডাক্ট ফ্লেভার সম্পর্কিত প্রোপার্টিগুলো এখন আর ভ্যারিয়েন্ট অবজেক্টে পাওয়া যাবে না।

// build.gradle.kts

androidComponents {
  onVariants { variant ->
      val artifacts = variant.artifacts
  }
}

// build.gradle.kts

androidComponents {
  onVariants(selector().withBuildType("release")) { variant ->
    // ...
  }
}

৭. অ্যান্ড্রয়েড লাইব্রেরি নির্ভরতার বিভিন্ন রূপ নির্বাচন করুন

আপনার KMP লাইব্রেরি অ্যান্ড্রয়েডের জন্য একটিমাত্র ভ্যারিয়েন্ট তৈরি করে। তবে, আপনি একটি স্ট্যান্ডার্ড অ্যান্ড্রয়েড লাইব্রেরির ( com.android.library ) উপর নির্ভর করতে পারেন, যার একাধিক ভ্যারিয়েন্ট রয়েছে (যেমন, free/paid প্রোডাক্ট ফ্লেভার)। আপনার প্রজেক্ট সেই ডিপেন্ডেন্সি থেকে কীভাবে একটি ভ্যারিয়েন্ট নির্বাচন করবে, তা নিয়ন্ত্রণ করা একটি সাধারণ প্রয়োজন।

// build.gradle.kts
kotlin {
  android {
    localDependencySelection {
      // For dependencies with multiple build types, select 'debug' first, and 'release' in case 'debug' is missing
      selectBuildTypeFrom.set(listOf("debug", "release"))

      // For dependencies with a 'type' flavor dimension...
      productFlavorDimension("type") {
        // ...select the 'typeone' flavor.
        selectFrom.set(listOf("typeone"))
      }
    }
  }
}

৮. কম্পোজ প্রিভিউ নির্ভরতা

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

// build.gradle.kts
dependencies {
  "androidRuntimeClasspath"(libs.androidx.compose.ui.tooling)
}

// build.gradle.kts
dependencies {
  debugImplementation(libs.androidx.compose.ui.tooling)
}

৯. KMP অ্যান্ড্রয়েড টার্গেটের জন্য JVM টার্গেট কনফিগার করুন

KMP অ্যান্ড্রয়েড প্লাগইনটি android.compilerOptions.jvmTarget ব্যবহার করে JVM টার্গেট সেট করে, যা জাভা এবং কোটলিন উভয়ের ক্ষেত্রেই প্রযোজ্য। এর ফলে, বিশুদ্ধ অ্যান্ড্রয়েড প্রজেক্টের আলাদা compileOptions এবং kotlinOptions ব্লকের তুলনায় কনফিগারেশন সহজ হয়।

// build.gradle.kts
kotlin {
    jvmToolchain(21)
}

// build.gradle.kts
kotlin {
    android {
        compilerOptions {
            jvmTarget.set(JvmTarget.JVM_11)
        }
    }
}

// build.gradle.kts
kotlin {
    android {
        compilations.all {
            compileTaskProvider.configure {
                compilerOptions.jvmTarget.set(JvmTarget.JVM_11)
            }
        }
    }
}

// build.gradle.kts
kotlin {
    jvmToolchain(21)
}

// build.gradle.kts
android {
    compileOptions {
        sourceCompatibility = JavaVersion.VERSION_11
        targetCompatibility = JavaVersion.VERSION_11
    }

    kotlinOptions {
        jvmTarget = "11"
    }
}

১০. গ্রাহক রাখার নিয়মাবলী প্রকাশ করুন

যদি আপনার KMP লাইব্রেরিকে তার কনজিউমারদের জন্য কনজিউমার কিপ রুল (যেমন R8-এর জন্য ProGuard রুল) সরবরাহ করতে হয়, তাহলে আপনাকে নতুন প্লাগইনটিতে স্পষ্টভাবে পাবলিশিং সক্ষম করতে হবে। পূর্বে, কনজিউমার কিপ রুল নির্দিষ্ট করা থাকলে ডিফল্টরূপে প্রকাশিত হত।

// build.gradle.kts
kotlin {
  android {
    optimization {
      consumerKeepRules.apply {
        publish = true
        file("consumer-proguard-rules.pro")
      }
    }
  }
}

// build.gradle.kts
android {
  defaultConfig {
    consumerProguardFiles("consumer-proguard-rules.pro")
  }
}

১১. আপনার লাইব্রেরিটি Maven-এ প্রকাশ করুন।

অন্যান্য প্রকল্পে ব্যবহারের জন্য যদি আপনি আপনার KMP লাইব্রেরিটি Maven-এ প্রকাশ করার পরিকল্পনা করেন, তবে আপনি নতুন Android-KMP প্লাগইন নাকি লিগ্যাসি প্লাগইন ব্যবহার করছেন, তার উপর নির্ভর করে প্রক্রিয়াটি ভিন্ন হবে।

প্লাগইন এপিআই রেফারেন্স

নতুন প্লাগইনটির এপিআই সারফেস com.android.library থেকে ভিন্ন। নতুন ডিএসএল এবং ইন্টারফেস সম্পর্কে বিস্তারিত তথ্যের জন্য, এপিআই রেফারেন্স দেখুন:

• KotlinMultiplatformAndroidLibraryExtension
• KotlinMultiplatformAndroidLibraryTarget
• KotlinMultiplatformAndroidDeviceTest
• KotlinMultiplatformAndroidHostTest
• KotlinMultiplatformAndroidVariant

Android-KMP লাইব্রেরি প্লাগইনে পরিচিত সমস্যাসমূহ

নতুন com.android.kotlin.multiplatform.library প্লাগইনটি প্রয়োগ করলে এই পরিচিত সমস্যাগুলো দেখা দিতে পারে:

• নতুন অ্যান্ড্রয়েড-কেএমপি প্লাগইন ব্যবহার করার সময় কম্পোজ প্রিভিউ ব্যর্থ হয়।

  • Android Studio Otter 2 Feature Drop | 2025.2.2 Canary 3 এবং Android Gradle Plugin 9.0.0-alpha13 এ সমাধান করা হয়েছে।

• com.android.kotlin.multiplatform.library প্লাগইন সহ Compose মাল্টিপ্ল্যাটফর্ম প্রিভিউতে NullPointerException

  • Android Studio Otter 2 Feature Drop | 2025.2.2 Canary 3 এবং Android Gradle Plugin 9.0.0-alpha13 এ সমাধান করা হয়েছে।

• KMP সাধারণ কম্পাইলেশন ডিপেন্ডেন্সি রেজোলিউশন কনফিগারেশন ক্যাশে সংরক্ষণ করে, যার ফলে ডিসিরিয়ালাইজ করার সময় ত্রুটি দেখা দেয় (শুধুমাত্র অ্যান্ড্রয়েডের ক্ষেত্রে)।

  • Kotlin Gradle Plugin 2.3.0-Beta2 এ সমাধান করা হয়েছে।

• androidLibrary টার্গেটের জন্য ইন্সট্রুমেন্টেড সোর্সসেটট্রি সমর্থন করুন

  • Android Studio Otter 2 Feature Drop | 2025.2.2 Canary 3 এবং Android Gradle Plugin 9.0.0-alpha13 এ সমাধান করা হয়েছে।