Kotlin Multiplatform linuxX64目标资源打包与路径获取咨询

1. 是否支持资源打包？ #

支持。Kotlin Multiplatform本身就支持为包括linuxX64在内的原生目标打包资源，无需依赖Compose Multiplatform或moko-resource这类仅针对应用的方案，只需在Gradle中正确配置资源目录即可。

2. 如何配置并获取资源路径？ #

步骤1：Gradle资源配置 #

在项目的build.gradle.kts中，通过Kotlin插件的sourceSets指定资源目录，默认情况下src/commonMain/resources（通用资源）和src/linuxX64Main/resources（linuxX64专属资源）会被自动识别，也可手动添加自定义目录：

kotlin {
    jvm()
    linuxX64()

    sourceSets {
        val commonMain by getting {
            // 通用资源目录，JVM和linuxX64都会包含这里的文件
            resources.srcDir("src/commonMain/resources")
        }
        val linuxX64Main by getting {
            // 添加linuxX64专属资源目录
            resources.srcDir("src/linuxX64Main/resources")
        }
    }
}

配置后，Gradle会在编译时将资源文件复制到对应目标的输出目录（比如linuxX64的可执行文件输出目录build/bin/linuxX64/releaseExecutable/），与二进制文件处于同一层级。

步骤2：跨平台资源路径获取 #

由于JVM和linuxX64的资源访问机制不同，建议用Kotlin的expect/actual机制实现跨平台的资源路径获取：

1. 通用模块定义expect函数

// commonMain下的代码
expect fun getResourcePath(resourceName: String): String?

2. JVM平台实现actual函数

利用JVM原生的资源访问API获取路径：

// jvmMain下的代码
actual fun getResourcePath(resourceName: String): String? {
    return YourLibraryClass::class.java.getResource("/$resourceName")?.path
}

3. linuxX64平台实现actual函数

linuxX64作为原生目标，资源会和可执行文件/库文件放在同一目录，通过获取程序运行目录拼接资源路径：

// linuxX64Main下的代码
import java.io.File

actual fun getResourcePath(resourceName: String): String? {
    // 获取当前运行的可执行文件路径（linux下通过环境变量或/proc文件系统获取）
    val exePath = System.getenv("_") ?: "/proc/self/exe"
    val exeDir = File(exePath).canonicalFile.parentFile?.absolutePath ?: "."
    
    // 拼接资源文件路径
    val resourceFile = File(exeDir, resourceName)
    return if (resourceFile.exists()) resourceFile.absolutePath else null
}

注意事项 #

• 如果你的库是作为共享库（.so文件）分发，需要告知使用者将资源文件放在与库文件相同的目录下，或者提供配置资源根路径的接口。
• 资源文件名要注意大小写，linux系统是大小写敏感的，避免路径匹配失败。

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