Kotlin多平台项目

介绍[编辑 | 编辑源代码]

Kotlin多平台项目（Kotlin Multiplatform Projects, KMP）是Kotlin语言提供的一项跨平台开发技术，允许开发者使用同一套Kotlin代码在多个目标平台（如JVM、JavaScript、Native等）上运行。KMP通过共享核心业务逻辑，同时保留平台特定的UI和功能实现，显著提高了代码复用率并减少了开发成本。

KMP的核心优势包括：

代码复用：共享业务逻辑，减少重复代码。
平台特定优化：允许在必要时使用平台原生API。
渐进式采用：可逐步将现有项目迁移到多平台架构。

核心概念[编辑 | 编辑源代码]

多平台模块结构[编辑 | 编辑源代码]

Kotlin多平台项目的模块结构通常包含：

Common模块：包含跨平台共享的代码。
平台特定模块（如JVM、JS、Native）：实现平台相关逻辑。

预期与实际声明[编辑 | 编辑源代码]

Kotlin使用特殊的注解和关键字来标记多平台代码：

expect：在common模块中声明预期的API
actual：在平台模块中提供具体实现

// Common模块
expect fun getPlatformName(): String

// JVM模块
actual fun getPlatformName(): String = "JVM"

// JS模块
actual fun getPlatformName(): String = "JavaScript"

项目配置[编辑 | 编辑源代码]

基本Gradle配置[编辑 | 编辑源代码]

多平台项目通过Gradle插件配置。以下是典型配置示例：

plugins {
    kotlin("multiplatform") version "1.9.0"
}

kotlin {
    jvm() // JVM目标
    js(IR) { // JavaScript目标
        browser()
    }
    iosArm64() // iOS目标
    
    sourceSets {
        val commonMain by getting {
            dependencies {
                implementation(kotlin("stdlib-common"))
            }
        }
        val jvmMain by getting {
            dependencies {
                implementation(kotlin("stdlib-jdk8"))
            }
        }
    }
}

依赖管理[编辑 | 编辑源代码]

Kotlin多平台项目支持三种依赖类型： 1. Common依赖：所有平台共享 2. 平台特定依赖：仅特定平台使用 3. 多平台库：专门为KMP设计的库

代码共享策略[编辑 | 编辑源代码]

层级架构[编辑 | 编辑源代码]

KMP推荐采用分层架构实现代码共享：

共享方式[编辑 | 编辑源代码]

完全共享：所有平台使用相同实现
部分共享：部分平台共享，其他平台使用特定实现
平台特定：完全不共享

实际案例[编辑 | 编辑源代码]

跨平台网络请求[编辑 | 编辑源代码]

以下示例展示如何在多平台项目中实现网络请求：

// Common模块
expect class HttpClient() {
    fun get(url: String): String
}

// JVM实现
actual class HttpClient actual constructor() {
    actual fun get(url: String): String {
        return java.net.URL(url).readText()
    }
}

// JS实现
actual class HttpClient actual constructor() {
    actual fun get(url: String): String {
        return js("fetch(url).then(response => response.text())") as String
    }
}

跨平台序列化[编辑 | 编辑源代码]

使用`kotlinx.serialization`实现多平台序列化：

@Serializable
data class User(val id: Int, val name: String)

// Common使用
fun parseUser(json: String): User = Json.decodeFromString<User>(json)

// 平台特定JSON配置
expect val json: Json

// JVM实现
actual val json: Json = Json { prettyPrint = true }

// JS实现
actual val json: Json = Json { ignoreUnknownKeys = true }