Компилятор Kotlin

Elide включает Kotlin 2.5.0-Beta1. Дистрибутив только со средой выполнения сообщает, что kotlinc нужен полный дистрибутив.

Компиляция исходных файлов

// Hello.kt
fun main() = println("Hello!")

elide kotlinc -- -d out Hello.kt
elide java -- -cp out HelloKt

Параметры kotlinc указываются после --, параметры Elide — до него. elide kotlinc --help выводит параметры Elide, elide kotlinc -- -help — параметры kotlinc.

elide java не добавляет стандартную библиотеку Kotlin, поэтому код, который её вызывает (listOf, joinToString), там завершается ошибкой:

fun main() = println(listOf("Hello", "Kotlin").joinToString(" "))

Параметры Elide

ABI JAR

elide kotlinc --abi-only -- -d header.jar src/**/*.kt

JAR содержит публичные и защищённые сигнатуры, @Metadata, значимые для ABI тела inline, значения const и маркеры аргументов по умолчанию. Неизменённый ABI даёт побайтно идентичный JAR, поэтому правки тел функций сохраняют зависимые модули в кеше.

ELIDE_KOTLINC_ABI_STRIP=1 пропускает генерацию кода тел. Не задавайте эту переменную, если ABI включает объявления, сгенерированные плагинами, например $serializer из kotlinx.serialization. Воркеры учитывают её для каждого запроса отдельно.

Сборка проектов

elide build компилирует наборы исходников Kotlin, найденные по соглашению или объявленные в elide.pkl.

kotlin {
  apiLevel = "auto"
  languageLevel = "auto"
  compilerOptions {
    allWarningsAsErrors = true
    optIn { "kotlin.time.ExperimentalTime" }
    freeCompilerArgs { "-Xcontext-parameters" }
  }
}

Каждая компиляция записывает свои аргументы в kotlinc.args рядом с результатом.

Плагины и функции

kotlin {
  features {
    metro = false
  }
  plugins {
    ["org.jetbrains.kotlinx.serialization"] {
      ["mode"] = "json"
    }
  }
}

dependencies {
  maven {
    kotlinPlugins { "com.example:my-compiler-plugin:1.0.0" }
  }
}

• Каждая запись plugins превращается в -P plugin:<id>:<key>=<value>, с сортировкой по id и ключу.
• Сторонние плагины указываются в группе kotlinPlugins и требуют ManagedKotlinToolchain или CustomKotlinToolchain. Встроенный компилятор выдаёт предупреждение Custom Kotlin compiler plugins are not supported when using the embedded compiler, plugins will not be applied и компилирует без них.
• Встроенный плагин, которого нет в дистрибутиве, пропускается вместе с его параметрами, с предупреждением.
• Неявные библиотеки Kotlin добавляются только в корни зависимостей с исходниками на Kotlin. reflection = false убирает kotlin-reflect; compilerOptions.noStdlib = true убирает его и стандартную библиотеку. Объявленные зависимости остаются.
• project("core").friend() открывает internal-объявления соседнего проекта; см. Рабочие пространства.
• Набор исходников видит internal-объявления наборов, от которых он зависит в том же проекте: каждого набора, указанного в его dependsOn (main для тестового набора, где он не указан), а также наборов, от которых зависят они.

Выбор инструментария

import "elide:Kotlin.pkl" as Kotlin

kotlin {
  toolchain = "embedded"                                       // the default
  // toolchain = new Kotlin.ManagedKotlinToolchain { version = "2.4.0" }
  // toolchain = new Kotlin.CustomKotlinToolchain { path = "/opt/kotlinc" }
}

Инструментарий применяется к сборкам проектов; elide kotlinc всегда использует встроенный компилятор.

KAPT и KSP не поддерживаются. Код на Kotlin, использующий сгенерированные типы Java, должен получать их из вышестоящего набора исходников или проекта.

Примеры

• Коллекции Kotlin
• Тесты на Kotlin

Начните с шаблона:

elide init --template ktjvm       # Kotlin app with a test