Kotlin Academy · Pelajaran

Struktur Projek KMP: commonMain, androidMain, iosMain

Fahami hierarki set sumber dan cara kod dikongsi merentasi sasaran.

Pelajaran 1 daripada 413 langkah

Struktur Projek KMP: commonMain, androidMain, iosMain ialah pelajaran Kotlin Academy percuma di CoddyKit. Ini ialah pelajaran 1 daripada 4. Sebanyak 3 pelajaran dalam laluan pembelajaran ini boleh dibaca sepenuhnya secara percuma — selepas itu, CoddyKit PRO membuka akses kepada semua pelajaran, serta latihan praktikal dengan penyunting kod terbina dalam dan tutor kecerdasan buatan yang tersedia 24/7. Pelajaran ini merupakan sebahagian daripada laluan pembelajaran Kotlin Academy, dan kemajuan anda disegerakkan merentas web serta aplikasi CoddyKit. Kursus Kotlin Academy merangkumi sejumlah 4 pelajaran.

Apakah KMP?

Kotlin Multiplatform (KMP) membolehkan Anda menulis kod Kotlin dikongsi yang dikompilkan kepada JVM, Android, iOS (melalui Kotlin/Native) dan JS. Kod khusus platform diletakkan dalam set sumber yang berasingan.

// Typical KMP module structure:
// shared/
//   src/
//     commonMain/kotlin/   <- shared code
//     androidMain/kotlin/  <- Android-only
//     iosMain/kotlin/      <- iOS-only
//     commonTest/kotlin/   <- shared tests
fun main() { println("KMP: one codebase, many targets") }

Hierarki Set Sumber

Set sumber membentuk hierarki. commonMain ialah akar; androidMain dan iosMain bergantung padanya. Kod dalam commonMain kelihatan kepada semua sasaran.

// build.gradle.kts (Kotlin DSL)
kotlin {
    androidTarget()
    iosX64()
    iosArm64()
    iosSimulatorArm64()

    sourceSets {
        val commonMain by getting {
            dependencies { /* shared deps */ }
        }
        val androidMain by getting
        val iosMain by getting
    }
}

commonMain: Logik Dikongsi

Letakkan logik perniagaan, model domain, repositori dan kes penggunaan dalam commonMain. Kod ini dikompilkan untuk semua sasaran.

// commonMain/kotlin/com/example/domain/User.kt
data class User(val id: String, val name: String, val email: String)

// commonMain/kotlin/com/example/repository/UserRepository.kt
interface UserRepository {
    suspend fun getUser(id: String): User?
    suspend fun saveUser(user: User)
}

androidMain: Khusus Android

androidMain boleh menggunakan kelas SDK Android. Kegunaan biasa: pelaksanaan khusus Android bagi pengisytiharan expect/actual.

// androidMain/kotlin/com/example/platform/PlatformLogger.kt
import android.util.Log
class AndroidLogger : Logger {
    override fun log(msg: String) = Log.d("App", msg)
}
// androidMain/kotlin/com/example/di/PlatformModule.kt
// Koin or Hilt module that binds AndroidLogger to Logger

iosMain: Khusus iOS

iosMain mempunyai akses kepada rangka kerja Apple melalui saling kendali Kotlin/Native. Gunakannya untuk pelaksanaan API expect/actual pada iOS.

// iosMain/kotlin/com/example/platform/PlatformLogger.kt
import platform.Foundation.NSLog
class IosLogger : Logger {
    override fun log(msg: String) = NSLog(msg)
}
// iOS uses Kotlin/Native runtime; no JVM here

Konfigurasi Gradle untuk Sasaran iOS

Untuk iOS, Anda biasanya mengisytiharkan tiga sasaran: x64 (simulator pada Intel), arm64 (peranti) dan simulatorArm64 (simulator pada Apple Silicon).

// build.gradle.kts
kotlin {
    iosX64()
    iosArm64()
    iosSimulatorArm64()
    sourceSets {
        val iosMain by creating {
            dependsOn(commonMain.get())
        }
        val iosX64Main by getting { dependsOn(iosMain) }
        val iosArm64Main by getting { dependsOn(iosMain) }
        val iosSimulatorArm64Main by getting { dependsOn(iosMain) }
    }
}

Kebergantungan Dikongsi dalam commonMain

Tambahkan kebergantungan dikongsi (Ktor, SQLDelight, kotlinx.serialization, Koin) ke commonMain. Pemacu khusus platform diletakkan dalam set sumber platform.

// commonMain dependencies example:
// implementation("io.ktor:ktor-client-core:2.3.0")
// implementation("org.jetbrains.kotlinx:kotlinx-serialization-json:1.5.1")
// implementation("io.insert-koin:koin-core:3.4.0")

// androidMain:
// implementation("io.ktor:ktor-client-okhttp:2.3.0")
// iosMain:
// implementation("io.ktor:ktor-client-darwin:2.3.0")

commonTest: Ujian Dikongsi

Ujian dalam commonTest dijalankan pada semua sasaran. Gunakan pustaka ujian Kotlin dan tulis ujian unit yang tidak bergantung pada sasaran untuk logik perniagaan yang dikongsi.

// commonTest/kotlin/UserRepositoryTest.kt
import kotlin.test.Test
import kotlin.test.assertEquals
class UserRepositoryTest {
    @Test
    fun testUserCreation() {
        val user = User("1", "Alice", "alice@example.com")
        assertEquals("Alice", user.name)
    }
}

Set Sumber Perantaraan

Anda boleh mencipta set sumber perantaraan yang dikongsi antara subset sasaran, contohnya nativeMain untuk semua sasaran natif atau appleMain untuk iOS + macOS.

// Create appleMain shared between iOS and macOS:
sourceSets {
    val appleMain by creating { dependsOn(commonMain.get()) }
    val iosMain by getting { dependsOn(appleMain) }
    val macosMain by getting { dependsOn(appleMain) }
}

Susun Atur Fail Projek

Pepohon direktori modul dikongsi KMP yang biasa, dengan pemisahan tanggungjawab yang jelas.

// shared/
//   build.gradle.kts
//   src/
//     commonMain/kotlin/
//       domain/           User.kt, Post.kt
//       repository/       UserRepository.kt
//       usecase/          GetUserUseCase.kt
//     androidMain/kotlin/
//       repository/       RoomUserRepository.kt
//     iosMain/kotlin/
//       repository/       CoreDataUserRepository.kt
//     commonTest/kotlin/  GetUserUseCaseTest.kt

Integrasi CocoaPods / SPM

Pemalam Gradle KMP menjana XCFramework (atau pod CocoaPods) yang Anda tambahkan ke projek Xcode, lalu mendedahkan kod Kotlin dikongsi sebagai rangka kerja natif.

// build.gradle.kts for CocoaPods:
kotlin {
    cocoapods {
        name = "Shared"
        version = "1.0"
        ios.deploymentTarget = "14.0"
        framework { baseName = "Shared" }
    }
}
// Run: ./gradlew :shared:podPublishReleaseXCFramework

Semakan Pantas

Di manakah logik perniagaan dikongsi (model domain, kes penggunaan) patut diletakkan dalam projek KMP?

Imbas Kembali

commonMain menyimpan logik dikongsi (domain, repositori, kes penggunaan). androidMain/iosMain menyimpan pelaksanaan platform. commonTest menjalankan ujian pada semua sasaran. Kebergantungan dibahagikan: API dikongsi dalam commonMain, pemacu platform dalam set sumber platform.

Percuma untuk bermula

Pelajari Kotlin dengan tutor kecerdasan buatan — percuma

Tulis dan jalankan kod sebenar dalam pelayar anda, dapatkan bantuan segera daripada tutor kecerdasan buatan yang tersedia 24/7, dan sambung semula dari tempat anda berhenti di web atau dalam aplikasi.

Kursus
51
Pelajaran
203

Soalan Lazim

Adakah pelajaran “Struktur Projek KMP: commonMain, androidMain, iosMain” percuma?

Ya — sebanyak 3 pelajaran dalam laluan pembelajaran Kotlin Academy, termasuk “Struktur Projek KMP: commonMain, androidMain, iosMain”, boleh dibaca sepenuhnya secara percuma di web ini. Selepas itu, CoddyKit PRO membuka akses kepada semua pelajaran, serta latihan interaktif dengan penyunting kod terbina dalam dan tutor kecerdasan buatan yang tersedia 24/7. Kursus Kotlin Academy merangkumi sejumlah 4 pelajaran.

Apakah yang akan saya pelajari dalam “Struktur Projek KMP: commonMain, androidMain, iosMain”?

Fahami hierarki set sumber dan cara kod dikongsi merentasi sasaran. Anda berlatih Kotlin Academy menggunakan kod praktikal yang dijalankan terus dalam pelayar, manakala tutor kecerdasan buatan 24/7 menjawab soalan anda semasa anda mengikuti pelajaran.

Adakah saya memerlukan pengalaman untuk memulakan Kotlin Academy?

Tiada pengalaman terdahulu diperlukan. Pembelajaran Kotlin Academy di CoddyKit disusun untuk pelajar daripada peringkat pemula hingga lanjutan, jadi anda boleh bermula di sini atau dari awal dan belajar mengikut kadar anda sendiri. Ini ialah pelajaran 1 daripada 4.

Berapa lamakah pelajaran “Struktur Projek KMP: commonMain, androidMain, iosMain” diambil?

Kebanyakan pelajaran CoddyKit mengambil masa kira-kira 5–10 minit. Setiap pelajaran ringkas dan interaktif, jadi anda boleh membuat kemajuan secara berterusan dan menyambung tepat dari tempat anda berhenti di web atau aplikasi.

Bolehkah saya menulis dan menjalankan kod dalam pelajaran Kotlin Academy ini?

Ya. Setiap pelajaran Kotlin Academy menyertakan penyunting kod terbina dalam, jadi anda boleh menulis dan menjalankan kod sebenar terus dalam pelayar serta menerima maklum balas kecerdasan buatan serta-merta — tanpa memerlukan persediaan setempat.

Semua pelajaran dalam kursus ini

  1. Struktur Projek KMP: commonMain, androidMain, iosMain
  2. Mekanisme expect/actual untuk API Platform
  3. Berkongsi Lapisan Repository dan Use Case
  4. Suntikan Kebergantungan dalam KMP dengan Koin
← Kembali ke Kotlin Academy