আগে থেকে থাকা প্রোজেক্টে Kotlin Multiplatform যোগ করা

আপনার Android প্রোজেক্টের মধ্যে Kotlin Multiplatform (KMP) মডিউল তৈরি করতে, Kotlin Multiplatform Shared Module টেমপ্লেট ব্যবহার করুন, যা Android Studio Meerkat এবং Android Gradle Plugin 8.8.0 এবং তার পরবর্তী ভার্সনে উপলভ্য।

মডিউল টেমপ্লেট Android ও iOS প্ল্যাটফর্মকে টার্গেট করে ন্যূনতম কনফিগারেশন সহ নতুন মডিউল অটোমেটিক তৈরি করে। KMP-তে ডেস্কটপ ও ওয়েবের মতো অন্যান্য টার্গেটও কাজ করে, যা আপনি পরে মডিউলে যোগ করতে পারবেন। সম্পূর্ণ তালিকা দেখতে, কাজ করে এমন প্ল্যাটফর্মের স্টেবিলিটি দেখুন। টার্গেট ঘোষণা করতে, মাল্টিপ্ল্যাটফর্ম Gradle DSL রেফারেন্সে টার্গেট দেখুন।

মনে রাখবেন: আপনি iOS অ্যাপ তৈরি করতে চাইলে, আপনার কাছে Xcode ইনস্টল করা macOS মেশিন থাকতে হবে। এছাড়াও, অ্যাপটি চালানোর জন্য আপনাকে একটি iOS সিমুলেটর ইনস্টল করতে হবে, অথবা একটি iPhone ডেভেলপ করার জন্য প্রস্তুত থাকতে হবে।

শেয়ার করা KMP মডিউল সেট-আপ করুন

শেয়ার করা KMP মডিউল তৈরি করতে, এই ধাপগুলি অনুসরণ করুন:

1. ফাইল > নতুন > নতুন মডিউল বিকল্প বেছে নিন
2. টেমপ্লেট প্যানেলে Kotlin Multiplatform Shared Module টেমপ্লেট বেছে নিন:

ছবি ১. নতুন KMP মডিউল তৈরি করা হচ্ছে

টেমপ্লেটে নিম্নলিখিত ফিল্ডগুলি রয়েছে:

• মডিউলের নাম – Gradle মডিউলের নাম এবং iOS ফ্রেমওয়ার্কের নাম সংজ্ঞায়িত করে (পরে পরিবর্তন করা যেতে পারে)
• প্যাকেজের নাম – এই মডিউলে ফাইলের জন্য প্যাকেজের নাম নির্ধারণ করে
  1. শেষ করুন বিকল্পে ক্লিক করুন এবং Gradle-কে প্রোজেক্টের সাথে সিঙ্ক করার অনুমতি দিন। এছাড়াও, আপনাকে সোর্স কন্ট্রোলে নতুন তৈরি করা মডিউল ফাইল যোগ করার জন্য প্রম্পট করা হতে পারে।

মনে রাখবেন: তৈরি করা মডিউলে কিছু প্রাথমিক প্লেসহোল্ডার ফাংশন ও টেস্ট অন্তর্ভুক্ত থাকে। এইসব প্লেসহোল্ডার ফাংশন নিশ্চিত করে যে মডিউলটি কম্পাইল করে এবং সফলভাবে রান করে।

সম্পূর্ণ হয়ে গেলে, Android Studio প্রোজেক্ট ভিউ প্রতিটি প্ল্যাটফর্মের জন্য সোর্সসেটের সাথে নতুন শেয়ার করা মডিউল দেখায়।

ছবি ২. প্রোজেক্ট ভিউতে নতুন শেয়ার করা মডিউল দেখানো হচ্ছে

Android অ্যাপে শেয়ার করা মডিউল লিঙ্ক করুন

মডিউল উইজার্ড নতুন তৈরি করা মডিউলকে আগে থেকে থাকা কোনও মডিউলের ডিপেন্ডেন্সি হিসেবে যোগ করে না। পরবর্তী ধাপ হিসেবে, আপনাকে শেয়ার করা মডিউলটি আপনার আগে থেকে থাকা কোনও একটি Gradle মডিউলের সাথে লিঙ্ক করতে হবে, ঠিক যেমন অন্যান্য Android ডিপেন্ডেন্সির ক্ষেত্রে করা হয়:

dependencies {
    ...
    implementation(project(":shared"))
}

মনে রাখবেন: আপনার প্রোজেক্টে Gradle-এর টাইপ-সেফ প্রোজেক্ট অ্যাক্সেসর ফিচার চালু থাকলে, আপনি projects.shared-এর মাধ্যমে শেয়ার করা মডিউল অ্যাক্সেস করতে পারবেন।

চালু হয়ে গেলে, আপনি আগের মতোই অ্যাক্সেস কোড ব্যবহার করতে পারবেন। Android অ্যাপ থেকে, আপনি androidMain বা commonMain-এ উপলভ্য কোড অ্যাক্সেস করতে পারবেন।

Kotlin Multiplatform প্রোজেক্ট স্ট্রাকচার সম্পর্কে আরও জানতে, Kotlin Multiplatform প্রোজেক্ট স্ট্রাকচারের প্রাথমিক তথ্য দেখুন

iOS অ্যাপে শেয়ার করা মডিউল সেট-আপ করুন

Swift সরাসরি Kotlin মডিউল ব্যবহার করতে পারে না এবং এর জন্য একটি কম্পাইল করা বাইনারি ফ্রেমওয়ার্ক তৈরি করতে হয়।

মনে রাখবেন: Kotlin Gradle প্লাগ-ইন, Kotlin ও Native (iOS)-এর জন্য তৈরি করা সাধারণ কোড শেয়ার ও ব্যবহার করার জন্য Swift প্যাকেজ ম্যানেজার ইন্টিগ্রেশন বা Cocoapods ইন্টিগ্রেশন-কেও সাপোর্ট করে।

Android Studio-তে নতুন মডিউল টেমপ্লেট, প্রতিটি iOS আর্কিটেকচারের জন্য ফ্রেমওয়ার্ক তৈরি করতে শেয়ার করা মডিউল কনফিগার করে। আপনি শেয়ার করা মডিউলের build.gradle.kts ফাইলে নিম্নলিখিত কোডটি খুঁজে পাবেন:

val xcfName = "sharedKit"

iosX64 {
  binaries.framework {
    baseName = xcfName
  }
}

iosArm64 {
  binaries.framework {
    baseName = xcfName
  }
}

iosSimulatorArm64 {
  binaries.framework {
    baseName = xcfName
  }
}

অন্যান্য আর্কিটেকচারের ধরন নির্ধারণ করার ব্যাপারে তথ্য পেতে হায়ারার্কিক্যাল প্রোজেক্ট স্ট্রাকচার দেখুন।

মনে রাখবেন: আউটপুট ফ্রেমওয়ার্ককে ডিফল্ট হিসেবে sharedKit বলা হয়, যেমনটি শেয়ার করা মডিউলের build.gradle.kts ফাইলে উল্লেখ করা আছে। আপনার নিজের প্রোজেক্টে, xcfName ভেরিয়েবল কন্ট্রোল করে প্রয়োজন অনুযায়ী এটির নাম পরিবর্তন করতে পারবেন।

iOS প্রোজেক্টে শেয়ার করা লাইব্রেরি লিঙ্ক করুন

iOS প্রোজেক্ট থেকে শেয়ার করা কোডে অ্যাক্সেস চালু করতে, Swift সোর্স কম্পাইল করার আগে Kotlin ফ্রেমওয়ার্ক জেনারেট করার জন্য একটি স্ক্রিপ্ট ফেজ যোগ করুন:

মনে রাখবেন: আপনি Finder-এ xcodeproj ফাইলে ডবল ক্লিক করেও Xcode প্রোজেক্ট খুলতে পারবেন।

1. Android Studio-তে ফাইলের উপর মাউস রেখে ডানদিকের বোতামে ক্লিক করুন এবং এতে খুলুন ও সংশ্লিষ্ট অ্যাপ্লিকেশনে খুলুন বিকল্প বেছে নিন। এটি Xcode-এ iOS অ্যাপ খুলবে।

ছবি ৩. সংশ্লিষ্ট অ্যাপ্লিকেশনে খুলুন

1. প্রোজেক্ট নেভিগেটরে প্রোজেক্টের নামের উপর ডবল ক্লিক করে প্রোজেক্ট সেটিংস খুলুন

ছবি ৪. Xcode প্রোজেক্ট সেটিংস ডায়ালগ

1. এই ফেজ কী করে তা আরও ভালভাবে শনাক্ত করতে, ডিফল্ট রান স্ক্রিপ্ট নাম পরিবর্তন করে Kotlin ফ্রেমওয়ার্ক কম্পাইল করুন করুন। স্ক্রিপ্ট চালান শীর্ষক এডিট করতে এটিতে ডবল ক্লিক করুন।
2. বিল্ড ফেজ বড় করুন এবং শেল টেক্সট ফিল্ডে, নিম্নলিখিত স্ক্রিপ্ট কোড লিখুন:

ছবি ৫. স্ক্রিপ্ট বিল্ড ফেজ চালান

মনে রাখবেন: cd "$SRCROOT/.." স্ক্রিপ্টকে KMP Gradle প্রোজেক্টের রুট ফোল্ডারে নেভিগেট করে, যা এই ক্ষেত্রে একটি পেরেন্ট ফোল্ডার। আপনার ক্ষেত্রে iOS প্রোজেক্ট অন্য কোনও পাথে থাকলে, আপনাকে এখানে সেটি পরিবর্তন করতে হবে।

1. Compile Sources ফেজের আগে Run Script ফেজ টেনে আনুন।

   

   ছবি ৬. সোর্স কম্পাইল করার আগে স্ক্রিপ্ট বিল্ড ফেজ চালান

2. ⌘B-এ ক্লিক করে অথবা প্রোডাক্ট মেনুতে গিয়ে এবং বিল্ড বেছে নিয়ে Xcode-এ প্রোজেক্ট বিল্ড করুন।

বিল্ড সফল হলে, আপনি নিম্নলিখিত আইকন দেখতে পাবেন।

ছবি ৭. বিল্ড সম্পূর্ণ হয়েছে

iOS অ্যাপে শেয়ার করা কোড অ্যাক্সেস করুন

iOS অ্যাপ শেয়ার করা মডিউল থেকে কোড অ্যাক্সেস করতে পারছে কিনা তা যাচাই করতে, নিম্নলিখিত ধাপগুলি অনুসরণ করুন:

1. iOS প্রোজেক্টে, এখানে ContentView.swift ফাইল খুলুন: Sources/View/ContentView.swift
2. ফাইলের সবচেয়ে উপরে ইমপোর্ট sharedKit যোগ করুন।
3. নিচে দেখানো স্ট্রিংয়ের মতো টেক্সট ভিউ পরিবর্তন করে Platform_iosKt.platform() তথ্য যোগ করুন:

মনে রাখবেন: Swift-এ স্ট্রিং ইন্টারপোলেশন (কোড) সিনট্যাক্স ব্যবহার করে।

এই আপডেট চেক করে যে অ্যাপটি শেয়ার করা মডিউল থেকে platform() ফাংশন কল করতে পারে কিনা, যা iOS প্ল্যাটফর্মে রান করার সময় "iOS" রিটার্ন করবে।

ছবি ৮. iOS অ্যাপ চালানো Xcode সিমুলেটর

অতিরিক্ত রিসোর্স

• আপনি KMP ডেভেলপমেন্টে নতুন হলে, আরও গাইডের জন্য অফিসিয়াল KMP ডকুমেন্টেশন দেখুন।
• আপনি iOS ডেভেলপমেন্টে নতুন হলে, Swift Basics ডকুমেন্টেশন দেখুন।
• KMP সেট-আপ সংক্রান্ত সাধারণ সমস্যার জন্য, KMP কুইকস্টার্টে সমস্যার সমাধানকরণ দেখুন।
• স্যাম্পেল অ্যাপের জন্য, Android Kotlin Multiplatform Samples দেখুন।