Netbeans ANT构建JavaFX jar报无主清单属性问题咨询

关于必须使用JavaFX打包工具的说法仅部分成立，出现的各类启动报错核心源于两点：一是打包逻辑未处理依赖引入，二是运行环境版本不兼容，不需要强制依赖老旧的javafxpackager即可解决。 #

当前配置存在明确的版本不兼容问题：使用JDK 17.0.2 + JavaFX 18.0.1开发，但运行环境为JRE 1.8.0_333。JavaFX 18最低要求JDK 11及以上版本，JRE 8无法加载高版本JavaFX类，这也是jar双击无响应的核心原因——系统默认调用低版本JRE启动时会直接静默失败，无任何错误弹窗。需要先将系统默认java命令指向JDK 17的bin目录，所有运行、打包操作统一使用JDK 17完成。 #

覆写-make-single-jar任务的配置仅打包了项目自身编译生成的class文件，未包含任何JavaFX依赖类，JVM启动时找不到javafx.application.Application类自然会抛出NoClassDefFoundError；此外直接将继承Application的主类配置为Manifest的Main-Class，在classpath模式下启动部分版本JavaFX时会触发类加载异常。 #

可根据使用场景选择以下任意一种方案，无需依赖JavaFX专属打包工具：

方案1：轻量依赖jar（开发阶段适用） #

适合本地调试，无需将依赖打入jar包：

1. 在mainpackage包下新建不继承Application的启动类Launcher，代码如下：

package mainpackage;
public class Launcher {
    public static void main(String[] args) {
        Main.main(args);
    }
}

2. 修改build.xml中的jar任务配置，将Main-Class改为mainpackage.Launcher，同时在Manifest中添加Class-Path属性，列全项目引入的所有JavaFX jar包文件名（如javafx-base-18.jar、javafx-controls-18.jar、javafx-graphics-18.jar等实际依赖包）。
3. 打包时将所有JavaFX依赖jar复制到dist目录，与FantasyFX.jar置于同一层级，使用JDK17执行java -jar FantasyFX.jar即可正常启动。

方案2：全依赖胖jar（单文件分发适用） #

适合单文件传输，无需接收方额外准备JavaFX依赖：
不要仅用原生Ant的<jar>任务打包自身代码，通过<zipgroupfileset>将所有JavaFX依赖类打入jar包，同时排除依赖jar中的签名文件避免启动安全报错，参考配置如下：

<target depends="-pre-single-jar" if="module.jar.filename" name="-make-single-jar">
    <jar destfile="${dist.dir}/${module.jar.filename}" compress="${jar.compress}" manifestencoding="UTF-8">
        <fileset dir="${module.dir}"/>
        <!-- 引入所有JavaFX依赖类 -->
        <zipgroupfileset dir="${lib.dir}" includes="javafx-*.jar"/>
        <!-- 排除签名文件避免安全校验报错 -->
        <zipgroupfileset dir="${lib.dir}" includes="javafx-*.jar">
            <exclude name="META-INF/*.SF"/>
            <exclude name="META-INF/*.DSA"/>
            <exclude name="META-INF/*.RSA"/>
        </zipgroupfileset>
        <manifest>
            <attribute name="Main-Class" value="mainpackage.Launcher"/>
        </manifest>
    </jar>
</target>

打包完成后直接使用JDK17运行单jar文件即可，无需额外依赖。

方案3：原生分发包（生产环境推荐） #

JDK14及之后版本自带的jpackage工具已替代老旧的javafxpackager，可自动处理依赖、模块配置，还能将精简版JRE打入安装包，用户无需预装JDK即可直接运行，是长期对外分发的最优方案。 #

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