Hello World in JavaFX
Hello World in JavaFX
April 16, 2020

The official definition of JavaFX - OpenJFX is an open source, next generation client application platform for desktop, mobile and embedded systems built on Java.

JavaFX in an open-source platform and follows GPL with the class path exception, similar to OpenJDK. This tutorial provides all the steps required to write the Hello World Application in JavaFX using e(fx)clipse plugin for the Eclipse IDE and JavaFX SDK. We can also use either of the build systems among Maven or Gradle instead of JavaFX SDK. It assumes that Java and eclipse are already installed on the system.

The tutorials relevant to installing Java and Eclipse include How To Install Java 14 On Ubuntu, How To Install OpenJDK 14 On Ubuntu, How To Install Java 14 On Windows, How To Install OpenJDK 14 On Windows, How To Install Eclipse For Java On Windows, and How To Install Eclipse For Java Development On Ubuntu.

The steps provided in this tutorial should be the same on both Windows and Ubuntu. I have used OpenJDK 14.0.1, Eclipse Java 2020 03 R, e(fx)clipse 3.6.0, and JavaFX SDK 14 while writing this tutorial.

Step 1 - Install e(fx)clipse Plugin

In this step, we will install the e(fx)clipse plugin for the Eclipse IDE. Click the Help Option on the Main Menu and click the Eclipse Marketplace Option as shown in Fig 1.

JavaFX - Eclipse Marketplace

Fig 1

Search for JavaFX as shown in Fig 2.

JavaFX - e(fx)clipse

Fig 2

Now click the Install Button to start installing e(fx)clipse plugin on Eclipse. It will ask to accept the License Agreement as shown in Fig 3.

JavaFX Plugin - License Agreement

Fig 3

Accept the License and click the Finish Button to start the installation. It will ask to restart the IDE after successfully installing the plugin as shown in Fig 4.

JavaFX - Restart Eclipse

Fig 4

Click Restart Now to apply the plugin-specific changes. This completes the installation of e(fx)clipse plugin on Eclipse.

Step 2 - Create JavaFX Project

Now click the New Option on Main Menu and click the Other Option. It will show the project type selection wizard as shown in Fig 5.

JavaFx - Eclipse - Create Project

Fig 5

Now click the Next Button to configure the project as shown in Fig 6.

JavaFx - Eclipse - Configure Project

Fig 6

Configure the project and click the Next Button. We can further configure the Java for the project as shown in Fig 7.

JavaFx - Eclipse - Configure Project

Fig 7

Now click the Next Button to configure the Application as shown in Fig 8.

JavaFx - Eclipse - Configure Application

Fig 8

Finally, click the Finish Button to complete the project creation and configuration. It will create the project and shows on the projects library as shown in Fig 9.

JavaFx - Eclipse - Project

Fig 9

Step 3 - Fix the Imports

In this step, we will fix the imports by creating a user-defined library since JavaFX is not bundled with the JDK since Java 11. We need to create this library for the first time and it can be used for multiple projects. Open the Application Class file to view the import errors as shown in Fig 10.

JavaFx - Eclipse - Import Errors

Fig 10

Download the JavaFX SDK from the official website. We can use either JavaFX 11 LTS or JavaFX 14 as shown in Fig 11. I have downloaded JavaFX 14 SDK as highlighted in Fig 11.

JavaFX - Download SDK

Fig 11

Now extract the download JavaFX SDK to the appropriate location. We will add a new user-defined library to the eclipse. Click the Window Option on the Main Menu and navigates to Preferences -> Java -> Build Path -> User Libraries and click the New Button as highlighted in Fig 12.

JavaFX SDK - Eclipse - User Library

Fig 12

On clicking the New Button, it will ask the library name as shown in Fig 13.

JavaFX SDK - Eclipse - User Library

Fig 13

Provide the appropriate library name and click the OK Button. It will create the library as shown in Fig 14.

JavaFX SDK - Eclipse - User Library

Fig 14

Now click the Add External JARs Button as highlighted in Fig 14. It will ask to choose the JARs to be added to the library created by us. Navigate to the lib directory of the JavaFX SDK downloaded by us and select the JARs as shown in Fig 15.

JavaFX SDK - Eclipse - User Library

Fig 15

Now click the Open Button to add the JARs to the library. The library gets updated with the selected JARs as shown in Fig 16.

JavaFX SDK - Eclipse - User Library

Fig 16

Click the Apply and Close Button to finalize the library. Now right-click the project and click the Properties Option. Click the Java Build Path and Libraries as shown in Fig 17. I have also highlighted the Classpath.

JavaFX SDK - Eclipse - Classpath

Fig 17

Click the Add Library Button on the left side to add the library created by us. It will open the wizard to add the library as shown in Fig 18.

JavaFX SDK - Project - Add Library

Fig 18

Now choose User Library and click the Next Button. It will show all the user libraries as shown in Fig 19 a and Fig 19 b.

JavaFX SDK - Eclipse - User Library

Fig 19 a

JavaFX SDK - Eclipse - User Library

Fig 19 b

Choose the JavaFX library created by us and click the Finish Button. Also, note that I have removed the JavaFX SDK library added by the e(fx)clipse plugin. Now click Apply and Close Button. It will add the library to our project and also resolve the import errors.

Step 4 - Run the Project

In this step, we configure the project runtime and run the project. Now right-click the Project -> Run As -> Java Application as shown in Fig 20.

JavaFX - Eclipse - Run Project

Fig 20

It will ask to choose the Main Class as shown in Fig 21.

JavaFX - Eclipse - Main Class

Fig 21

Now choose the Main class and click the OK Button to execute the application. It will show the missing runtime error as shown in Fig 22.

JavaFX - Eclipse - Runtime Missing

Fig 22

So, the default run configuration did not execute our project since it's missing the JavaFX runtime components. We can configure it for the project by creating our own Run Configuration. Now right-click the Project -> Run As -> Run Configuration as shown in Fig 23.

JavaFX - Eclipse - Run Configuration

Fig 23

It will show the run configurations as shown in Fig 24.

JavaFX - Eclipse - Run Configuration

Fig 24

Now click the New launch configuration Icon as highlighted in Fig 24 and configure the Arguments as shown in Fig 25.

Click the Arguments Tab and use the below-mentioned arguments by providing the appropriate path to the JavaFX SDK.

--module-path "<path to JavaFX SDK>\lib" --add-modules javafx.controls,javafx.fxml

JavaFX - Eclipse - Launch Configuration

Fig 25

Also, configure the Main Class as shown in Fig 26.

JavaFX - Eclipse - Run Configuration

Fig 26

Now click the Apply Button and click the Run Button to execute the application using the Run Configuration created by us. It will build and run the application as shown in Fig 27.

JavaFX SDK - Java Version Issues

Fig 27

This is the simplest application that can be written using JavaFX.

Summary

This tutorial provided all the steps required to install e(fx)clipse plugin for the Eclipse IDE and also provided all the configurations and processes required to create and execute the first JavaFX application.

Write a Comment

Click on the captcha image to get new code.
Discussion Forum by DISQUS