Что нового в Compose Multiplatform 1.8.2

Полный переход Compose Multiplatform на компилятор K2

В этом выпуске кодовая база Compose Multiplatform полностью переведена на компилятор K2. Начиная с версии 1.8.0, нативные и веб-библиотеки klib, создаваемые проектами, зависящими от Compose Multiplatform, можно использовать только с Kotlin 2.1.0 или более поздней версии.

Что это означает для ваших проектов, помимо базовых изменений в плагине Gradle компилятора Compose:

• Если приложение использует библиотеки, зависящие от Compose Multiplatform: рекомендуем обновить проект до Kotlin 2.1.20, а зависимости — до версий, скомпилированных с Compose Multiplatform 1.8.0 и Kotlin 2.1.x.

• Если библиотека зависит от Compose Multiplatform: обновите проект до Kotlin 2.1.x и Compose 1.8.0, затем пересоберите библиотеку и опубликуйте новую версию.

Если при обновлении до Compose Multiplatform 1.8.0 возникнут проблемы совместимости, сообщите нам о них, создав задачу в YouTrack.

Удалена неявная зависимость от material-icons-core

Compose Multiplatform 1.8.2 включает изменение, внесенное в Material: транзитивная зависимость от material-icons-core больше не используется. Это согласуется с отказом от зависимостей, собранных с помощью K1.

Если вам нужно продолжить использовать в проекте библиотеку material-icons-core, добавьте зависимость явно в build.gradle.kts, например:

implementation("org.jetbrains.compose.material:material-icons-core:1.7.3")

Также можно использовать векторные значки Android XML из библиотеки Material Symbols.

Переход с Bundle на SavedState в Navigation

Navigation в Compose Multiplatform 1.8.2, как и компонент Android Navigation, переходит на использование класса SavedState для хранения состояний пользовательского интерфейса. Это меняет способ доступа к данным состояния при объявлении пунктов назначения в графе навигации. При обновлении до версии 2.9.* библиотеки Navigation не забудьте изменить такой код, чтобы использовать методы доступа к SavedState.

Раньше:

composable(Destinations.Followers.route) { navBackStackEntry ->
    val uId = navBackStackEntry.arguments?.getString("userid")
    val page = navBackStackEntry.arguments?.getString("page")
    if (uId != null && page != null) {
        FollowersMainComposable(navController, accountId = uId, page = page)
    }
}

Начиная с Compose Multiplatform 1.8.2:

composable(Destinations.Followers.route) { navBackStackEntry ->
    val uId = navBackStackEntry.arguments?.read { getStringOrNull("userid") }
    val page = navBackStackEntry.arguments?.read { getStringOrNull("page") }
    if (uId != null && page != null) {
        FollowersMainComposable(navController, accountId = uId, page = page)
    }
}

Устаревший ComposeUIViewControllerDelegate в iOS

API ComposeUIViewControllerDelegate объявлен устаревшим в пользу родительского контроллера представления. Если вы используете устаревший API с Compose Multiplatform 1.8.2, появится ошибка об устаревании, указывающая, что методы класса UIViewController необходимо переопределить через родительский контроллер представления.

Подробнее об отношениях дочерних и родительских контроллеров представления см. в документации для разработчиков Apple.

Удален устаревший параметр platformLayers в iOS

Экспериментальный параметр platformLayers появился в версии 1.6.0, чтобы можно было включить альтернативный режим слоев и отображать всплывающие окна и диалоговые окна за пределами родительского контейнера.

Теперь этот режим используется по умолчанию в iOS, а параметр для его включения удален как устаревший.

Несовместимые изменения в тестах

@Test
fun loopInLaunchedEffectTest() = runComposeUiTest {
    setContent {
        LaunchedEffect(Unit) {
            while (true) {
                delay(1000)
                println("Tick")
            }
        }
    }
}

var updateText by mutableStateOf(false)
var text by mutableStateOf("0")
setContent {
    LaunchedEffect(updateText) {
        if (updateText) {
            delay(1000)
            text = "1"
        }
    }
}
updateText = true
waitForIdle()
// Since waitForIdle() no longer waits for the delayed LaunchedEffect() to complete,
// the test needs to advance time to make the following assertion correct:
mainClock.advanceTimeBy(1001)

assertEquals("1", text)

Вариативные шрифты

Compose Multiplatform 1.8.2 поддерживает вариативные шрифты на всех платформах. Вариативные шрифты позволяют использовать один файл шрифта, содержащий настройки всех стилей: начертание, ширину, наклон, курсив, пользовательские оси, визуальную плотность с учетом цвета типографики и адаптацию к определенным размерам текста.

Подробности см. в документации Jetpack Compose.

Skia обновлена до Milestone 132

Версия Skia, используемая в Compose Multiplatform через Skiko, обновлена до Milestone 132.

Ранее использовалась Skia Milestone 126. Список изменений между этими версиями см. в примечаниях к выпуску.

Новый интерфейс Clipboard

В Compose Multiplatform добавлен новый интерфейс Clipboard из Jetpack Compose.

Ранее использовавшийся интерфейс ClipboardManager объявлен устаревшим в пользу Clipboard. Он был недоступен для веб-целей из-за асинхронной природы Clipboard API в вебе. Новый интерфейс поддерживает функции suspend и совместим со всеми целями, в том числе веб-целями.

Взаимодействие с буфером обмена из общего кода сейчас ограничено особенностями проектирования API. Подробнее см. CMP-7624.

Выравнивание по высоте строки

Общий API для выравнивания по высоте строки, ранее поддерживавшийся Compose Multiplatform только в Android, теперь доступен на всех платформах. С помощью LineHeightStyle.Alignment можно настроить выравнивание строки текста в пространстве, выделенном под ее высоту. Строки текста можно выровнять по нижнему или верхнему краю либо по центру зарезервированного пространства или пропорционально скорректировать по значениям выносных элементов вверх и вниз.

Обратите внимание: в Material3 значением выравнивания по высоте строки по умолчанию является Center. Это означает, что в компонентах Material3 на всех платформах текст с lineHeight будет выравниваться по центру, если не указано иное.

Глубокие ссылки

Используя Compose Multiplatform 1.8.2 вместе с org.jetbrains.androidx.navigation.navigation-compose 2.10.0-alpha02, можно реализовать глубокие ссылки в iOS обычным для Compose способом: назначать глубокие ссылки пунктам назначения и переходить к ним с помощью NavController.

Инструкции по добавлению глубоких ссылок в общий код см. в разделе Глубокие ссылки.

Ресурсы Compose в XCFramework

Теперь Compose Multiplatform встраивает ресурсы непосредственно в созданные XCFramework. Библиотеки Compose с ресурсами можно собирать и использовать как стандартные XCFramework.

Для этой функции требуется версия плагина Kotlin Gradle 2.2 или выше.

Улучшения поддержки специальных возможностей

Стабильный API для журналирования в iOS

API для ведения журналов операционной системой в iOS теперь стабилен. Функция enableTraceOSLog() больше не требует экспериментального подтверждения и теперь работает аналогично журналированию в Android. Журналы содержат трассировочную информацию, которую можно анализировать с помощью Xcode Instruments для отладки и анализа производительности.

Перетаскивание

В Compose Multiplatform для iOS добавлена поддержка перетаскивания, позволяющая перетаскивать содержимое в приложение Compose и из него (демонстрационное видео см. в запросе на включение изменений 1690). Чтобы задать перетаскиваемое содержимое и целевые области для его сброса, используйте модификаторы dragAndDropSource и dragAndDropTarget.

В iOS данные сеанса перетаскивания представлены объектом UIDragItem. Этот объект содержит информацию о передаче данных между процессами и необязательный локальный объект для использования в приложении. Например, с помощью DragAndDropTransferData(listOf(UIDragItem.fromString(text))) можно перетаскивать текст, а UIDragItem.fromString(text) преобразует его в формат, подходящий для операций перетаскивания. Сейчас поддерживаются только типы String и NSObject.

Примеры типичных сценариев использования см. в специальной статье в документации Jetpack Compose.

Улучшена обработка касаний в прокручиваемых представлениях взаимодействия

В этом выпуске:

• Представление Compose с непрокручиваемым содержимым, показанное как модальное UIViewController, можно закрыть жестом смахивания вниз.

• Вложенные прокручиваемые представления корректно работают в общей инфраструктуре обработки касаний для взаимодействия: при прокрутке нативного содержимого внутри прокручиваемого представления Compose или содержимого Compose внутри прокручиваемого нативного представления пользовательский интерфейс следует логике iOS для разрешения неоднозначных последовательностей касаний.

Подключение параллельной отрисовки

Compose Multiplatform для iOS теперь позволяет выполнять задачи отрисовки в отдельном потоке рендеринга. Параллельная отрисовка может повысить производительность в сценариях без взаимодействия с UIKit.

Чтобы кодировать команды отрисовки в отдельном потоке рендеринга, включите флаг useSeparateRenderThreadWhenPossible класса ComposeUIViewControllerConfiguration или свойство parallelRendering непосредственно в блоке конфигурации ComposeUIViewController:

@OptIn(ExperimentalComposeUiApi::class)
fun main(vararg args: String) {
    UIKitMain {
        ComposeUIViewController(configure = { parallelRendering = true }) {
            // ...
        }
    }
}

Поддержка элементов управления браузера в библиотеке Navigation

В приложениях Kotlin/Wasm и Kotlin/JS, созданных с помощью Compose Multiplatform, навигация теперь корректно работает с основными элементами управления браузера. Для этого свяжите окно браузера с основным графом навигации с помощью метода window.bindToNavigation(). После этого веб-приложение будет корректно реагировать на нажатие кнопок Назад и Вперед при перемещении по истории браузера (демонстрационное видео см. в запросе на включение изменений 1621).

Веб-приложение также будет изменять адресную строку браузера в соответствии с текущим маршрутом и переходить непосредственно к пункту назначения, если пользователь вставит URL с соответствующим маршрутом (демонстрационное видео см. в запросе на включение изменений 1640). Метод window.bindToNavigation() принимает необязательный параметр getBackStackEntryPath, позволяющий настроить преобразование строк маршрутов во фрагменты URL.

Настройка курсора браузера

Добавлена экспериментальная функция PointerIcon.Companion.fromKeyword() для управления значками, используемыми в качестве указателей мыши на веб-странице. Передав ключевое слово в качестве параметра, можно задать тип курсора в зависимости от контекста. Например, можно назначить разные значки указателя для выделения текста, открытия контекстного меню или отображения процесса загрузки.

Полный список доступных ключевых слов.

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

В Compose Multiplatform 1.8.2 добавлен новый экспериментальный API для предварительной загрузки шрифтов и изображений для веб-целей. Предварительная загрузка помогает предотвратить визуальные проблемы, такие как вспышки неоформленного текста (FOUT) или мерцание изображений и значков.

Теперь доступны следующие функции для загрузки ресурсов и кэширования:

• preloadFont() — предварительно загружает шрифты.

• preloadImageBitmap() — предварительно загружает растровые изображения.

• preloadImageVector() — предварительно загружает векторные изображения.

Подробности см. в документации.

Улучшение программной отрисовки в Windows

Переход на рекомендуемый компилятор clang для Skia в Windows ускорил отрисовку, выполняемую с помощью CPU. Это в основном влияет на программную отрисовку, поскольку обычно для отрисовки используется GPU, а на CPU выполняется лишь часть вычислений. Поэтому улучшение особенно заметно на некоторых виртуальных машинах и с несколькими старыми видеокартами, которые не поддерживаются Skia: приложения Windows, созданные с помощью Compose Multiplatform, в этих средах теперь работают до 6 раз быстрее, чем в Compose Multiplatform 1.7.3.

Это улучшение, наряду с поддержкой Windows для ARM64, значительно повышает производительность пользовательских интерфейсов Compose Multiplatform в виртуальных системах Windows под macOS.

Поддержка Windows для ARM64

В Compose Multiplatform 1.8.2 добавлена поддержка Windows для ARM64 на JVM, что улучшает общее взаимодействие при сборке и запуске приложений на устройствах Windows с процессорами ARM.

Возможность изменить имя сгенерированного класса Res

Теперь вы можете настроить имя сгенерированного класса ресурсов, который предоставляет доступ к ресурсам приложения. Пользовательские имена особенно полезны для различения ресурсов в проектах с несколькими модулями и помогают соблюдать соглашения об именовании, принятые в проекте.

Чтобы задать пользовательское имя, добавьте следующую строку в блок compose.resources файла build.gradle.kts:

compose.resources {
    nameOfResClass = "MyRes"
}

Подробнее см. в запросе на включение изменений.

Поддержка ресурсов Multiplatform в целевой платформе androidLibrary

Начиная с версии 8.8.0 плагина Android Gradle, вы можете использовать сгенерированные ресурсы в новой целевой платформе androidLibrary. Чтобы Compose Multiplatform соответствовал этим изменениям, мы добавили поддержку новой конфигурации целевой платформы для работы с ресурсами Multiplatform, упакованными в ресурсы Android.

Если вы используете целевую платформу androidLibrary, включите ресурсы в конфигурации:

kotlin {
    androidLibrary {
        androidResources.enable = true
    }
}

В противном случае вы столкнётесь со следующим исключением: org.jetbrains.compose.resources.MissingResourceException: Missing resource with path: ….