Migration from Gradle/KSP Plugin

Gradle and KSP plugins were useful tools in earlier versions of Kotlin DataFrame.
However, they are now being phased out. This section provides an overview of their current state and migration guidance.

Gradle Plugin

Generation of data schemas from data sources
(files, databases, or external URLs).
- You could copy already generated schemas from build/generate into your project sources.
- To generate a DataSchema for a DataFrame now, use the generate..() methods.
Generation of extension properties from data schemas
This is now handled by the Kotlin DataFrame Compiler Plugin, which:
- Generates extension properties for declared data schemas.
- Automatically updates the schema and regenerates properties after structural DataFrame operations.

If you still choose to use Gradle plugin, make sure to disable the automatic KSP plugin dependency to avoid compatibility issues with Kotlin 2.1+ by adding this line to gradle.properties:

kotlin.dataframe.add.ksp=false

KSP Plugin

Generation of data schemas from data sources
(files, databases, or external URLs).
- You could copy already generated schemas from build/generate/ksp into your project sources.
- To generate a DataSchema for a DataFrame now, use the
  generate..() methods instead.

If you still choose to use the KSP plugin with Kotlin 2.1+, disable KSP2 by adding this line to gradle.properties:

ksp.useKSP2=false

24 October 2025