다중 플랫폼 리소스 설정 및 구성

다중 플랫폼 리소스를 사용하도록 프로젝트를 올바르게 구성하려면:

라이브러리 종속성을 추가합니다.
각 리소스 종류에 필요한 디렉터리를 생성합니다.
한정된 리소스(예: 다크 UI 테마에 대한 다른 이미지 또는 지역화된 문자열)를 위한 추가 디렉터리를 생성합니다.

빌드 스크립트 및 디렉터리 설정

다중 플랫폼 프로젝트에서 리소스에 액세스하려면 라이브러리 종속성을 추가하고 프로젝트 디렉터리 내에서 파일을 구성합니다.

composeApp 디렉터리의 build.gradle.kts 파일에 commonMain 소스 세트에 대한 종속성을 추가합니다.
kotlin
```
kotlin {
    //...
    sourceSets {
        commonMain.dependencies {
            implementation(compose.components.resources)
        }
    }
}
```
라이브러리를 직접 참조하려면 Maven Central의 아티팩트 페이지에서 정규화된 이름을 사용하세요.
리소스를 추가하려는 소스 세트 디렉터리(이 예에서는 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
  }
}

한정자

때로는 로케일, 화면 밀도 또는 인터페이스 테마와 같은 환경에 따라 동일한 리소스가 다르게 표시되어야 할 수 있습니다. 예를 들어, 다른 언어에 대해 텍스트를 지역화하거나 다크 테마에 맞게 이미지를 조정해야 할 수 있습니다. 이를 위해 라이브러리는 특수 한정자(qualifiers)를 제공합니다.

로컬 리소스 환경 관리 튜토리얼에서 리소스 관련 설정을 처리하는 방법을 알아보세요.

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 아티팩트에 포함됩니다.

이 기능을 활성화하려면 프로젝트에서 Kotlin 2.0.0 이상 및 Gradle 7.6 이상을 사용해야 합니다.

다음 단계

설정한 리소스에 액세스하고 앱에서 다중 플랫폼 리소스 사용 페이지에서 기본적으로 생성된 접근자를 사용자 지정하는 방법을 알아보세요.
iOS, Android 및 데스크톱을 대상으로 하는 Compose Multiplatform 프로젝트에서 리소스가 어떻게 처리될 수 있는지 보여주는 공식 데모 프로젝트를 확인해 보세요.

다중 플랫폼 리소스 설정 및 구성 ​

빌드 스크립트 및 디렉터리 설정 ​

사용자 지정 리소스 디렉터리 ​

androidLibrary 타겟의 리소스 ​

한정자 ​

언어 및 지역 한정자 ​

테마 한정자 ​

밀도 한정자 ​

게시 ​

다음 단계 ​