如何从Kotlin多平台项目的Common模块加载资源？

你这个问题问到点子上了——Kotlin标准库确实没有提供统一的跨平台资源加载API，这主要是因为不同平台的资源存储、访问机制差异实在太大了（JVM靠类路径、JS走网络/本地文件、Native依赖应用包结构）。不过咱们有成熟的方案解决这个问题，下面给你拆解两种常用思路：

1. 官方推荐：用expect/actual封装平台特定实现 #

这是Kotlin Multiplatform处理平台差异的标准姿势，你可以在common模块里定义一个通用的资源加载接口，然后在各个平台模块里实现具体逻辑，完全兼容你原来JVM项目的加载方式。

先在commonMain里声明通用的expect函数：

// commonMain/kotlin/com/example/ResourceLoader.kt
expect fun loadResource(name: String): ByteArray?
// 如果需要支持异步加载（比如JS平台），可以改成suspend函数
// expect suspend fun loadResource(name: String): ByteArray?

然后针对各个平台实现actual逻辑：

• JVM平台：直接沿用你熟悉的类加载器方式

// jvmMain/kotlin/com/example/ResourceLoader.kt
actual fun loadResource(name: String): ByteArray? {
    return this.javaClass.classLoader.getResourceAsStream(name)?.readBytes()
}

• JS平台：用浏览器的fetch API（Node.js环境则用fs模块），建议配合协程处理异步逻辑

// jsMain/kotlin/com/example/ResourceLoader.kt
import kotlinx.coroutines.await
import org.w3c.fetch.Response

actual suspend fun loadResource(name: String): ByteArray? {
    return try {
        val response: Response = fetch(name).await()
        if (response.ok) response.arrayBuffer().await().toByteArray() else null
    } catch (e: Exception) {
        null
    }
}

• iOS平台：利用苹果的NSBundle读取应用包内的资源

// iosMain/kotlin/com/example/ResourceLoader.kt
import platform.Foundation.NSBundle
import platform.Foundation.NSData

actual fun loadResource(name: String): ByteArray? {
    val resourcePath = NSBundle.mainBundle.pathForResource(name, null) ?: return null
    return NSData.dataWithContentsOfFile(resourcePath)?.toByteArray()
}

2. 借助社区第三方库简化开发 #

如果不想自己手动编写各个平台的actual实现，可以用社区封装好的多平台资源库。这些库已经帮你处理了不同平台的资源路径、打包逻辑，还支持资源本地化、类型安全访问等进阶功能，能大幅减少重复代码。

关键配套：Gradle资源配置 #

不管用哪种方案，都需要在build.gradle.kts里正确配置各个sourceSet的资源目录，确保Gradle能把资源打包到对应平台的正确位置：

kotlin {
    // 声明你的目标平台
    jvm()
    js(IR) { browser() }
    iosX64()
    iosArm64()
    iosSimulatorArm64()

    sourceSets {
        val commonMain by getting {
            resources.srcDir("src/commonMain/resources") // 存放通用资源
        }
        val jvmMain by getting {
            resources.srcDir("src/jvmMain/resources") // JVM专属资源
        }
        // 其他平台的sourceSet同理配置专属资源目录
    }
}

总结一下：目前Kotlin标准库确实没有内置跨平台资源加载的统一API，但通过expect/actual的平台抽象，或者借助社区成熟库，完全可以实现跨平台的资源加载逻辑，而且能很好地适配各个平台的特性。

内容的提问来源于stack exchange，提问作者Sean