Настройка и конфигурация ресурсов для мультиплатформенных проектов

Пользовательские каталоги ресурсов

В блоке compose.resources {} файла build.gradle.kts можно указать пользовательские каталоги ресурсов для каждого набора исходных кодов. В каждом из таких каталогов файлы должны быть организованы так же, как в каталоге composeResources по умолчанию: с подкаталогом drawable для изображений, подкаталогом font для шрифтов и так далее.

Простой пример — указать конкретную папку:

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

Также можно настроить папку, содержимое которой формируется задачей Gradle, например, загруженными файлами:

Подробнее о настройке доступа к ресурсам см. в разделе Доступ и использование.

Пользовательские пути к веб-ресурсам

Указать пути и URL-адреса веб-ресурсов можно с помощью функции configureWebResources():

• Используйте относительный путь (начинающийся с /), чтобы указать ресурс относительно корня домена.

• Используйте абсолютный URL-адрес (начинающийся с http:// или https://), чтобы указать ресурс, размещённый на внешнем домене или в CDN.

// Maps resources to an application-specific path
configureWebResources {
    resourcePathMapping { path -> "/myApp/resources/$path" }
}

// Maps resources to an external CDN
configureWebResources {
    resourcePathMapping { path -> "https://mycdn.com/myApp/res/$path" }
}

Ресурсы в целевом объекте androidLibrary

Начиная с версии 8.8.0 плагина Android Gradle, в целевом объекте androidLibrary можно использовать сгенерированный класс Res и средства доступа к ресурсам. Чтобы включить поддержку мультиплатформенных ресурсов в androidLibrary, обновите конфигурацию следующим образом:

kotlin {
  androidLibrary {
    androidResources.enable = true
  }
}

Квалификаторы языка и региона

Можно сочетать квалификаторы языка и региона:

• Язык задаётся двухбуквенным (ISO 639-1) или трёхбуквенным (ISO 639-2) кодом языка.

• К коду языка можно добавить двухбуквенный региональный код ISO 3166-1-alpha-2. Перед региональным кодом должен стоять префикс r в нижнем регистре, например: drawable-spa-rMX.

В кодах языка и региона учитывается регистр.

Чтобы указать письменность или любой другой субтег BCP 47, используйте префикс b+ и замените все последующие дефисы между субтегами (-) знаком +, например: values-b+zh+Hans и values-b+zh+Hant.

Подробнее о работе с форматами, зависящими от региона, см. в разделе Локализация.

commonMain/composeResources/
├── values/                 # Default resources
├── values-zh/              # Resources for `zh` without a script
├── values-b+zh+Hans/
└── values-b+zh+Hant/

Квалификатор темы

Можно добавить квалификаторы «light» или «dark». Тогда Compose Multiplatform выберет нужный ресурс в зависимости от текущей системной темы.

Квалификатор плотности

Можно использовать следующие квалификаторы плотности:

• «ldpi» — 120 DPI, плотность 0,75x

• «mdpi» — 160 DPI, плотность 1x

• «hdpi» — 240 DPI, плотность 1,5x

• «xhdpi» — 320 DPI, плотность 2x

• «xxhdpi» — 480 DPI, плотность 3x

• «xxxhdpi» — 640 DPI, плотность 4x

Ресурс выбирается в зависимости от плотности экрана, заданной в системе.