Skip to content

Upgrade Kotlin to 2.4.20-Beta2 - #237

Draft
vRallev wants to merge 1 commit into
mainfrom
ralf/kotlin-2.4.20-beta2
Draft

Upgrade Kotlin to 2.4.20-Beta2#237
vRallev wants to merge 1 commit into
mainfrom
ralf/kotlin-2.4.20-beta2

Conversation

@vRallev

@vRallev vRallev commented Jul 31, 2026

Copy link
Copy Markdown
Owner

Summary

  • Upgrade the main build from Kotlin 2.4.10 to 2.4.20-Beta2; leave the standalone blueprints unchanged.
  • Adapt the compiler plugin to the Kotlin 2.4.20 FIR, IR, and compiler-test APIs.
  • Generate App Platform's renderer, robot, and scoped Metro binding containers in IR through Metro's extension API.
  • Keep only cross-module contribution-discovery hints in FIR and explicitly run App Platform's declaration generation before Metro's IR graph transformation.
  • Update compiler goldens and generated JVM API snapshots for the new IR output.

Issues found

Metro 1.4.0 enables IR class generation with Kotlin 2.4.20-Beta2. App Platform's former FIR declaration generators are therefore not invoked, which removes its generated bindings.

Moving the containers to IR uncovered two additional constraints:

  1. Metro's FIR-hint option is coupled to IR class generation in its Gradle plugin, but Native and Wasm downstream compilations cannot discover package callables generated in IR. The build now leaves class generation in IR enabled while retaining FIR only for Metro's package-level contribution hints.
  2. On Kotlin/Native, Metro must see App Platform's generated containers before it transforms and merges the graph. The Gradle plugins now set that compiler-plugin order explicitly.

The generated contribution containers are implementation details and no longer appear as source-level declarations or in JVM API snapshots.

Validation

  • Full Android unit, iOS simulator, Desktop, Linux, and Wasm test matrix: 1,953 tasks passed.
  • All 57 compiler-plugin tests passed.
  • Gradle plugin tests passed.
  • apiCheck, Detekt, Android lint, module-structure checks, generated test runners, and ktfmt passed.
  • Fresh cross-module Wasm and iOS simulator compilations passed with Metro IR generation enabled.
  • Configuration-cache storage and reuse passed.
  • Production Wasm distributions for both sample and recipes passed.

Upstream references: Kotlin 2.4.20-Beta2, Kotlin EAP configuration, Metro compiler API, Metro issue #2576, and Metro PR #2590.

@vRallev
vRallev force-pushed the ralf/kotlin-2.4.20-beta2 branch 2 times, most recently from fd7f0bf to ecc7c7b Compare July 31, 2026 20:44
Move the main build from Kotlin 2.4.10 to 2.4.20-Beta2 and adapt the compiler extension APIs and test goldens for the new compiler.

Metro's IR mode no longer invokes App Platform's FIR declaration generators, while downstream Native and Wasm compilations still need FIR package hints to discover contributions. Generate renderer, robot, and scoped binding containers in IR through Metro's contribution API, retain FIR only for cross-module hints, and order App Platform's compiler plugin before Metro's graph transformation. This keeps Metro class generation in IR enabled on every target.

Update the affected generated API snapshots and leave the standalone blueprints unchanged.
@vRallev
vRallev force-pushed the ralf/kotlin-2.4.20-beta2 branch from ecc7c7b to 65d913b Compare July 31, 2026 20:51
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant