多平台资源的设置与配置

要正确配置项目以使用多平台资源：

添加库依赖项。
为每种资源创建必要的目录。
为限定资源创建额外目录（例如，用于深色 UI 主题的不同图像或本地化字符串）。

构建脚本和目录设置

要在多平台项目中访问资源，请添加库依赖项并在项目目录中组织文件：

在 composeApp 目录中的 build.gradle.kts 文件中，向 commonMain 源代码集添加一个依赖项：
kotlin
```
kotlin {
    //...
    sourceSets {
        commonMain.dependencies {
            implementation(compose.components.resources)
        }
    }
}
```
要直接引用该库，请使用 Maven Central 中的 artifact 页面中的完全限定名。
在你想要添加资源的源代码集目录中（本例中为 commonMain），创建一个新的 composeResources 目录：
按照以下规则组织 composeResources 目录结构：
- 图像应放在 drawable 目录中。Compose Multiplatform 支持栅格图像（JPEG、PNG、位图和 WebP）以及矢量 Android XML 图像（不含对 Android 资源的引用）。
- 字体应放在 font 目录中。
- 字符串应放在 values 目录中。
- 其他文件应放在 files 目录中，可采用你认为合适的任何文件夹层级结构。

自定义资源目录

在 build.gradle.kts 文件中的 compose.resources {} 代码块中，你可以为每个源代码集指定自定义资源目录。每个自定义目录也应以与默认 composeResources 相同的方式包含文件：例如，图像的 drawable 子目录，字体的 font 子目录，等等。

一个简单的例子是指向特定文件夹：

kotlin

compose.resources {
    customDirectory(
        sourceSetName = "desktopMain",
        directoryProvider = provider { layout.projectDirectory.dir("desktopResources") }
    )
}

你还可以设置一个由 Gradle 任务填充的文件夹，例如，包含已下载文件：

kotlin

abstract class DownloadRemoteFiles : DefaultTask() {

    @get:OutputDirectory
    val outputDir = layout.buildDirectory.dir("downloadedRemoteFiles")

    @TaskAction
    fun run() { /* your code for downloading files */ }
}

compose.resources {
    customDirectory(
        sourceSetName = "iosMain",
        directoryProvider = tasks.register<DownloadRemoteFiles>("downloadedRemoteFiles").map { it.outputDir.get() }
    )
}

`androidLibrary` 目标中的资源

从 Android Gradle 插件 8.8.0 版本开始，你可以在 androidLibrary 目标中使用生成的 Res 类和资源访问器。要在 androidLibrary 中启用对多平台资源的支持，请按如下方式更新你的配置：

kotlin {
  androidLibrary {
    androidResources.enable = true
  }
}

限定符

有时，同一资源需要根据环境以不同方式呈现，例如根据区域设置、屏幕密度或界面主题。例如，你可能需要针对不同语言进行文本本地化，或调整深色主题的图像。为此，该库提供了特殊的限定符。

关于如何处理资源相关设置，请参阅管理本地资源环境教程。

除 files 目录中的原始文件外，所有资源类型都支持限定符。使用连字符将限定符添加到目录名称中：

Qualifiers in multiplatform resources

该库支持以下限定符（按优先级顺序）：语言、主题和密度。

不同类型的限定符可以一起应用。例如，“drawable-en-rUS-mdpi-dark”是一个适用于美国地区英语语言、深色主题下 160 DPI 屏幕的图像。
如果带有请求限定符的资源不可访问，则会使用默认资源（不带限定符）。

语言和区域限定符

你可以组合语言和区域限定符：

语言由两位（ISO 639-1）或三位（ISO 639-2）语言代码定义。
你可以在语言代码中添加两位 ISO 3166-1-alpha-2 区域代码。区域代码必须带有小写 r 前缀，例如：drawable-spa-rMX

语言和区域代码区分大小写。

主题限定符

你可以添加“light”或“dark”限定符。Compose Multiplatform 会根据当前系统主题选择所需的资源。

密度限定符

你可以使用以下密度限定符：

“ldpi” – 120 DPI，0.75 倍密度
“mdpi” – 160 DPI，1 倍密度
“hdpi” – 240 DPI，1.5 倍密度
“xhdpi” – 320 DPI，2 倍密度
“xxhdpi” – 480 DPI，3 倍密度
“xxxhdpi” – 640 DPI，4 倍密度

资源是根据系统中定义的屏幕密度来选择的。

发布

从 Compose Multiplatform 1.6.10 版本开始，所有必要的资源都包含在发布的 Maven artifact 中。

要启用此功能，你的项目需要使用 Kotlin 2.0.0 或更高版本以及 Gradle 7.6 或更高版本。

接下来？

关于如何访问你设置的资源以及如何自定义默认生成的访问器，请参阅在应用中使用多平台资源页面。
查看官方演示项目，该项目展示了如何在面向 iOS、Android 和 desktop 的 Compose Multiplatform 项目中处理资源。

多平台资源的设置与配置 ​

构建脚本和目录设置 ​

自定义资源目录 ​

androidLibrary 目标中的资源 ​

限定符 ​

语言和区域限定符 ​

主题限定符 ​

密度限定符 ​

发布 ​

接下来？ ​