Kotlin Academy · 课时

平台 API

Q: 「平台 API」这节课中我会学到什么？

访问原生功能 你通过在浏览器中直接运行的动手代码来练习 Kotlin Academy，全天候 AI 导师会在你学习这节课的过程中回答你的问题。

访问原生功能

平台 API 是 CoddyKit 上的免费 Kotlin Academy 课时。这是第 4 节课，共 4 节。你可以在下方免费阅读本课时的完整内容 — 然后在浏览器中使用内置代码编辑器和全天候 AI 导师进行实践。这是 Kotlin Academy 学习路径的一部分，你的进度在网页和 CoddyKit 应用中同步。 Kotlin Academy 课程共包含 4 节课。

访问原生功能

共享代码有时需要使用设备功能——存储、设置、时钟和网络引擎。KMM 提供了多种方式，可以简洁地访问原生接口。

使用 expect/actual 处理基本类型

对于较小的平台值，请使用 expect/actual。这样可以保持公共代码简洁，同时由各个平台补充具体实现。

// commonMain
expect fun currentTimeMillis(): Long

// androidMain
actual fun currentTimeMillis(): Long = System.currentTimeMillis()

平台代码的依赖注入

一种更加灵活的方式是：在公共代码中定义接口，然后从各个应用注入平台实现。

// commonMain
interface Storage {
    fun save(key: String, value: String)
    fun load(key: String): String?
}

Android 实现

Android 使用 SharedPreferences 实现该接口，并将其提供给共享代码。

// androidMain
import android.content.SharedPreferences

class AndroidStorage(private val prefs: SharedPreferences) : Storage {
    override fun save(key: String, value: String) {
        prefs.edit().putString(key, value).apply()
    }
    override fun load(key: String): String? = prefs.getString(key, null)
}

iOS 实现

iOS 使用 Foundation 框架中的 NSUserDefaults 实现同一个接口。

// iosMain
import platform.Foundation.NSUserDefaults

class IosStorage : Storage {
    private val defaults = NSUserDefaults.standardUserDefaults
    override fun save(key: String, value: String) = defaults.setObject(value, key)
    override fun load(key: String): String? = defaults.stringForKey(key)
}

调用原生 iOS 接口

您可以从 iosMain 直接调用 Apple 框架，因为 Kotlin/Native 会为这些框架生成互操作绑定。

import platform.UIKit.UIDevice

fun deviceModel(): String = UIDevice.currentDevice.model

调用 Android 接口

androidMain 可以使用完整的 Android SDK，因为它是针对 Android 平台编译的。

import android.os.Build

fun deviceModel(): String = Build.MODEL

现成的多平台库

很多时候，您不需要自定义互操作。现有库已经封装了常见功能：

multiplatform-settings — 键值存储
Ktor — 网络通信
SQLDelight — 本地数据库

提供实现

在应用启动时注入平台实现，通常会使用 Koin 之类的 DI 框架，以便共享代码获得正确的实现。

// Android: provide AndroidStorage(prefs)
// iOS: provide IosStorage()
// Shared Repository(storage) uses whichever was injected

选择方法

指南：

微小值 → expect/actual
包含多个方法的行为 → 接口 + 注入
常见需求 → 使用现有的多平台库

可运行的抽象示例

接口的思路就是普通的 Kotlin 代码。在这里，内存中的实现代替了平台存储。

interface Storage {
    fun save(key: String, value: String)
    fun load(key: String): String?
}

class MemoryStorage : Storage {
    private val map = mutableMapOf<String, String>()
    override fun save(key: String, value: String) { map[key] = value }
    override fun load(key: String): String? = map[key]
}

fun main() {
    val s: Storage = MemoryStorage()
    s.save("name", "Ada")
    println(s.load("name"))
}

快速检查

您需要一个包含多个方法的存储功能，它在各个平台上的实现不同，同时还应便于测试。推荐采用哪种方式？

回顾

您可以简洁地使用原生功能：

使用 expect/actual 处理基本类型
使用公共接口和注入的平台实现处理行为
在 androidMain/iosMain 中直接进行互操作
条件允许时，重复使用多平台库

KMM 基础课程到这里就完成了。

常见问题解答

「平台 API」课时是免费的吗？

是的 — 「平台 API」的完整文本可在网页上免费阅读。要进行交互式练习（内置代码编辑器和全天候 AI 导师）并解锁 Kotlin Academy 课程的其余内容，请升级到 CoddyKit PRO。 Kotlin Academy 课程共包含 4 节课。

「平台 API」这节课中我会学到什么？

访问原生功能你通过在浏览器中直接运行的动手代码来练习 Kotlin Academy，全天候 AI 导师会在你学习这节课的过程中回答你的问题。

学习 Kotlin Academy 需要有经验吗？

无需任何先前经验。CoddyKit 上的 Kotlin Academy 课程适合初学者到高级学习者，你可以从这里开始或从头开始，按照自己的节奏学习。这是第 4 节课，共 4 节。

「平台 API」课时需要多长时间？

大多数 CoddyKit 课程大约需要 5–10 分钟。每节课都很精短且互动，所以你能稳步进步，并在网页和应用中从离开的地方继续。

我能在这节 Kotlin Academy 课中编写并运行代码吗？

能。每节 Kotlin Academy 课都包含内置代码编辑器，你可以在浏览器中直接编写并运行真实代码，并获得即时 AI 反馈 — 无需本地设置。

此课程中的所有课时

← 返回 Kotlin Academy