El nuevo esquema de compilación separada de Kotlin alinea las compilaciones multiplataforma con el IDE

  • PublicPublic
  • 28 Sep, 2026
El nuevo esquema de compilación separada de Kotlin alinea las compilaciones multiplataforma con el IDE

El enfoque actual de compilación de Kotlin Multiplatform funciona, pero puede producir un comportamiento inesperado y difícil de predecir. El problema de fondo es una discrepancia entre el IDE y el compilador: resuelven de forma distinta las llamadas desde los conjuntos de fuentes comunes a declaraciones de las dependencias. En Kotlin 2.5.0-Beta1, JetBrains añadió una «compilación separada» opcional que pretende corregirlo: hacer que el resultado de la compilación coincida con el análisis del IDE y señalar con más precisión las llamadas problemáticas desde los conjuntos de fuentes comunes al código de las bibliotecas. Como extra, el esquema también habilita la compilación incremental para los conjuntos de fuentes comunes.

El problema tiene su origen en la estructura de un módulo KMP. Un módulo con código común suele contener varios conjuntos de fuentes: uno común (commonMain) y conjuntos para plataformas concretas (jvmMain para Kotlin/JVM). Durante la compilación de un conjunto de fuentes de plataforma, el código de jvmMain más todos los conjuntos comunes relacionados se compila contra los artefactos de plataforma de las dependencias. Por eso el código de commonMain puede resolverse de forma implícita a una declaración de jvmMain en una dependencia, algo que IntelliJ IDEA no permite. Como las declaraciones de jvmMain no se incluyen en los metadatos KLIB, el IDE muestra el error «unresolved reference» para esas llamadas, mientras que el compilador las acepta sin avisar y el código se compila sin errores.

Activar la compilación separada hace que el compilador se comporte de forma más estricta, alineándolo con el IDE. La opción opcional se añade a gradle.properties como kotlin.kmp.separateCompilation=true, y la función está desactivada por defecto porque es Experimental. Con la opción activada, el código que antes se compilaba ahora falla: por ejemplo, la llamada a Foo desde app/commonMain, cuando class Foo se declara solo en lib/jvmMain, se convierte en un error de compilación en lugar de una advertencia solo en el IDE. La solución es establecer una conexión explícita mediante expect/actual: declarar expect class Foo en lib/commonMain y marcar la versión de la plataforma como actual class Foo. La misma regla se aplica a los conjuntos de código comunes commonTest, ya que las pruebas «dependen» del código principal; commonTest, compilado contra jvmMain, ya no puede acceder a las declaraciones de la plataforma sin un expect correspondiente en commonMain.

El esquema también resuelve las discrepancias en la selección de sobrecargas. Cuando hay varias sobrecargas en lib/commonMain y lib/jvmMain, el IDE y el compilador eligen actualmente declaraciones distintas. Por ejemplo, con fun foo(x: Any) en commonMain y fun foo(x: String) en jvmMain, el IDE resuelve foo("") a la sobrecarga común Any, pero la compilación elige la sobrecarga más específica String, y en tiempo de ejecución se imprime «platform». Con la compilación separada, la llamada se resuelve a la declaración común y se imprime «common», lo que coincide con el comportamiento del IDE. Un fallo más complicado aparece cuando el error surge solo en el código de plataforma: si las clases actual añaden supertipos que sus equivalentes expect no tienen, la inferencia del tipo de retorno puede colapsar en la JVM a Any y romper la referencia a .name, provocando errores de compilación solo en la JVM.

Con la compilación separada, app/commonMain resuelve las llamadas únicamente contra las declaraciones de eventsLib/commonMain, por lo que el compilador infiere el tipo de retorno correcto Event, y la compilación para la JVM termina sin problemas. JetBrains documenta problemas conocidos que todavía se están corrigiendo. Lo más importante: para que la compilación separada funcione correctamente, los autores de bibliotecas deben publicar KLIB de metadatos; este ya es el comportamiento predeterminado de las tareas de publicación del plugin de Gradle para KMP, pero el nuevo esquema hace que esos KLIB sean imprescindibles. Dado que la función es Experimental, conviene esperar comprobaciones más estrictas en tiempo de compilación y planificar la adaptación del código existente en consecuencia.