如何创建可双击启动的JavaFX应用JAR包？解决双击无效与终端警告

核心原因分析 #

• 双击JAR时，系统默认的javaw.exe（Windows）或java（其他系统）未加载JavaFX所需的模块参数，导致无法初始化JavaFX环境。
• 警告Unsupported JavaFX configuration: classes were loaded from 'unnamed module'是因为JavaFX类被加载到非模块化环境中，违背了JavaFX的模块化设计规范。

解决方案一：使用jlink生成自定义运行时镜像（推荐） #

这种方式会将OpenJDK、JavaFX依赖和你的游戏打包成一个独立的运行时镜像，双击即可启动，无需依赖系统已安装的Java，且不会出现模块警告。

1. 添加模块描述文件（module-info.java）
   在项目的src/main/java根目录下创建module-info.java，内容示例：

   module com.yourgame {
       // 引入所需的JavaFX模块，根据你的项目需求调整
       requires javafx.controls;
       requires javafx.fxml; // 如果使用FXML则添加
       requires javafx.graphics;
   
       // 导出主类所在包给JavaFX模块，确保能正确启动
       exports com.yourgame.main to javafx.graphics;
   }
   

   替换com.yourgame为你的模块名，com.yourgame.main为主类所在的包。

2. 用Maven/Gradle配置jlink打包
   以Maven为例，在pom.xml中添加javafx-maven-plugin：

   <build>
       <plugins>
           <plugin>
               <groupId>org.openjfx</groupId>
               <artifactId>javafx-maven-plugin</artifactId>
               <version>0.0.11</version>
               <configuration>
                   <!-- 指定你的主类全路径 -->
                   <mainClass>com.yourgame.main.Main</mainClass>
                   <!-- 指定模块名 -->
                   <module>com.yourgame</module>
               </configuration>
           </plugin>
       </plugins>
   </build>
   

   执行命令mvn clean javafx:jlink，生成的target/image目录中会包含对应系统的可执行文件（Windows为.exe，Mac为.app，Linux为.sh），双击即可启动游戏。

解决方案二：修改JAR打包配置与启动方式（适合非模块化场景） #

如果不想使用模块化打包，可通过以下步骤解决双击启动问题：

1. 确保主类正确启动JavaFX
   由于你的主类未继承Application，需在main方法中手动启动JavaFX应用类：

   public class Main {
       public static void main(String[] args) {
           // 替换YourGameApp为你继承Application的类
           Application.launch(YourGameApp.class, args);
       }
   }
   

2. 用Shade插件正确打包所有依赖
   在Maven的pom.xml中配置Shade插件，确保将JavaFX依赖合并到最终JAR中：

   <plugin>
       <groupId>org.apache.maven.plugins</groupId>
       <artifactId>maven-shade-plugin</artifactId>
       <version>3.5.1</version>
       <executions>
           <execution>
               <phase>package</phase>
               <goals>
                   <goal>shade</goal>
               </goals>
               <configuration>
                   <transformers>
                       <transformer implementation="org.apache.maven.plugins.shade.resource.ManifestResourceTransformer">
                           <!-- 指定主类全路径 -->
                           <mainClass>com.yourgame.main.Main</mainClass>
                       </transformer>
                   </transformers>
               </configuration>
           </execution>
       </executions>
   </plugin>
   

   执行mvn clean package生成包含所有依赖的JAR。

3. 创建启动脚本解决双击问题
   系统默认的JAR关联程序无法自动添加JavaFX启动参数，因此需要创建启动脚本：

   • Windows：创建start_game.bat

     @echo off
     java -jar your_game.jar
     

   • Mac/Linux：创建start_game.sh

     #!/bin/bash
     java -jar your_game.jar
     

   双击脚本即可启动游戏，此时警告仍会存在，但不影响运行。若要消除警告，建议使用方案一的模块化打包方式。

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