超详细的JavaFX项目的创建、构建、打包教程_javafx教程-CSDN博客

安宇雨 - 随手采集
2024-02-20 10:14:34
随手采集
0000-未整理-等待研究

零、前言

一、创建JavaFX项目

二、构建JavaFX项目为jar

三、打包JavaFX项目为exe

四、总结

零、前言

最近写了一些JavaFX的程序，并将它们打包，过程中看了不少网上的博客与教程。对于开发经验不多的我来说，解决一个个问题无疑是一个很大的挑战，所幸最后在自己的努力和他人的帮助下完成了整个过程。鉴于JavaFX并非十分流行，如今网络上教程时效性也有很大问题，我写了这样一篇博客，来为准备使用JavaFX来开发程序的朋友们提供一些帮助。

注：该篇博客仅讲解创建、构建、打包JavaFX的项目的流程，由于JavaFX语法体系整体随时间变化不大，可以参考网络上的一些博客与视频教程。

一、创建JavaFX项目

Java 8:

因为JDK8中集成了JavaFX，所以在JDK8环境下创建JavaFX程序很简单。只需像创建普通Java项目一样创建项目，在代码中导入JavaFX相关包即可编写并直接运行即可运行JavaFX程序。

Java 8+:

在JDK8后的JDK版本不再集成JavaFX，我们需要自己向项目中引入JavaFX，所以创建JavaFX项目会复杂一些。

我们此处采用创建Maven或Gradle项目并引入依赖的办法来引入JavaFX。如果不使用Maven，也可以在Project Structure中通过给项目添加依赖的方式，来使用和运行JavaFX程序。但是此种方式不利于管理项目，在后续打包过程中也会遇到许多困难与问题，所以不推荐。

此处以Maven为例：

第一步：创建Maven项目

（关于Maven依赖和插件下载慢的问题，可以自行百度，将下载源改为国内镜像，并调整Maven设置。）

第二步：在pom.xml文件中添加如下代码，导入依赖。

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

第三步：在pom.xml文件中添加如下代码，导入插件。

<build>    <plugins>        <plugin>            <groupId>org.apache.maven.plugins</groupId>            <artifactId>maven-compiler-plugin</artifactId>            <version>3.10.1</version>            <configuration>                <source>19</source>                <target>19</target>            </configuration>        </plugin>        <plugin>            <groupId>org.openjfx</groupId>            <artifactId>javafx-maven-plugin</artifactId>            <version>0.0.8</version>            <executions>                <execution>                    <!-- Default configuration for running with: mvn clean javafx:run -->                    <id>default-cli</id>                    <configuration>                        <mainClass>这里填你的主类名称</mainClass>                        <launcher>app</launcher>                        <jlinkZipName>app</jlinkZipName>                        <jlinkImageName>app</jlinkImageName>                        <noManPages>true</noManPages>                        <stripDebug>true</stripDebug>                        <noHeaderFiles>true</noHeaderFiles>                    </configuration>                </execution>            </executions>        </plugin>    </plugins></build>

添加插件之后，可以看到右边的maven侧栏多出了选项。

此时我们创建一个入口类，

并将javafx-maven-plugin中的主类设置成该入口类。

设置完毕后，点击maven侧栏中plugin项下的javafx:run即可运行项目。

另外，高版本的idea支持一键创建maven包裹的JavaFX项目。

此种创建方式与上面的效果相同。

二、构建JavaFX项目为jar

Java 8:

第一步：打开Project Structure设置界面，点击Artifacts，添加JavaFX Application。

第二步：在JavaFX一栏中的Application class中选择入口类，然后Apply设置。

第三步：点击Build，然后选择Build Artifacts，然后选择刚刚创建的Artifact，等待构建成功。

打包完毕后即可在out\artifacts中找到对应的jar文件。

Java 8+：

第一步：在pom.xml文件中添加以下代码，添加maven-shade-plugin。

<plugin>    <groupId>org.apache.maven.plugins</groupId>    <artifactId>maven-shade-plugin</artifactId>    <version>3.2.2</version>    <executions>        <execution>            <phase>package</phase>            <goals>                <goal>shade</goal>            </goals>            <configuration>                <transformers>                    <transformer implementation="org.apache.maven.plugins.shade.resource.ManifestResourceTransformer">                        <mainClass>example</mainClass>                    </transformer>                </transformers>            </configuration>        </execution>    </executions></plugin>

第二步：重新加载maven设置，在mainClass标签中填入你的主类（以src/main/java文件夹为参照目录）

第三步：在maven侧栏中启动package。

此时，在项目文件夹中，会生成target文件夹，里面包含了所产生的jar文件。

当然，在Java 8+的JRE下无法运行该jar，因为Java 8+中已经不再集成JavaFX。若要直接运行，需要添加特定的VM Options，有兴趣的可以百度搜索一下。

三、打包JavaFX项目为exe

第一种方法：使用exe4j将jar文件转成exe（Java 8以及Java 8+都适用）。

首先，准备好之前构建好的jar文件，以及编译所使用的jdk版本对应的jre或jdk本身，并将它们放在同一目录下。

第一步：下载、安装并打开exe4j。（过程就不过多赘述，相信各位利用互联网能轻松解决这个问题）

第二步：正确进行打包设置。

此处的license相信各位有办法解决，当然可以不添加license，不过这样打包出来的exe会有水印。

此处勾选第二个选项，以让没有JRE的使用者能正确运行程序。

此处设置应用名称与输出目录。

此处设置exe文件名。

此处单击加号，在弹出窗口中选择将被打包的jar文件，再在下方选择main class。

此处填入支持的最低与最高JRE版本号，然后点击高级选项中的search sequece。

如图，删除其中的所有内容并添加已准备好的并与jar文件放在同一文件夹下并与输出目录相同的文件夹相同的JDK或者JRE。以保持相对路径，使无Java环境与JavaFX依赖的使用者能正常使用项目。然后一直点击下一步，直至打包完成。

此处点击按钮可以测试打包出的exe是否可用。

测试可用后，即可将exe文件与JRE或JDK一同打包成zip或者exe安装文件。

注：此种方法打包，由于需要包含完整的JDK或JRE，在体积上具有劣势。可以通过定制JRE的方式进行解决，有兴趣的朋友们可以搜索一下方法。对于高版本来说，还有另一种打包方法，也可以避免这一劣势，如下。

第二种方法：使用javafx-maven-plugin中的jlink直接打包项目，再将其中的bat文件转换为exe文件（适用于Java 8+)。

第一步：在源码目录下添加module-info.java文件，内容如下：

module com.example.demo {    requires javafx.controls;    requires javafx.fxml;      opens com.example.demo to javafx.fxml;    exports com.example.demo;}

注意：此处的几个包名为程序入口类所在的包名，请确保入口类由至少一个包进行包裹。

第二步：在maven侧栏中点击javafx:jlink。