Compose for Desktop如何打包捆绑JSON、HTML等资源文件

Compose for Desktop（即Compose Multiplatform的桌面端）没有Android平台专属的raw/assets目录概念，基于JVM标准的类路径资源机制实现内置文件打包即可，完全能满足JSON、HTML这类静态文件随安装包分发、运行时读取的需求。

1. 资源目录配置 #

标准JVM项目默认会把src/main/resources目录下的所有文件打包进最终产物的类路径，你直接按分类在这个目录下存文件就行，推荐目录结构参考：

desktop模块
└── src
    └── main
        ├── kotlin // 代码目录
        └── resources // 内置资源根目录
            └── assets
                ├── json
                │   └── config.json
                └── html
                    └── help.html

如果需要自定义资源存放目录，在桌面模块的build.gradle.kts中添加如下配置，把自定义目录纳入打包范围即可：

tasks.processResources {
    // 把你自定义的静态资源目录纳入打包
    from("src/main/bundleFiles") {
        // 打包后在类路径下的根目录名，可自定义
        into("static")
    }
}

2. 运行时读取资源 #

注意不要用本地绝对/相对磁盘路径读取，打包后资源会被打入jar包或安装包内部，不存在独立的磁盘文件路径，必须通过类加载器读取，常用场景代码如下：

• 读取文本类内容（适配JSON、HTML等直接需要字符串内容的场景）

import java.nio.charset.StandardCharsets

// 路径开头的/代表类路径根目录，对应resources目录下的层级
val helpHtml = object {}.javaClass.getResourceAsStream("/assets/html/help.html")?.use { inputStream ->
    String(inputStream.readAllBytes(), StandardCharsets.UTF_8)
} ?: throw IllegalStateException("内置资源读取失败，请检查文件路径")

• 给WebView等组件传资源地址的场景：直接获取URI即可，不要尝试转成File对象操作

val htmlUri = object {}.javaClass.getResource("/assets/html/help.html")?.toURI()

常见踩坑提示 #

• 资源路径开头必须加/，否则类加载器会相对于当前类的包路径查找文件，大概率出现资源找不到的问题
• 打包成exe、dmg、deb等安装包后，资源是压缩存储在jar包内的，直接转File读取会报文件不存在，必须用流的方式读取
• IDE内直接运行调试和最终打包的类路径逻辑是一致的，但建议首次配置完打一个对应平台的测试安装包验证，避免路径配置错误
• Compose Multiplatform 1.6+版本提供了跨平台通用的composeResources资源API，适合需要多端共用的图片、字符串资源，如果只是桌面端用JSON、HTML这类通用文件，直接用JVM类路径读取的方式更轻量，不需要额外配置

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