JavaFX WARNING: Unsupported JavaFX configuration: classes were loaded from ‘unnamed module @…’

by

TL;DR:

Make sure JavaFX is resolved as named modules.

  • Non-modular application:

    java --module-path <path-to-fx> --add-modules <fx-modules> ...

  • Modular application:

    java --module-path <path> --module <main-module>/<main-class> [args...]

    Where <path> includes your module as well as JavaFX.

  • Use JDK distribution which includes JavaFX (see answer below for more information). May still need to use --add-modules.

Background

This warning is related to the Java Platform Module System (JPMS) introduced in Java 9. If you’re not familiar with modules, then I recommend reading Understanding Java 9 Modules for a brief overview.

With JPMS came the module-path, which now exists alongside the class-path. When classes are loaded from the class-path they become a part of the so-called unnamed module. Whereas classes on the module-path are contained within modules, and are thus loaded “into” named modules. A named module may or may not be automatic, depending on if it has a module-info descriptor or not, respectively.

The Warning

JavaFX only supports being loaded as named modules. In other words, JavaFX only supports being loaded from the module-path, not the class-path. This has been implicitly true since version 9, back when the framework was modularized. But now, as of version 16, a warning is emitted if JavaFX detects it was loaded from the class-path (i.e. is in the unnamed module). See JDK-8256362.

Solution

The solution is to make sure JavaFX is loaded from the module-path and resolved as named modules. Note JavaFX is made up of seven modules, as can be seen by its documentation.

How exactly you ensure JavaFX is resolved as named modules may depend on your environment (e.g. non-modular vs modular application, external JavaFX SDK, etc.). The examples below all use the command-line to show how to set the needed arguments. However, if you’re using an IDE (e.g. NetBeans, IntelliJ, Eclipse) and/or a build tool (e.g. Maven, Gradle) and are unsure of where to set these arguments, then check out Getting Started with JavaFX 11+.

Note that both Gradle and Maven have plugins that make it easier to work with JavaFX (i.e. they handle all the configuration for you).

Non-modular Application

If your code is non-modular then you do not have a module-info descriptor. This means adding JavaFX to the module-path is not enough; you also have to force Java to resolve the JavaFX modules. That can be done via the --add-modules argument.

For example:

java --module-path <path-to-fx> --add-modules javafx.controls ...

Notice I only include the javafx.controls module in the --add-modules argument. This is because it requires the javafx.base and javafx.graphics modules, which means they will be implicitly pulled in.

If you need other modules then you need to include them in the --add-modules argument as well, separated by a comma.

Also, note it’s okay, in this case, to have your code and other non-modular dependencies on the class-path. The important part is that JavaFX is loaded from the module-path.

Modular Application

If your code is modular then you will have a module-info descriptor. This descriptor will have the necessary requires directives. In this case, you no longer need to use --add-modules, but you do need to make sure to launch your application as a module via --module.

For example:

module app {
  // transitively requires javafx.base and javafx.graphics
  requires javafx.controls;

  // export javafx.application.Application implementation's package
  // to at least javafx.graphics
  exports com.example.app to javafx.graphics;
}

java --module-path <path> --module app/com.example.app.Main [args...]

Note for this you need to not only put JavaFX on the module-path, but also your own module.

Use a JDK Distribution that Includes JavaFX

Since Java 11, JavaFX is no longer included in the JDK provided by Oracle. But Oracle is not the only vendor for Java based on OpenJDK. There are vendors out there that provide JDK distributions which include JavaFX. At least two of them are:

When JavaFX is included in the JDK, it’s now part of the run-time image like all the other Java modules (e.g. java.base). This means it will automatically be loaded as named modules and you no longer have to manually put JavaFX on the module-path. However, if your application is non-modular then you may still need to use --add-modules (not sure).

Deployment

When you go to deploy a JavaFX application, including JavaFX in the run-time image is likely the easiest approach. You can do this with the jlink / jpackage tools. And this can be done with either a JDK that includes JavaFX or an external JavaFX SDK. However, if you use the latter then make sure to use the JMOD files when making the custom run-time image (or use the JavaFX JARs from Maven Central, which embed the needed native code).

If your code is non-modular, then you’d create a custom run-time image that includes JavaFX (and all the other non-automatic named modules needed by your application), and then configure jpackage to place your code (and all non-modular dependencies) on the class-path.

Ignore the Warning

As far as I can tell, nothing currently breaks if JavaFX is loaded from the class-path. This means another option, at least for now, is to just ignore the warning. However, I recommend putting at least JavaFX on the module-path if you can do so without too much trouble.

More Related Contents:

  1. Applying MVC With JavaFx
  2. Maven Shade JavaFX runtime components are missing
  3. JavaFX and OpenJDK
  4. Most efficient way to log messages to JavaFX TextArea via threads with simple custom logging frameworks
  5. How to create Splash screen with transparent background in JavaFX
  6. Play a Youtube video using JavaFX
  7. Bind Font Size in JavaFX?
  8. getting java.lang.reflect.InvocationTargetException while adding a button to layout
  9. Swing vs JavaFx for desktop applications [closed]
  10. JavaFX Application Icon
  11. Throttling javafx gui updates
  12. How to pass parameters to JavaFX application?
  13. Javafx: Difference between javafx.concurent and Platform.runLater?
  14. JavaFX effect on background
  15. JavaFX print tableview on multiple pages
  16. How show specific part of an image in javafx
  17. Localdate.format, format is not applied
  18. How to get GridPane Row and Column IDs on Mouse Entered in each cell of Grid in JavaFX?
  19. getHostServices().showDocument() in a FXML File
  20. IntelliJ IDEA – Error: JavaFX runtime components are missing, and are required to run this application [duplicate]
  21. JavaFX and maven: NullPointerException: Location is required
  22. Implement tags bar in JavaFX
  23. What is the best way to read pixels of a JavaFX Canvas?
  24. JavaFx 8: open a link in a browser without reference to Application
  25. JavaFX resource handling: Load HTML files in WebView
  26. On JavaFX, how to hide stage without disposing it and closing the application?
  27. Updating your UI and forcibly waiting before continuing JavaFX
  28. JavaFX Spell checker using RichTextFX how to create right click suggestions
  29. Javafx 2 click and double click
  30. How do I open the JavaFX FileChooser from a controller class?

Leave a Comment