Kotlin-Compiler

Elide enthält Kotlin 2.5.0-Beta1. Eine reine Laufzeit-Distribution meldet, dass kotlinc die vollständige Distribution benötigt.

Quelldateien kompilieren

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

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

kotlinc-Optionen folgen nach --, Elide-Optionen stehen davor. elide kotlinc --help listet die von Elide auf, elide kotlinc -- -help die von kotlinc.

elide java fügt die Kotlin-Standardbibliothek nicht hinzu, daher schlägt Code, der sie aufruft (listOf, joinToString), dort fehl:

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

Elide-Optionen

ABI-JARs

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

Das JAR enthält öffentliche und geschützte Signaturen, @Metadata, ABI-relevante inline-Rümpfe, const-Werte und Markierungen für Standardargumente. Eine unveränderte ABI ergibt ein byteidentisches JAR, sodass Änderungen an Rümpfen abhängige Module im Cache belassen.

ELIDE_KOTLINC_ABI_STRIP=1 überspringt die Codegenerierung für Rümpfe. Lassen Sie die Variable ungesetzt, wenn die ABI von Plugins generierte Deklarationen enthält, etwa $serializer von kotlinx.serialization. Worker akzeptieren sie pro Anfrage.

Projekte bauen

elide build kompiliert Kotlin-Source-Sets, die per Konvention gefunden oder in elide.pkl deklariert werden.

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

Jede Kompilierung schreibt ihre Argumente in kotlinc.args neben ihrer Ausgabe.

Plugins und Features

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

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

• Jeder Eintrag in plugins wird zu -P plugin:<id>:<key>=<value>, sortiert nach ID und Schlüssel.
• Plugins von Drittanbietern kommen in den Bucket kotlinPlugins und benötigen eine ManagedKotlinToolchain oder CustomKotlinToolchain. Der eingebettete Compiler warnt mit Custom Kotlin compiler plugins are not supported when using the embedded compiler, plugins will not be applied und kompiliert ohne sie.
• Ein integriertes Plugin, das in der Distribution fehlt, wird samt seinen Optionen übersprungen, mit einer Warnung.
• Implizite Kotlin-Bibliotheken gehen nur an Abhängigkeitswurzeln mit Kotlin-Quellen. reflection = false entfernt kotlin-reflect; compilerOptions.noStdlib = true entfernt es und die Standardbibliothek. Deklarierte Abhängigkeiten bleiben erhalten.
• project("core").friend() macht die internal-Deklarationen eines Geschwisterprojekts sichtbar; siehe Workspaces.
• Ein Source-Set sieht die internal-Deklarationen der Sets, von denen es im selben Projekt abhängt: jedes in seinem dependsOn genannte Set (main für ein Test-Set, das es weglässt) sowie die Sets, von denen diese abhängen.

Werkzeugkette wählen

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" }
}

Die Werkzeugkette gilt für Projekt-Builds; elide kotlinc verwendet immer den gebündelten Compiler.

KAPT und KSP werden nicht unterstützt. Kotlin-Code, der generierte Java-Typen verwendet, muss sie aus einem vorgelagerten Source-Set oder Projekt beziehen.

Beispiele

• Kotlin-Collections
• Kotlin-Tests

Beginnen Sie mit einer Vorlage:

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