Spec-Zone.ru › Kotlin 2

DSL параметров компилятора Compose

Плагин Gradle для компилятора Compose предоставляет DSL для различных параметров компилятора. С его помощью можно настроить компилятор в блоке composeCompiler {} файла build.gradle.kts модуля, к которому применяется плагин.

Можно указать два типа параметров:

  • Общие настройки компилятора, которые при необходимости можно отключать или включать в каждом конкретном проекте.

  • Флаги функций, которые включают или отключают новые и экспериментальные функции, со временем предназначенные для включения в базовую конфигурацию.

Список доступных общих настроек и список поддерживаемых флагов функций можно найти в справочнике API плагина Gradle для компилятора Compose.

Пример конфигурации:

composeCompiler {
    includeSourceInformation = true

    featureFlags = setOf(
        ComposeFeatureFlag.StrongSkipping.disabled(),
        ComposeFeatureFlag.OptimizeNonSkippingGroups
    )
}

Для нескольких параметров компилятора Compose, которые до Kotlin 2.0 задавались только вручную, плагин Gradle предоставляет значения по умолчанию. Если какие-либо из них заданы с помощью freeCompilerArgs, например, Gradle сообщит об ошибке дублирования параметров.

Назначение и использование флагов функций

Флаги функций выделены в отдельный набор параметров, чтобы свести к минимуму изменения свойств верхнего уровня при постоянном добавлении и устаревании новых флагов.

Чтобы включить флаг функции, отключенный по умолчанию, укажите его в наборе, например:

featureFlags = setOf(ComposeFeatureFlag.OptimizeNonSkippingGroups)

Чтобы отключить флаг функции, включенный по умолчанию, вызовите для него функцию disabled(), например:

featureFlags = setOf(ComposeFeatureFlag.StrongSkipping.disabled())

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

-P plugin:androidx.compose.compiler.plugins.kotlin:featureFlag=<flag name>

См. список поддерживаемых флагов функций в справочнике API плагина Gradle для компилятора Compose.

23 февраля 2025 г.
Руководство по миграции компилятора ComposeAPI обработки символов Kotlin

© 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-options.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API