Руководство по миграции компилятора Compose

Компилятор Compose дополнен плагином Gradle, который упрощает настройку и предоставляет более удобный доступ к параметрам компилятора. При применении вместе с Android Gradle Plugin (AGP) этот плагин компилятора Compose переопределяет координаты компилятора Compose, автоматически предоставляемого AGP.

Начиная с Kotlin 2.0.0 компилятор Compose включён в репозиторий Kotlin. Это упрощает переход ваших проектов на Kotlin 2.0.0 и более поздние версии, поскольку компилятор Compose выпускается одновременно с Kotlin и всегда совместим с Kotlin той же версии.

Чтобы использовать новый плагин компилятора Compose в проекте, примените его в каждом модуле, использующем Compose. Подробнее о том, как перенести проект Jetpack Compose. Информацию о проекте Compose Multiplatform см. в руководстве по миграции для Multiplatform.

Перенос проекта Jetpack Compose

При переходе с версии 1.9 на Kotlin 2.0.0 или новее настройте конфигурацию проекта в зависимости от того, как вы работаете с компилятором Compose. Рекомендуем использовать Kotlin Gradle plugin и Gradle plugin компилятора Compose для автоматизации управления конфигурацией.

Управление компилятором Compose с помощью плагинов Gradle

Для модулей Android:

Добавьте Gradle plugin компилятора Compose в каталог версий Gradle:
```
[versions]
# ...
kotlin = "2.4.20"

[plugins]
# ...
org-jetbrains-kotlin-android = { id = "org.jetbrains.kotlin.android", version.ref = "kotlin" }
compose-compiler = { id = "org.jetbrains.kotlin.plugin.compose", version.ref = "kotlin" }
```
Если вы используете AGP 9.0.0 или новее, плагин org-jetbrains-kotlin-android больше не нужен, поскольку в AGP уже встроена поддержка Kotlin.

Добавьте Gradle plugin в корневой файл build.gradle.kts:

plugins {
    // ...
    alias(libs.plugins.compose.compiler) apply false
}

Примените плагин к каждому модулю, использующему Jetpack Compose:
```
plugins {
    // ...
    alias(libs.plugins.compose.compiler)
}
```
Если вы используете параметры компилятора Jetpack Compose, задайте их в блоке composeCompiler {}. Список параметров см. в списке параметров компилятора.
Если вы напрямую указываете артефакты компилятора Compose, удалите эти ссылки и предоставьте плагинам Gradle возможность управлять ими.

Использование компилятора Compose без плагинов Gradle

Если вы не используете плагины Gradle для управления компилятором Compose, обновите все прямые ссылки на старые артефакты Maven в проекте:

Замените androidx.compose.compiler:compiler на org.jetbrains.kotlin:kotlin-compose-compiler-plugin-embeddable
Замените androidx.compose.compiler:compiler-hosted на org.jetbrains.kotlin:kotlin-compose-compiler-plugin

Что дальше

Ознакомьтесь с объявлением Google о переносе компилятора Compose в репозиторий Kotlin.
Если вы используете Jetpack Compose для создания приложения Android, ознакомьтесь с нашим руководством по созданию мультиплатформенного приложения.

12 августа 2026 г.

© 2010–2026 JetBrains s.r.o. and Kotlin Programming Language contributors
Licensed under the Apache License, Version 2.0.
https://kotlinlang.org/docs/compose-compiler-migration-guide.html