Compilador Kotlin

Elide incluye Kotlin 2.5.0-Beta1. Una distribución solo de ejecución indica que kotlinc necesita la distribución completa.

Compilar archivos fuente

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

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

Las opciones de kotlinc van después de --; las de Elide, antes. elide kotlinc --help lista las de Elide; elide kotlinc -- -help, las de kotlinc.

elide java no añade la biblioteca estándar de Kotlin, así que el código que la usa (listOf, joinToString) falla ahí:

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

Opciones de Elide

JAR de ABI

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

El JAR contiene las firmas públicas y protegidas, @Metadata, los cuerpos inline relevantes para la ABI, los valores const y los marcadores de argumentos predeterminados. Una ABI sin cambios produce un JAR idéntico byte a byte, así que los cambios en los cuerpos mantienen en caché a los dependientes.

ELIDE_KOTLINC_ABI_STRIP=1 omite la generación de código de los cuerpos. Déjela sin definir cuando la ABI incluya declaraciones generadas por plugins, como el $serializer de kotlinx.serialization. Los workers la aceptan por solicitud.

Compilar proyectos

elide build compila los conjuntos de fuentes de Kotlin encontrados por convención o declarados en elide.pkl.

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

Cada compilación escribe sus argumentos en kotlinc.args, junto a su salida.

Plugins y funciones

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

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

• Cada entrada de plugins se convierte en -P plugin:<id>:<key>=<value>, en orden de id y clave.
• Los plugins de terceros van en el grupo kotlinPlugins y necesitan un ManagedKotlinToolchain o un CustomKotlinToolchain. El compilador integrado avisa con Custom Kotlin compiler plugins are not supported when using the embedded compiler, plugins will not be applied y compila sin ellos.
• Un plugin integrado que falta en la distribución se omite, junto con sus opciones, con una advertencia.
• Las bibliotecas implícitas de Kotlin solo se añaden a las raíces de dependencias con fuentes Kotlin. reflection = false quita kotlin-reflect; compilerOptions.noStdlib = true quita esa biblioteca y la estándar. Las dependencias declaradas se mantienen.
• project("core").friend() expone las declaraciones internal de un proyecto hermano; consulte Espacios de trabajo.
• Un conjunto de fuentes ve las declaraciones internal de los conjuntos de los que depende en el mismo proyecto: todos los nombrados en su dependsOn (main para un conjunto de pruebas que lo omite), junto con los conjuntos de los que estos dependen.

Elegir una cadena de herramientas

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

La cadena de herramientas se aplica a las compilaciones de proyectos; elide kotlinc usa siempre el compilador incluido.

KAPT y KSP no son compatibles. El código Kotlin que usa tipos Java generados debe obtenerlos de un conjunto de fuentes o proyecto anterior.

Ejemplos

• Colecciones de Kotlin
• Pruebas de Kotlin

Empiece desde una plantilla:

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