跨平台资源管理：一套代码如何搞定 Android、iOS 和 Web 的图片与多语言？

前言

在 Kotlin Multiplatform (KMP) 开发中，最让 Android 开发感到"手痒"的操作莫过于想随手写下一个 R.drawable.logo。但现实很残酷：在 commonMain 模块中，R 文件是不存在的。

长期以来，跨平台资源处理一直是 KMP 的痛点。你可能尝试过手动编写 expect/actual 来获取图片，或者使用第三方插件。

现在，随着 Compose Multiplatform (CMP) 资源管理库 (Resources library) 的正式推出，这一切终于有了官方的、现代化的终极方案。

今天，我们就来实战掌握如何用一套代码，管理全平台的图片、字符串和字体。

---

一、 核心心智模型：再见 R，你好 Res

在 Compose Multiplatform 中，资源管理被抽象为一个名为 Res 的自动生成类。它与 Android 的 R 类非常相似，但是它是类型安全的，且能够跨端工作。

资源目录结构

在你的共享模块（通常是 composeApp 或 shared）中：

commonMain/
  └── composeResources/
      ├── drawable/  <- 存放图片 (svg, xml, png)
      ├── values/    <- 存放 strings.xml
      └── font/      <- 存放 ttf, otf

---

二、 图片资源：矢量优先

Compose Multiplatform 对 SVG 和 Android Vector Drawable 有着极佳的支持。

1. 引用方式

Image(
    painter = painterResource(Res.drawable.ic_launcher),
    contentDescription = null
)

老兵观察 ：你只需要把图片丢进 drawable 文件夹，插件会自动在 Res.drawable 下生成对应的属性。无论在 iOS 还是 Web 上，它都能正确渲染。

---

三、 字符串与多语言：熟悉的配方，更强的能力

1. 资源定义

在 values/strings.xml 中定义：

<resources>
    <string name="app_name">My KMP App</string>
    <string name="hello_user">Hello, %1$s!</string>
</resources>

2. 多语言适配

只需创建对应的目录，如 values-zh/strings.xml。Compose 运行时会自动根据系统语言环境切换，无需手动干预。

3. 代码消费

val appName = stringResource(Res.string.app_name)
val welcome = stringResource(Res.string.hello_user, "Edison")

---

四、 字体管理：品牌一致性的保证

以前在 iOS 上使用自定义字体需要繁琐的 Info.plist 配置。现在：

1. 将 my_font.ttf 放入 font/ 文件夹。
2. 代码引用：

val myFontFamily = FontFamily(Font(Res.font.my_font))
Text("Hello", fontFamily = myFontFamily)

---

五、 给开发者的进阶 Tips

1. 资源 ID 的生成时机 ： 如果你发现 Res 对象报错，通常是因为 Gradle 还没有扫描到新文件。点击 "Sync Project with Gradle Files" 或执行 ./gradlew generateComposeResClass 即可。
2. 平台特有资源 ： 虽然 90% 的资源应该放在 commonMain，但如果你确实需要针对某个平台用不同的图，依然可以利用 expect/actual 配合各个平台的原生 Resource 机制（如 Android 的 context.resources）。
3. 性能考量 ： composeResources 底层会根据不同平台进行优化。在 Android 上，它会尽量复用系统的资源加载机制；在 iOS 上，它会将资源打包进 App Bundle。

---

结语

统一的资源管理是 KMP 从"逻辑共享"迈向"全栈共享"的关键一步。掌握了 Res 体系，你就能真正做到"像素级复刻"和"多语言无缝切换"。

---

下一篇我们将进入本专栏最硬核的实战拆解：KMP-Clean-MVI 全链路解析：手把手带你实现一个商业级全栈项目。

如果你觉得有帮助，欢迎点赞关注，我们在代码上演进，在原理上深耕。