Setup Kotlin DataFrame on Android

Kotlin DataFrame doesn't provide a dedicated Android artifact yet, but you can add the Kotlin DataFrame JVM dependency to your Android project with minimal configuration:

dependencies {
    implementation("org.jetbrains.kotlinx:dataframe:1.0.0-Beta2")
}

android {
    // Requires Android 0+, i.e. SDK version 26 or higher.
    defaultConfig {
        minSdk = 26 
    }
    // Requires Java 8 or higher
    compileOptions {
        sourceCompatibility = JavaVersion.VERSION_1_8
        targetCompatibility = JavaVersion.VERSION_1_8
    }
    kotlinOptions {
        jvmTarget = "1.8"
    }
    packaging {
        resources {
            pickFirsts += listOf(
                "META-INF/AL2.0",
                "META-INF/LGPL2.1",
                "META-INF/ASL-2.0.txt",
                "META-INF/LICENSE.md",
                "META-INF/NOTICE.md",
                "META-INF/LGPL-3.0.txt",
                "META-INF/thirdparty-LICENSE",
            )
            excludes += listOf(
                "META-INF/kotlin-jupyter-libraries/libraries.json",
                "META-INF/{INDEX.LIST,DEPENDENCIES}",
                "{draftv3,draftv4}/schema",
                "arrow-git.properties",
            )
        }
    }
}
tasks.withType<org.jetbrains.kotlin.gradle.tasks.KotlinCompile> { 
    kotlinOptions.jvmTarget = "1.8" 
}

dependencies {
    implementation 'org.jetbrains.kotlinx:dataframe:1.0.0-Beta2'
}

android {
    // Requires Android 0+, i.e. SDK version 26 or higher.
    defaultConfig {
        minSdk 26
    }
    // Requires Java 8 or higher
    compileOptions {
        sourceCompatibility JavaVersion.VERSION_1_8
        targetCompatibility JavaVersion.VERSION_1_8
    }
    kotlinOptions {
        jvmTarget = "1.8"
    }
    packaging {
        resources {
            pickFirsts += [
                "META-INF/AL2.0",
                "META-INF/LGPL2.1",
                "META-INF/ASL-2.0.txt",
                "META-INF/LICENSE.md",
                "META-INF/NOTICE.md",
                "META-INF/LGPL-3.0.txt",
                "META-INF/thirdparty-LICENSE",
            ]
            excludes += [
                "META-INF/kotlin-jupyter-libraries/libraries.json",
                "META-INF/{INDEX.LIST,DEPENDENCIES}",
                "{draftv3,draftv4}/schema",
                "arrow-git.properties",
            ]
        }
    }
}
tasks.withType(org.jetbrains.kotlin.gradle.tasks.KotlinCompile).configureEach { 
    kotlinOptions.jvmTarget = "1.8"
}

This setup adds the general Kotlin DataFrame dependency, which includes the core API and implementation as well as all IO modules (excluding experimental ones). For flexible configuration, see Custom configuration.

Kotlin DataFrame Compiler Plugin

Kotlin DataFrame Compiler Plugin enables automatic generation of extension properties and updates data schemas on-the-fly in Android projects, making development with Kotlin DataFrame faster, more convenient, and fully type- and name-safe.

To enable the plugin in your Gradle project, add it to the plugins section:

plugins {
    kotlin("plugin.dataframe") version "2.2.20-Beta1"
}

plugins {
    id 'org.jetbrains.kotlin.plugin.dataframe' version '2.2.20-Beta1'
}

Due to this issue, incremental compilation must be disabled for now. Add the following line to your gradle.properties file:

kotlin.incremental=false

Next Steps

Once Kotlin DataFrame is set up in your Android project, continue with the Quickstart Guide to learn the basics of working with DataFrames.
Explore detailed guides and real-world examples to see how Kotlin DataFrame helps in different data tasks.
Check out the Android project example and more IDEA examples on GitHub.
Learn more about the compiler plugin.

22 August 2025