KorGE Targets Desktop (JVM)

It supports Java 8 and greater. This should be the preferred target while developing.

Uses the Kotlin JVM backend, generating JVM bytecode and executing the code on the Java Virtual Machine.

This integrates pretty well on the IDEs, have fast building and startup times, and provides a great tools like a better debugging experience. All these features makes it the best target for debugging and trying things fast.

Table of contents:

Entrypoint

While other targets use korge { entrypoint = "main" }, the JVM target uses its own jvmMainClassName property indicating the class that will contain the main entry point. It defaults to MainKt referencing the package-less root main.kt file:

korge {
	jvmMainClassName = "MainKt"
}

Executing

For running, use the gradle task:

./gradlew runJvm

Testing

For executing tests on the JVM only, use the gradle task:

./gradlew jvmTest

Packaging

For creating a FatJAR, use the gradle task:

./gradlew packageJvmFatJar

For creating a FatJAR using proguard for thinner sizes, use the gradle task:

./gradlew packageJvmFatJarProguard

You can find the jar files in the build/libs folder. Full jar files should have the -all.jar suffix, while the proguarded ones, -all-proguard.jar.

Reducing pause times

Starting with Java 14, all major targets support ZGC, that should make GC pauses to be less than 10ms.

https://wiki.openjdk.java.net/display/zgc/Main

You can enable it with -XX:+UnlockExperimentalVMOptions -XX:+UseZGC.

Future KorGE versions will enable this by default on supported Java versions.