📥 😩 🚷 Tutoriel JavaFX: Prise en main 🏬 🍳 🛋️

Bonjour, Habr! Je vous présente la traduction de l'article «JavaFX Tutorial: Getting Started» de Vojtech Ruzicka.

Comment configurer et démarrer avec JavaFX à l'aide du SDK Maven, Gradle ou JavaFX.

Tous les articles de la série JavaFX:

Installation Java

JavaFX, bien sûr, nécessite que JDK soit installé. L'obtention des dépendances requises varie selon les différentes versions de Java.

JavaFX a été introduit dans le cadre de la sortie de Java 8. Cependant, il a ensuite été supprimé du JDK et
porté sur un module distinct dans Java 11.

Cela signifie que si vous ciblez Java 8-10, vous disposez déjà de toutes les dépendances nécessaires dans votre JDK. Hourra! Si vous utilisez une version plus récente de Java - c'est-à-dire 11+, vous devez obtenir les dépendances séparément.

Maven

Obtenir et gérer les dépendances manuellement est plutôt gênant, et dans une application réelle, vous le feriez rarement. Il est préférable d'utiliser un système de gestion des dépendances tel que Maven ou Gradle. De cette façon, vous pouvez simplement déclarer les dépendances que vous utilisez et les versions, et le système se chargera du reste.

Archétype Maven

Bien sûr, vous pouvez configurer votre projet Maven manuellement, à partir de zéro. Cependant, vous préférerez peut-être un moyen plus pratique de créer la structure et le contenu du projet de base pour vous en utilisant Maven.

Maven a le concept d'archétypes, ce qui signifie essentiellement que vous pouvez créer différents types de projets à partir d'un modèle. Il existe de nombreux archétypes pour différents types de projets, et heureusement, il en existe quelques-uns pour JavaFX. L'archétype que vous pouvez choisir dépend de la version de Java que vous utilisez.

Vous pouvez en savoir plus sur les archétypes Maven dans le post suivant: Tutoriel sur les archétypes Maven .

Archétype Java 8

Vous pouvez utiliser com.zenjava: javafx-basic-archetype , ou vous pouvez trouver d'autres archétypes par vous-même si celui-ci ne vous convient pas.

Vous pouvez facilement générer un projet à partir de la ligne de commande en utilisant Maven en utilisant l'archétype ci-dessus:

mvn archetype:generate -DarchetypeGroupId=com.zenjava -DarchetypeArtifactId=javafx-basic-archetype

Alternativement, vous pouvez créer un nouveau projet Maven à partir d'un archétype directement dans votre IDE.

Archétype Java 11

Pour Java 11, vous pouvez utiliser org.openjfx: javafx-archetype-simple .

Pour créer un projet, exécutez simplement:

 mvn archetype:generate -DarchetypeGroupId=org.openjfx -DarchetypeArtifactId=javafx-archetype-simple

Réglage manuel de Maven

Si vous souhaitez plus de contrôle, vous pouvez configurer manuellement votre projet Maven sans le générer à partir de l'archétype.

Vous avez d'abord besoin de deux composants. Le premier est Maven Plugin pour Java FX .

Ajoutez simplement ce qui suit à votre pom.xml:

 <build> <plugins> <plugin> <groupId>org.openjfx</groupId> <artifactId>javafx-maven-plugin</artifactId> <version>0.0.3</version> <configuration> <mainClass>com.example.App</mainClass> </configuration> </plugin> </plugins> </build>

Veuillez noter que

 <mainclass>

devrait pointer vers votre classe principale, qui a une méthode principale et étend javafx.application.Application. Nous en parlerons dans le prochain article de la série.

La deuxième partie ajoute une dépendance pour les contrôles JavaFX :

 <dependency> <groupId>org.openjfx</groupId> <artifactId>javafx-controls</artifactId> <version>11.0.2</version> </dependency>

Gradle

Gradle ne prend actuellement pas en charge la création de projets directement à partir d'archétypes .

Vous pouvez utiliser le plugin Gradle Archetype non officiel et utiliser les archétypes Maven mentionnés ci-dessus.
Vous pouvez également créer votre projet à l'aide de Maven à partir d'un archétype, puis le convertir en projet Gradle à l'aide de la commande suivante dans le répertoire contenant votre pom.xml:

 gradle init

Gradle manuel

Comme avec Maven manuel, vous devez ajouter le plugin JavaFX:

 plugins { id 'application' id 'org.openjfx.javafxplugin' version '0.0.8' }

Et la dépendance pour les contrôles:

 javafx { version = "11.0.2" modules = [ 'javafx.controls' ] }

SDK JavaFX

Il existe une autre possibilité d'utiliser JavaFX localement. Vous pouvez télécharger le SDK JavaFX. Il contient toutes les bibliothèques nécessaires que vous pouvez ensuite lier au projet dans votre IDE ou ajouter au chemin de classe.

Cela peut être utile lorsque vous n'êtes pas familier avec Gradle ou Maven et uniquement pour le développement local.

Lors de la distribution de votre application, cela devient gênant, car vous devez vous assurer que vous incluez toutes les dépendances nécessaires.

Avec cette option, vous pouvez générer un projet sans Maven / Gradle dans votre IDE, qui contient tous les fichiers nécessaires. Dans IntelliJ IDEA, vous pouvez simplement accéder à:

 File → New → Project → JavaFX

Lecture complémentaire

Code source de l'application Hello World JavaFX - Gradle
Code source de l'application Hello World JavaFX - Maven
JavaFX 13 et IntelliJ
JavaFX 13 et NetBeans
JavaFX 13 et Eclipse

Et ensuite

Cet article est le premier d'une série de JavaFX. Dans la prochaine, nous vous montrerons comment créer et exécuter votre toute première application JavaFX .

Tutoriel JavaFX: Prise en main