Utiliser JavaFX dans IntelliJ

CS-108

Introduction

JavaFX est une bibliothèque Java de création d'interfaces utilisateur graphiques. JavaFX faisait initialement partie de la bibliothèque standard Java, mais est devenu par la suite un projet séparé. Pour cette raison, il est nécessaire d'installer JavaFX avant de pouvoir l'utiliser dans un projet, et ce document décrit la marche à suivre.

Installation de JavaFX

Pour installer JavaFX, il faut commencer par télécharger l'archive Zip contenant la version correspondant à votre système d'exploitation (Windows, macOS ou Linux). Pour cela, rendez-vous sur la page de téléchargement d'OpenJFX et choisissez, dans les menus déroulants :

  • la version 22,
  • le système d'exploitation que vous utilisez,
  • si vous la connaissez, l'architecture de votre ordinateur,
  • le type SDK.

Une fois l'archive téléchargée, décompressez-la dans un dossier de votre choix. Si vous avez déjà un dossier contenant tous les projets liés à ce cours (séries d'exercices, projet principal, etc.), il est conseillé d'y placer également JavaFX, afin de garder de l'ordre.

La décompression de l'archive devrait créer un dossier nommé javafx-sdk-22 contenant au moins deux sous-dossiers nommés legal et lib. Sur Windows, un sous-dossier bin existe également.

Configuration d'IntelliJ

Une fois l'archive décompressée, il faut encore configurer IntelliJ pour qu'il ait connaissance de cette bibliothèque, puis ajouter la bibliothèque à tous les projets qui l'utilisent.

Ajout de la bibliothèque

Afin qu'il soit possible d'utiliser JavaFX dans des projets depuis IntelliJ, il faut l'ajouter sous la forme d'une bibliothèque globale (global library), de la manière suivante :

  1. dans le menu File, choisissez New Project Setup puis Structure…,
  2. dans la partie de gauche, cliquez sur Global Libraries dans la section nommée Platform Settings,
  3. dans la partie centrale, cliquez sur le bouton + en haut, puis choisissez Java dans le menu New Global Library qui s'ouvre,
  4. naviguez vers le dossier lib créé lors de la décompression de l'archive et sélectionnez tous les fichiers qu'il contient (ceci est très important),
  5. cliquez sur Open (ou équivalent),
  6. changez le nom de la bibliothèque ainsi créée en OpenJFX 22, en modifiant le champ situé à droite de l'étiquette Name:,
  7. cliquez sur le bouton + situé sous l'étiquette Name:,
  8. sélectionnez le fichier src.zip qui se trouve dans le dossier parent du dossier lib,
  9. cliquez sur Open (ou équivalent),
  10. cliquez OK dans la boîte de dialogue qui s'ouvre alors.

Une fois ces opérations effectuées, la fenêtre devrait avoir l'apparence suivante (les rectangles violets masquent la partie des chemins qui dépendent de votre système) :

intellij-openjfx;64.png

Vous pouvez alors fermer la fenêtre en cliquant sur OK.

Utilisation de JavaFX dans un projet

Une fois la bibliothèque ajoutée à IntelliJ, il est possible de l'utiliser dans un projet quelconque de la manière suivante :

  1. dans le menu File, choisissez Project Structure…,
  2. dans la partie de gauche, cliquez sur Modules dans la section nommée Project Settings,
  3. dans la partie de droite, sélectionnez l'onglet Dependencies,
  4. dans la partie de droite toujours, cliquez sur le bouton +, puis choisissez l'entrée Library… du menu qui s'ouvre,
  5. dans la fenêtre qui s'ouvre, choisissez OpenJFX 22, puis cliquez sur Add Selected.

Une fois ces opérations effectuées, la fenêtre devrait avoir l'apparence suivante :

intellij-openjfx-proj;64.png

Vous pouvez alors fermer la fenêtre en cliquant sur OK, et JavaFX devrait être utilisable dans votre projet. Pour le vérifier, vous pouvez y ajouter temporairement le programme suivant : 

import javafx.scene.paint.Color;

public final class CheckJavaFx {
  public static void main(String[] args) {
    Color c = Color.RED;
    System.out.println(c.getRed());
  }
}

Si vous arrivez à l'exécuter et qu'il affiche 1.0, cela signifie que JavaFX est correctement installé.