IntelliJ can't recognize JavaFX 11 with OpenJDK 11

Question

I'm having trouble getting IntellJ to recognize JavaFX packages. With a new JavaFX project, with OpenJDK 11, when trying to build the project, IntelliJ can't recognize the JavaFX packages.

I've imported openjfx:javafx-base-11 from the Maven repo.

I've looked at other questions and the solutions seem to range from checking that the bytecode is at the right level (mine is), and that the project language is correct (mine is).

Anyone have any ideas?

Edit:

Error:

Fibrin

can you try from terminal to compile and run? – Gynaeco

You'll need to require its module(s) in your module-info.java – Exploration

I think you need this artifact: mvnrepository.com/artifact/org.openjfx/javafx/11 the base one doesn't contain everything I guess. – Jerrybuilt

@JornVernee when I try that I get an error. I edited the OP with it. – Fibrin

@JacobG. how do I go about this? I have not used the module system before. I was told that you don't require a modulized application to use javaFX11. Is this wrong? – Fibrin

Check the local .m2 whether the jar got downloaded or not in the location – Shortterm

Whoever told you that was likely mistaken. You need to create a module-info.java file in your source folder and explicitly require whichever JavaFX modules that you're using: requires javafx.controls;, requires javafx.graphics;, etc. – Exploration

Hmm still nothing is working. This is a little frustrating. I also tried a gradle build and set the javafx artifact as a dependency and that still wouldn't work. It might be something small I'm missing, does anyone have a simple hello world javafx application that they can host and I can look at? – Fibrin

@Fibrin can you let me know how to get the Project Level Language drop down list (below Project SDK) to show '11-Local Variable Syntax for lambda parameters' in Intellij as per the screenshot you have posted? – Analysand

@Slaw thanks after I upgraded Intellij was able to find it in the drop-down list. – Analysand

We were having this error: java.lang.IllegalAccessError: class com.sun.javafx.fxml.FXMLLoaderHelper (in unnamed module ...) cannot access class com.sun.javafx.util.Utils (in module javafx.graphics) because module javafx.graphics does not export com.sun.javafx.util . The reason was that we were running the Application class directly without Application.launch. Shared here as it is might be useful. – Refluent

I got the same issue when I moved to java11 but when I got back to java 8 everything worked fine – Bimetallism

I managed to make mine worked by unchecked the read only of the windows folder containing javafx. It worked for me, might give it a try – Aruspex

Answer 1

As mentioned in the comments, the Starting Guide is the place to start with Java 11 and JavaFX 11.

The key to work as you did before Java 11 is to understand that:

• JavaFX 11 is not part of the JDK anymore
• You can get it in different flavors, either as an SDK or as regular dependencies (maven/gradle).
• You will need to include it to the module path of your project, even if your project is not modular.

JavaFX project

If you create a regular JavaFX default project in IntelliJ (without Maven or Gradle) I'd suggest you download the SDK from here. Note that there are jmods as well, but for a non modular project the SDK is preferred.

These are the easy steps to run the default project:

1. Create a JavaFX project
2. Set JDK 11 (point to your local Java 11 version)
3. Add the JavaFX 11 SDK as a library. The URL could be something like /Users/<user>/Downloads/javafx-sdk-11/lib/. Once you do this you will notice that the JavaFX classes are now recognized in the editor.

4. Before you run the default project, you just need to add these to the VM options:

   --module-path /Users/<user>/Downloads/javafx-sdk-11/lib --add-modules=javafx.controls,javafx.fxml

5. Run

Maven

If you use Maven to build your project, follow these steps:

1. Create a Maven project with JavaFX archetype
2. Set JDK 11 (point to your local Java 11 version)

3. Add the JavaFX 11 dependencies.

   <dependencies>
       <dependency>
           <groupId>org.openjfx</groupId>
           <artifactId>javafx-controls</artifactId>
           <version>11</version>
       </dependency>
       <dependency>
           <groupId>org.openjfx</groupId>
           <artifactId>javafx-fxml</artifactId>
           <version>11</version>
       </dependency>
   </dependencies>
   

Once you do this you will notice that the JavaFX classes are now recognized in the editor.

You will notice that Maven manages the required dependencies for you: it will add javafx.base and javafx.graphics for javafx.controls, but most important, it will add the required classifier based on your platform. In my case, Mac.

This is why your jars org.openjfx:javafx-controls:11 are empty, because there are three possible classifiers (windows, linux and mac platforms), that contain all the classes and the native implementation.

In case you still want to go to your .m2 repo and take the dependencies from there manually, make sure you pick the right one (for instance .m2/repository/org/openjfx/javafx-controls/11/javafx-controls-11-mac.jar)

4. Replace default maven plugins with those from here.

5. Run mvn compile javafx:run, and it should work.

Similar works as well for Gradle projects, as explained in detail here.

EDIT

The mentioned Getting Started guide contains updated documentation and sample projects for IntelliJ:

• JavaFX 11 without Maven/Gradle, see non-modular sample or modular sample projects.

• JavaFX 11 with Maven, see non-modular sample or modular sample projects.

• JavaFX 11 with Gradle, see non-modular sample or modular sample projects.

Locke

I am having trouble with JavaFX Project Step 3. Project Structure -> Project Settings -> Libraries -> + (New Project Library) -> Java. Then input path to javafx-sdk-11, correct? Then, "IDEA cannot determine what kind of files the chosen items contain. Choose the appropriate categories from the list." – Test

Path is something like /Users/<user>/Downloads/javafx-sdk-11/lib/, notice the lib folder. That should contain all the javafx jars – Infiltrate

If anyone is having issues with the module path it needs to look something like this on windows: --module-path="C:\Path\To\Your\JavaFX\lib" --add-modules=javafx.controls,javafx.fxml,javafx.base,javafx.media,javafx.graphics,javafx.swing,javafx.web Notice the "=" and also the quotes around it. This worked for me while any other approach didn't. Furthermore keep in mind that the -jar YourJar.jar parameter needs to come AFTER the module path and add-modules options. – Homopolar

Very cool. Has anyone managed to get the install artifact working? – Attitude

Hi @JoséPereda. I've been struggling with this guide since a while, but I can't really make IntelliJ run my code, even if I've done exactly what you've written. I'm still getting "Error:java: module not found: javafx.fxml" and so on. Any chance to have a private chat to help me out sort out this issue? Thank you. – Eutrophic

@jalau thank you! the quotes actually did it, you should write this as an answer. – Gratianna

When I create a new JavaFX project it works, but it doesn't for existing projects – Macklin

Last line solved my issue with intellij + javafx 11 + gradle 5 ty <3. – Viscosity

I try the maven way but when I exec:java I get following error: The parameters 'mainClass' for goal org.codehaus.mojo:exec-maven-plugin:1.6.0:java are missing or invalid. I set mainClass to 'package.ClassThatExtendsApplicationIncludingMainMethod' any idea whats missing? – Robrobaina

When I build the distribution for the sample project for Gradle and then run it, I get the error message: "Error: JavaFX runtime components are missing, and are required to run this application" – Biforked

I have applied this and especially the improvement suggested by @Homopolar but I get the following ---> Error occurred during initialization of boot layer java.lang.module.FindException: Module javafx.swing not found. Some help please – Bimetallism

remember about runtime jbrsdk8 and java 8 compatibility for java 11 and jfoenix https://mcmap.net/q/183076/-use-scenebuilder-with-javafx-11-in-idea – Dye

How to do Step 4 (adding VM options) in IntelliJ can be found here: https://mcmap.net/q/183077/-how-to-set-jvm-arguments-in-intellij-idea – Fledgy

I was able to add the VM options on IntelliJ as described above on my Debian Buster system. Debian provides a .deb install for JavaFX. I inserted the path where Synaptic installed the JavaFX on my system, which is /usr/share/openjfx/lib. <thumbs-up> I was able to run the default IntelliJ JavaFX sample program. </thumbs-up> – Provencher

Answer 2

The issue that JavaFX is no longer part of JDK 11. The following solution works using IntelliJ (haven't tried it with NetBeans):

1. Add JavaFX Global Library as a dependency:

   Settings -> Project Structure -> Module. In module go to the Dependencies tab, and click the add "+" sign -> Library -> Java-> choose JavaFX from the list and click Add Selected, then Apply settings.

2. Right click source file (src) in your JavaFX project, and create a new module-info.java file. Inside the file write the following code :

   module YourProjectName { 
       requires javafx.fxml;
       requires javafx.controls;
       requires javafx.graphics;
       opens sample;
   }
   

   These 2 steps will solve all your issues with JavaFX, I assure you.

Reference : There's a You Tube tutorial made by The Learn Programming channel, will explain all the details above in just 5 minutes. I also recommend watching it to solve your problem: https://www.youtube.com/watch?v=WtOgoomDewo

Michaella

Answer 3

Update Dec 14, 2020

Intellij has created a new JavaFX project wizard for Idea.

I highly recommend that, if you have an issue getting a JavaFX project to work, then use the new JavaFX project wizard to:

1. Create a new project using the wizard.
2. Test that the new project works.
3. Copy relevant code from your old project into the new project.

The new project wizard is pretty fool-proof and very easy to use to get a working JavaFX project up and running in less than a minute.

The wizard generated project has the following features:

1. Simple working sample code for a small application.
2. Makes use of JavaFX graphics, controls, fxml.
3. Configures a maven or gradle project to use JavaFX, with appropriate maven artifact dependencies for basic development.
4. Uses recent, reasonably up-to-date JavaFX modules, with consistent versions (which is something many beginners often don't do).
5. Adds a module-info.java file that works for an FXML based JavaFX application (will also work if you don't use FXML).
6. Demonstrates placing an FXML file in a resource directory, and looking it up as a resource at runtime (which is something many, many beginners get wrong).
7. Properly separates a Controller class from the Application class (which is also something many beginners get wrong).
8. Demonstrates the proper use of @FXML injection based on ids in an FXML file (which is also something many beginners get wrong).
9. Does not require the openjfx JavaFX SDK download (because JavaFX module dependencies are sourced through maven).
10. Does not require manually setting VM arguments to run the application (because the appropriate module statements are in the module-info.java file rather than a VM command line).
11. Allows execution and debugging of the JavaFX application directly from the IDE.
12. Includes the openjfx maven plugin.
    • You can probably ignore this or delete it from the generated project file if you want.

---

A couple of thoughts on the openjfx-maven plugin:

• For most development, I don't think you need to use it.
  • If you don't need it you can remove it from your project.
• The openjfx maven plugin is not required for the execution of the application
  • Although you could use it for that if you really wanted to, it doesn't provide any advantage over direct execution in the IDE as far as I can tell.
• The openjfx maven plugin can be useful for building jlink based distribution if that is something you wish to do.
• The openjfx maven plugin cannot package your application using jpackage, at least at the moment:
  • if that is something you wish to do, investigate JPackageScriptFX, the ackman maven jpackage plugin or the badass jlink or runtime plugins, or some alternative tool like invoking jpackage directly.

Prior Answer

Some of the info in this prior answer is still useful for understanding background information on Java platform modularity and JavaFX.

Quick summary, you can do either:

1. Include the JavaFX modules via --module-path and --add-modules like in José's answer.

OR

2. Once you have JavaFX libraries added to your project (either manually or via maven/gradle import), add the module-info.java file similar to the one specified in this answer. (Note that this solution makes your app modular, so if you use other libraries, you will also need to add statements to require their modules inside the module-info.java file).

---

This answer is a supplement to Jose's answer.

The situation is this:

1. You are using a recent Java version, e.g. 13.
2. You have a JavaFX application as a Maven project.
3. In your Maven project you have the JavaFX plugin configured and JavaFX dependencies setup as per Jose's answer.
4. You go to the source code of your main class which extends Application, you right-click on it and try to run it.
5. You get an IllegalAccessError involving an "unnamed module" when trying to launch the app.

Excerpt for a stack trace generating an IllegalAccessError when trying to run a JavaFX app from Intellij Idea:

Exception in Application start method
java.lang.reflect.InvocationTargetException
    at java.base/jdk.internal.reflect.NativeMethodAccessorImpl.invoke0(Native Method)
    at java.base/jdk.internal.reflect.NativeMethodAccessorImpl.invoke(NativeMethodAccessorImpl.java:62)
    at java.base/jdk.internal.reflect.DelegatingMethodAccessorImpl.invoke(DelegatingMethodAccessorImpl.java:43)
    at java.base/java.lang.reflect.Method.invoke(Method.java:567)
    at javafx.graphics/com.sun.javafx.application.LauncherImpl.launchApplicationWithArgs(LauncherImpl.java:464)
    at javafx.graphics/com.sun.javafx.application.LauncherImpl.launchApplication(LauncherImpl.java:363)
    at java.base/jdk.internal.reflect.NativeMethodAccessorImpl.invoke0(Native Method)
    at java.base/jdk.internal.reflect.NativeMethodAccessorImpl.invoke(NativeMethodAccessorImpl.java:62)
    at java.base/jdk.internal.reflect.DelegatingMethodAccessorImpl.invoke(DelegatingMethodAccessorImpl.java:43)
    at java.base/java.lang.reflect.Method.invoke(Method.java:567)
    at java.base/sun.launcher.LauncherHelper$FXHelper.main(LauncherHelper.java:1051)
Caused by: java.lang.RuntimeException: Exception in Application start method
    at javafx.graphics/com.sun.javafx.application.LauncherImpl.launchApplication1(LauncherImpl.java:900)
    at javafx.graphics/com.sun.javafx.application.LauncherImpl.lambda$launchApplication$2(LauncherImpl.java:195)
    at java.base/java.lang.Thread.run(Thread.java:830)
Caused by: java.lang.IllegalAccessError: class com.sun.javafx.fxml.FXMLLoaderHelper (in unnamed module @0x45069d0e) cannot access class com.sun.javafx.util.Utils (in module javafx.graphics) because module javafx.graphics does not export com.sun.javafx.util to unnamed module @0x45069d0e
    at com.sun.javafx.fxml.FXMLLoaderHelper.<clinit>(FXMLLoaderHelper.java:38)
    at javafx.fxml.FXMLLoader.<clinit>(FXMLLoader.java:2056)
    at org.jewelsea.demo.javafx.springboot.Main.start(Main.java:13)
    at javafx.graphics/com.sun.javafx.application.LauncherImpl.lambda$launchApplication1$9(LauncherImpl.java:846)
    at javafx.graphics/com.sun.javafx.application.PlatformImpl.lambda$runAndWait$12(PlatformImpl.java:455)
    at javafx.graphics/com.sun.javafx.application.PlatformImpl.lambda$runLater$10(PlatformImpl.java:428)
    at java.base/java.security.AccessController.doPrivileged(AccessController.java:391)
    at javafx.graphics/com.sun.javafx.application.PlatformImpl.lambda$runLater$11(PlatformImpl.java:427)
    at javafx.graphics/com.sun.glass.ui.InvokeLaterDispatcher$Future.run(InvokeLaterDispatcher.java:96)
Exception running application org.jewelsea.demo.javafx.springboot.Main

OK, now you are kind of stuck and have no clue what is going on.

What has actually happened is this:

1. Maven has successfully downloaded the JavaFX dependencies for your application, so you don't need to separately download the dependencies or install a JavaFX SDK or module distribution or anything like that.
2. Idea has successfully imported the modules as dependencies to your project, so everything compiles OK and all of the code completion and everything works fine.

So it seems everything should be OK. BUT, when you run your application, the code in the JavaFX modules is failing when trying to use reflection to instantiate instances of your application class (when you invoke launch) and your FXML controller classes (when you load FXML). Without some help, this use of reflection can fail in some cases, generating the obscure IllegalAccessError. This is due to a Java module system security feature that does not allow code from other modules to use reflection on your classes unless you explicitly allow it (and the JavaFX application launcher and FXMLLoader both require reflection in their current implementation in order for them to function correctly).

This is where some of the other answers to this question, which reference module-info.java, come into the picture.

So let's take a crash course in Java modules:

• https://www.baeldung.com/java-9-modularity

The key part is this:

4.9. Opens

If we need to allow reflection of private types, but we don't want all of our code exposed, we can use the opens directive to expose specific packages.

But remember, this will open the package up to the entire world, so make sure that is what you want:

module my.module { opens com.my.package; }

So, perhaps you don't want to open your package to the entire world, then you can do:

4.10. Opens … To

Okay, so reflection is great sometimes, but we still want as much security as we can get from encapsulation. We can selectively open our packages to a pre-approved list of modules, in this case, using the opens…to the directive:

module my.module { opens com.my.package to moduleOne, moduleTwo, etc.; }

So, you end up creating a src/main/java/module-info.java class which looks like this:

module org.jewelsea.demo.javafx.springboot {
    requires javafx.fxml;
    requires javafx.controls;
    requires javafx.graphics;
    opens org.jewelsea.demo.javafx.springboot to javafx.graphics,javafx.fxml;
}

Where org.jewelsea.demo.javafx.springboot is the name of the package which contains the JavaFX Application class and JavaFX Controller classes (replace this with the appropriate package name for your application). This tells the Java runtime that it is OK for classes in the javafx.graphics and javafx.fxml to invoke reflection on the classes in your org.jewelsea.demo.javafx.springboot package. Once this is done, and the application is compiled and re-run things will work fine and the IllegalAccessError generated by JavaFX's use of reflection will no longer occur.

But what if you don't want to create a module-info.java file

If instead of using the Run button in the top toolbar of IDE to run your application class directly, you instead:

1. Went to the Maven window on the side of the IDE.
2. Chose the JavaFX maven plugin target javafx.run.
3. Right-clicked on that and chose either Run Maven Build or Debug....

Then the app will run without the module-info.java file. I guess this is because the maven plugin is smart enough to dynamically include some kind of settings that allows the app to be reflected on by the JavaFX classes even without a module-info.java file, though I don't know how this is accomplished.

To get that setting transferred to the Run button in the top toolbar, right-click on the javafx.run Maven target and choose the option to Create Run/Debug Configuration for the target. Then you can just choose Run from the top toolbar to execute the Maven target.

Fabianfabianism

I don't see any maven plugin when doing this (replaced by org.beryx.jlink?), so this answer might need another update, but you're right that this is a GREAT feature IntelliJ must have just added in recently. I'll probably be transitioning all my projects to look like this now. – Cylindrical

org.beryx.jlink is a Gradle plugin and is included in the gradle.build file when you use the Idea New JavaFX Project Wizard and select Gradle as the build system. The javafx-maven-plugin is included in the Maven pom.xml file only when you select Maven as the build system, not Gradle. I recommend selecting Maven unless you know and like Gradle. – Fabianfabianism

Oh of course, sorry I was being a little Gradle-centric thinking the world revolves around Gradle and it hadn't even occurred to me that this was using Maven as an example. :) (Gradle projects use Maven repos, to confuse matters more.) – Cylindrical

Answer 4

None of the above worked for me. I spent too much time clearing other errors that came up. I found this to be the easiest and the best way.

This works for getting JavaFx on Jdk 11, 12 & on OpenJdk12 too!

• The Video shows you the JavaFx Sdk download
• How to set it as a Global Library
• Set the module-info.java (i prefer the bottom one)

---

module thisIsTheNameOfYourProject {
    requires javafx.fxml;
    requires javafx.controls;
    requires javafx.graphics;
    opens sample;
}

---

The entire thing took me only 5mins !!!

Mountain

Set it as a global library has moved in 2019.3. Can you point out where this is located now? – Bloemfontein

just add it by yourself, \lib folder of fx distribution – Fungi

Answer 5

It is 2021 and JetBrains updated their IDE. The other questions about this error message are closed and point here.

Error: JavaFX runtime components are missing, and are required to run this application

If you have followed all of the other steps in these answers (eg. Libraries, --module-path, --add-modules, version matching JDK and JavaFX), and you still see this compile error, make sure your run/compile configuration has --module-path and --add-modules as VM Options and not Program Arguments in IntelliJ.

1. Open Run/Debug Configurations
2. Open Modify Options dropdown
3. Click Add VM Options

Krystin

Answer 6

add in VM options, (In run configuration), this line:

--module-path yourpathwheresdkislocated/lib --add-modules=javafx.controls,javafx.fxml 

and if you want to run your jar application from terminal, put this

java --module-path yourpathwheresdkislocated/lib --add-modules=javafx.controls,javafx.fxml -jar YourJar.jar 

Sabellian

Answer 7

A very good explanation can be found at

https://edencoding.com/runtime-components-error/

including

1. Giving reflective access to your module

2. Giving other access to your module

and total, we need, adding to the above answers, add exports to your module definition

module my.project {
    requires javafx.fxml;
    requires javafx.controls;
    opens my.project to javafx.graphics;
    exports my.project;
}

Fungi