Ajoutez le plugin Gradle Nucleus à un projet Kotlin pour cibler macOS, Linux et Windows depuis un seul build.

Dans ce tutoriel, vous allez ajouter le plugin Gradle Nucleus à un projet Kotlin. Une fois le plugin appliqué, le même build peut compiler, lancer et empaqueter une application de bureau pour macOS, Linux et Windows.

Avant de commencer

Nucleus s'appuie sur Compose Multiplatform et demande :

JDK 17 ou version ultérieure dans votre PATH.
Kotlin 2.4.10 ou version ultérieure — voir Compatibilité pour la version exigée par chaque ligne de Nucleus.
Gradle 8.0 ou version ultérieure. Le wrapper Gradle fourni dans les nouveaux projets suffit.

Le JDK 25 ou version ultérieure n'est requis que pour générer le cache AOT (enableAotCache dans nativeDistributions). N'importe quel JDK 17+ convient pour le développement.

Compatibilité

Version Nucleus	Version Kotlin	Version Compose
2.5.0 – 2.5.15	2.4.10+	1.12.0
2.0.0 – 2.4.7	2.4.0+	1.11.1

La version de Compose est une exigence, pas un plancher : decorated-window-tao s'appuie sur des API internes de Compose Multiplatform qui changent d'une version mineure à l'autre. La 2.5.x requiert donc 1.12.0 et ne fonctionnera pas sur 1.11.x. Épinglez le plugin Compose à la ligne qui correspond à votre version de Nucleus.

La version de Kotlin, elle, est un minimum. Nucleus est compilé avec la version du tableau, et un compilateur plus ancien ne sait pas lire ses métadonnées.

Appliquer le plugin

Dans le build.gradle.kts de votre module, appliquez le plugin Nucleus aux côtés des plugins Kotlin et Compose :

build.gradle.kts

plugins {
    kotlin("jvm") version "2.4.10"
    id("org.jetbrains.compose") version "1.12.0"
    id("dev.nucleusframework") version "2.5.15"
}

Le bloc plugins résout dev.nucleusframework depuis le Gradle Plugin Portal ; aucun dépôt pluginManagement supplémentaire n'est nécessaire.

Ajouter les dépôts

Les modules runtime de Nucleus sont publiés sur Maven Central sous le groupe dev.nucleusframework. Ajoutez les dépôts dont le plugin et son runtime ont besoin :

build.gradle.kts

repositories {
    mavenCentral()
    google()
}

Vérifier que le plugin est appliqué

L'application du plugin enregistre un groupe de tâches nucleus. Listez ses tâches pour confirmer que le plugin est chargé :

./gradlew tasks --group nucleus

Si la commande affiche les tâches du groupe, le plugin est appliqué et vous pouvez commencer à construire.

Et ensuite

Quickstart — écrivez une fonction main, lancez une fenêtre Tao native et empaquetez un installeur.
Project setup — dépôts, propriétés Gradle, toolchains JDK et layout multi-module.
Configuration — le DSL nucleus { } complet.

Installation