Компілятор 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