如何在现有NetBeans Swing项目中添加JavaFX 20？

你遇到的问题根源在于JavaFX从JDK11开始是模块化框架，直接将jar包添加到类路径会导致JavaFX类被加载到未命名模块中，违反其模块化设计规范，进而引发图形设备初始化失败。以下是两种可行的解决方法：

方法一：使用Maven管理依赖（推荐） #

NetBeans对Maven支持完善，能自动处理模块依赖和原生库：

1. 打开项目的pom.xml，添加JavaFX依赖：

<dependencies>
    <dependency>
        <groupId>org.openjfx</groupId>
        <artifactId>javafx-controls</artifactId>
        <version>20</version>
    </dependency>
    <dependency>
        <groupId>org.openjfx</groupId>
        <artifactId>javafx-swing</artifactId>
        <version>20</version>
    </dependency>
</dependencies>

2. 添加Maven插件配置，处理模块和运行参数：

<build>
    <plugins>
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-compiler-plugin</artifactId>
            <version>3.11.0</version>
            <configuration>
                <source>20</source>
                <target>20</target>
            </configuration>
        </plugin>
        <plugin>
            <groupId>org.openjfx</groupId>
            <artifactId>javafx-maven-plugin</artifactId>
            <version>0.0.8</version>
            <configuration>
                <mainClass>你的主类全路径</mainClass>
                <modules>
                    <module>javafx.controls</module>
                    <module>javafx.swing</module>
                </modules>
            </configuration>
        </plugin>
    </plugins>
</build>

3. 右键项目选择Clean and Build，之后运行即可自动加载正确的模块和原生库。

方法二：手动配置JavaFX SDK #

如果不想用构建工具，需手动配置模块路径和运行参数：

1. 下载JavaFX20 SDK并解压到本地目录。
2. 打开NetBeans项目属性：
   • 进入Libraries -> Compile，点击Add JAR/Folder，选择JavaFX SDK解压目录下lib文件夹中的所有jar包。
   • 进入Run -> VM Options，添加以下参数：

     --module-path "你的JavaFX SDK路径/lib" --add-modules javafx.controls,javafx.swing
     

     注意替换引号内的路径为你实际的SDK解压路径。

正确使用JFXPanel的代码示例 #

确保在Swing的事件调度线程（EDT）中初始化JavaFX组件，示例代码：

import javax.swing.JDialog;
import javax.swing.SwingUtilities;
import javafx.embed.swing.JFXPanel;
import javafx.scene.Scene;
import javafx.scene.control.Label;
import javafx.scene.layout.StackPane;

public class FXInSwingDialog {
    public static void showFXDialog() {
        SwingUtilities.invokeLater(() -> {
            JDialog dialog = new JDialog();
            dialog.setTitle("Swing中的JavaFX");
            dialog.setSize(400, 300);
            
            // 初始化JavaFX运行时
            JFXPanel fxPanel = new JFXPanel();
            dialog.add(fxPanel);
            
            // 创建JavaFX内容
            StackPane root = new StackPane();
            root.getChildren().add(new Label("这是JavaFX标签"));
            Scene scene = new Scene(root);
            fxPanel.setScene(scene);
            
            dialog.setDefaultCloseOperation(JDialog.DISPOSE_ON_CLOSE);
            dialog.setVisible(true);
        });
    }
}

关键注意事项 #

• 必须通过--module-path指定JavaFX SDK的lib目录，而不是只添加jar包，这样才能加载JavaFX的原生图形库，解决Graphics Device initialization failed错误。
• 必须添加javafx.swing模块，因为JFXPanel属于这个模块的类。

内容的提问来源于stack exchange，提问作者mstoreysmith