محیط خود را تنظیم کنید (کوتلین چند پلتفرم)

Kotlin Multiplatform (KMP) به اشتراک گذاری کد Kotlin را در پلتفرم های مختلف امکان پذیر می کند. قبل از شروع ساختن برنامه ها با KMP، باید محیط خود را همانطور که در این سند توضیح داده شده است تنظیم کنید. همچنین می توانید به مستندات رسمی Jetbrain مراجعه کنید.

ابزارهای مورد نیاز را نصب یا به روز کنید

• آخرین نسخه پایدار Android Studio را نصب یا به‌روزرسانی کنید.
• برای جلوگیری از مشکلات سازگاری، افزونه Kotlin را که با Android Studio همراه است به آخرین نسخه به روز کنید.
• (اختیاری) برای توسعه iOS، Xcode را برای ساخت رابط کاربری نصب کنید و در صورت نیاز کد Swift یا Objective-C را اضافه کنید.

یک پروژه چند پلتفرمی Kotlin ایجاد کنید

می توانید از جادوگر چند پلتفرم Kotlin از Jetbrains برای ایجاد یک پروژه جدید KMP استفاده کنید. مطمئن شوید که گزینه Do not share UI را انتخاب کنید تا UI بومی بماند.

ساختار پروژه

پروژه های KMP از ساختار پروژه ای مشابه پروژه های اندروید پیروی می کنند.

یک پروژه KMP شامل ماژول های پلتفرم خاص به همراه یک ماژول مشترک است. کد مخصوص پلتفرم خود را به ماژول مربوطه اضافه کنید. برای مثال، رابط کاربری برنامه Android خود را در ماژول androidApp و رابط کاربری برنامه iOS خود را در iosApp اضافه کنید. هر کدی که می‌خواهید بین پلتفرم‌ها به اشتراک بگذارید، در ماژول مشترک قرار می‌گیرد.

ماژول مشترک از Gradle به عنوان سیستم ساخت مانند بقیه پروژه استفاده می کند. می‌توانید وابستگی‌های رایج و خاص پلتفرم را با استفاده از مجموعه‌های منبع اعلام کنید. به عنوان مثال، اگر برنامه شما از Ktor برای شبکه استفاده می کند، باید یک وابستگی OkHttp برای اندروید و یک وابستگی داروین برای iOS اضافه کنید. توجه داشته باشید که برخی از کتابخانه ها فقط به وابستگی های رایج نیاز دارند و نیازی به وابستگی های خاص پلت فرم ندارند.

sourceSets {
   commonMain.dependencies {
       //put your multiplatform dependencies here
       //...
       implementation(libs.ktor.client.core)
       implementation(libs.ktor.client.content.negotiation)
       implementation(libs.ktor.serialization.kotlinx.json)
       //...
   }
   androidMain.dependencies {
       implementation(libs.ktor.client.okhttp)
   }
   iosMain.dependencies {
       implementation(libs.ktor.client.darwin)
   }
}

هنگامی که یک کتابخانه جدید به ماژول مشترک برنامه خود اضافه می کنید، مطمئن شوید که وابستگی های مورد نیاز برای هر پلتفرم را بررسی کنید.