本文详解如何通过 Gradle 的 sourceSets 配置，使 Android 模块能安全、规范地访问位于 coreModule 等其他子项目中的通用资源（如字体、配置文件、二进制数据），并兼容 JVM 模块（如 desktopModule），避免重复存放与路径不一致问题。
本文详解如何通过 gradle 的 `sourcesets` 配置，使 android 模块能安全、规范地访问位于 `coremodule` 等其他子项目中的通用资源（如字体、配置文件、二进制数据），并兼容 jvm 模块（如 desktopmodule），避免重复存放与路径不一致问题。
在多模块 Android 项目中，将公共资源（如字体 .ttf、JSON 配置、预编译二进制文件等）集中存放在 coreModule 是合理且可维护的设计——既避免冗余复制，又保障各平台模块（Android / JVM Desktop）使用同一份权威源。但 Android 的构建系统默认仅识别 src/main/assets/ 下的文件，无法直接访问兄弟模块（如 ../coreModule/resources/）路径。解决此问题的关键在于：*正确扩展 assets.srcDirs（Android）或 resources.srcDirs（JVM），而非误用 resources（对应 `R.）或java` 源集。**
✅ 正确做法：为 Android 模块注入外部 assets 目录
在 androidModule/build.gradle.kts 中，修改 android.sourceSets["main"] 的 assets 配置，保留默认 assets 路径，并追加跨模块目录：
android {
// ... 其他配置（compileSdk, defaultConfig 等）
sourceSets.getByName("main") {
// 获取当前已定义的所有 assets 目录（含默认的 src/main/assets）
val existingAssets = assets.srcDirs.map { it.toString() }.toMutableList()
// 添加 coreModule 下的共享资源目录（路径相对于 androidModule）
val sharedAssetsDir = project.layout.projectDirectory.dir("../coreModule/src/main/resources")
existingAssets.add(sharedAssetsDir.toString())
// 重新设置 assets 源目录列表
assets.setSrcDirs(existingAssets)
}
}
⚠️ 注意事项：
- 使用
project.layout.projectDirectory.dir("../coreModule/...")确保路径基于项目根目录解析，避免相对路径错误；- 必须使用
assets.setSrcDirs()（而非srcDirs += ...），否则旧路径会被覆盖，导致默认src/main/assets失效；assets是 Android 特有概念，文件会原样打包进 APK 的/assets/目录，不可通过R.访问，只能用AssetManager加载。
? 在 Activity 或 Fragment 中读取共享文件
配置生效后，所有 coreModule/src/main/resources/ 下的文件（如 fonts/roboto-regular.ttf、data/config.json）均可通过 assets.open() 直接访问，路径为相对于 assets 根目录的相对路径：
Android 开发调试技能，通过系统 ADB 工具操作 Android 设备。以下场景必须触发此技能：(1) 直接 ADB 操作——安装 APK、查看设备列表、抓取 logcat 日志、查看已安装应用、清除应用数据、截图、重启设备、拉取/推送文件、查看 CPU/内存/电池信息、adb shell 操作；(2)...
class MainActivity : AppCompatActivity() {
override fun onCreate(savedInstanceState: Bundle?) {
super.onCreate(savedInstanceState)
setContentView(R.layout.activity_main)
try {
// ✅ 正确：从 coreModule 的 resources 目录加载（路径与文件在 resources/ 下的位置一致）
val fontStream = assets.open("fonts/roboto-regular.ttf")
val configJson = assets.open("data/config.json").bufferedReader().use { it.readText() }
Log.d("Assets", "Font size: ${fontStream.available()} bytes")
Log.d("Assets", "Config: $configJson")
} catch (e: IOException) {
Log.e("Assets", "Failed to load file from assets", e)
}
}
}
? 同时支持 JVM 模块（如 desktopModule）
若 desktopModule（Kotlin/JVM）也需访问同一份文件，只需在它的 build.gradle.kts 中扩展 resources.srcDirs（注意：JVM 没有 assets，只有 resources）：
kotlin {
sourceSets.getByName("main") {
val existingResources = resources.srcDirs.map { it.toString() }.toMutableList()
val sharedResourcesDir = project.layout.projectDirectory.dir("../coreModule/src/main/resources")
existingResources.add(sharedResourcesDir.toString())
resources.setSrcDirs(existingResources)
}
}
此时在 JVM 代码中可通过 Class.getResourceAsStream("/fonts/roboto-regular.ttf") 或 javaClass.classLoader.getResourceAsStream("data/config.json") 访问（路径前缀 / 表示根路径）。
✅ 最佳实践总结
| 项目 | 推荐做法 |
|---|---|
| 目录位置 | 将共享文件统一放在 coreModule/src/main/resources/（非 assets/），因其天然被 JVM 和 Android（通过 assets 映射）支持 |
| Android 访问方式 |
assets.open("path/to/file") —— 路径是 resources/ 下的相对路径，无需 assets/ 前缀
|
| JVM 访问方式 |
Class.getResourceAsStream("/path/to/file") —— 路径以 / 开头表示 classpath 根 |
| 构建验证 | 运行 ./gradlew :androidModule:assembleDebug 后，检查 androidModule/build/intermediates/merged_assets/debug/out/ 是否包含目标文件 |
| 避免陷阱 | ❌ 不要修改 sourceSets["main"].resources.srcDirs（这是用于 R.* 的编译时资源）；✅ 只操作 assets.srcDirs（Android）或 resources.srcDirs（JVM） |
通过上述配置，你既能保持 coreModule 作为单一可信源，又能实现 Android 与 Desktop 模块对公共资源的无缝、类型安全访问，真正践行“一次编写，多端复用”的工程化理念。
