Configuration

All JNI settings are nested under platform.jvm.jni inside the kreate { } block.

Minimal Setup

kreate {
    platform {
        jvm {
            jni {
                enabled = true
            }
        }
    }
}

With only enabled = true, Kreate resolves all other values from the project configuration automatically.

Full Configuration

kreate {
    platform {
        jvm {
            jni {
                enabled = true
                nameOverride = "mylib"
                projectDirectory = layout.projectDirectory.dir("jni")
            }
        }
    }
}

DSL Reference

Property	Type	Default	Description
`enabled`	`Boolean`	`false`	Enables the JNI feature and registers all related tasks
`nameOverride`	`String?`	(project name)	Overrides the native project name used for CMake target and directory resolution
`projectDirectory`	`Directory?`	`<projectDir>/jni`	Root directory that contains the native project folder

`enabled`

Controls whether the entire JNI feature is active. When false (the default), no tasks are registered and no build pipeline changes are applied.

`nameOverride`

By default, Kreate derives the native project name from project.name in kreate { project { name = ... } }, falling back to the Gradle project name. The resolved name is sanitized before use. Use nameOverride when you need a specific CMake target name that differs from the Kotlin project name.

jni {
    enabled = true
    nameOverride = "mylib"  // CMake target: mylib, dir: jni/mylib/
}

`projectDirectory`

Overrides the root directory where Kreate looks for (and creates) the native project folder. The actual native project lives at <projectDirectory>/<projectName>/.

jni {
    enabled = true
    projectDirectory = layout.projectDirectory.dir("native")
    // Native project: native/<projectName>/
}

25 April 2026