Configuration

Le bloc graalvm { } à l'intérieur de nucleus.application { } configure les builds native-image GraalVM : la toolchain, le binaire de sortie, les arguments passés à native-image, les métadonnées de reachability et les réglages macOS et Windows. Chaque propriété est paresseuse et typée Property. Le bloc est défini sur JvmApplication, il se place donc à côté de mainClass et nativeDistributions.

Activer une native image

Mettez isEnabled = true et choisissez une toolchain. Une configuration minimale ressemble à ceci :

nucleus.application {
    mainClass = "com.example.MainKt"

    graalvm {
        isEnabled = true
        imageName = "myapp"

        // Téléchargez vous-même la distribution complète BellSoft Liberica NIK 25 et
        // installez-la en local — le provisioning automatique de Gradle ne récupère pas
        // la variante NIK.
        // En CI, configurez d'abord le JDK avec graalvm/setup-graalvm@v1.
        javaLanguageVersion = 25

        buildArgs.addAll(
            "-H:+AddAllCharsets",
            "-Djava.awt.headless=false",
            "-Os",
            "-H:-IncludeMethodData",
        )

        metadataRepository {
            enabled = true           // défaut
            version = "0.10.6"       // défaut
            excludedModules.add("com.example:my-lib")
        }
    }
}

Référence de graalvm

Définir les arguments de build

Les buildArgs sont transmis tels quels à native-image. Voici les arguments dont la plupart des apps desktop ont besoin :

Configurer le repository de metadata

Le plugin Nucleus télécharge l' Oracle GraalVM Reachability Metadata Repository et résout les entrées de chaque dépendance runtime du classpath. Le sous-bloc metadataRepository { } correspond à MetadataRepositorySettings.

metadataRepository {
    moduleToConfigVersion.put("io.ktor:ktor-client-core", "3.0.0")
    excludedModules.add("group:noisy-lib")
}

Configurer les réglages macOS

Le sous-bloc macOS { } correspond à GraalvmMacOSSettings.

Configurer les réglages Windows

Le sous-bloc windows { } correspond à GraalvmWindowsSettings. Sur Windows, les native images GraalVM sont liées dynamiquement au runtime Visual C++, qui ne fait pas partie d'une installation Windows propre. Regrouper les DLL du runtime à côté de l'exécutable permet à l'app de démarrer sans le Visual C++ Redistributable.

graalvm {
    windows {
        bundleCRuntime = true
        dlls.add("vcruntime140.dll")
    }
}

Pas de variant release

Contrairement aux build types JVM, GraalVM n'a pas de variant release : il n'existe ni packageReleaseGraalvmNative ni runReleaseGraalvmNative. Les tâches natives sont packageGraalvmNative et runGraalvmNative. C'est volontaire :

• L'élimination de code mort de ProGuard est redondante. native-image fait déjà une élimination de code mort en monde fermé au moment de la compilation.
• ProGuard peut renommer des classes encore référencées par reachability-metadata.json, ce qui casse le build silencieusement.

Utilisez -Os dans buildArgs pour optimiser la taille plutôt que ProGuard.

Et ensuite

• Vue d'ensemble GraalVM — ce que native-image apporte à une app Nucleus.
• Metadata automatique — les cinq couches de metadata que Nucleus assemble pour vous.
• Tâches et CI — les tâches Gradle et la configuration CI pour les builds natifs.
• Référence du DSL Gradle — toute la surface nucleus { }.