JavaFX 打包示例（完结篇）

几乎不会再更新了

本项目所展示的打包方式从jdk15到现在的jdk21一直都没有特别大的变化，到现在为止，一些jdk本身的小bug带来的小问题也都不再有了或者是已经有解决方法了，没有涉及到的参数就需要你们自己根据需求慢慢尝试了。

!!! Maven 非模块化

非模块化的项目（即不存在文件module-info.java），请直接切换到java21-non-modular，jpackage支持以一个可执行jar包作为输入通过非模块化构建，可以在jpackage.exe --help中看到

对于非模块化应用程序：
            jpackage --type app-image -i inputDir -n name \
                --main-class className --main-jar myJar.jar

因此，通过maven-shade-plugin,maven-assembly-plugin构建出的单一可执行jar包（即第三方依赖包也已经通过某种方式集成到了同一个jar包中）也可以利用这种方式，而如果你使用maven-jar-plugin，那么还需要同时告诉jpackage第三方依赖的jar包位置

HelloWorld

这个项目演示了如何完全使用命令行来编译一个Java项目并创建可执行的jar包和可运行exe文件，项目存在包结构并引入第三方依赖，根据不同步骤可以了解maven和gradle构建项目的一些基本底层逻辑

说明

• 当前为Java21版本，其他版本请切换分之查看
• 由于本项目中gradle配置使用的插件功能更完整，所以推荐使用gradle来构建本项目，如果只能选择maven的话，由于Maven plugin for JavaFX已经许久没有更新，JDK21中jlink的参数--compress新的值也不支持，建议去寻找第三方维护的插件来使用，当然你的项目足够简单的话，pom.xml自定义的构建命令也许能够完全支持你的项目
• 若你实在没有办法处理非模块化的第三方依赖及分裂包相关的模块化问题，可以参考使用The Badass Runtime Plugin 插件来对非模块化项目进行构建
  • IMFrameworkFX （Java）
  • KtFX-Lets-Plot 的non-modular分支实现 （Kotlin）
• 刚开始接触的朋友建议跟着Windows下手动构建的演示的步骤亲自在命令行跑一遍，这样再使用不管是maven还是gradle提供的插件都会更加清楚配置
• Windows下遇到编码问题可以看看展示了在PowerShell遇到乱码的形式，IDEA中gradle报错乱码可以尝试在帮助 | 编辑自定义虚拟机选项添加一行-Dfile.encoding=UTF-8

环境设置

jpackage 构建出安装包依赖的程序（如果只需要构建出可执行程序就可以跳过此配置）

• Windows: 需要安装 WIX TOOLSET ，并将其bin目录添加到环境变量中
• macOS/Linux: 缺失的包一般可以根据提示通过包管理器直接安装

在IDEA中构建项目

• 项目结构 SDK 选择 JDK21
• Gradle：Settings -> Build, Execution, Deployment -> Build Tools -> Gradle -> 指定 Gradle JVM 为项目 SDK

使用命令行（此处演示使用Windows的PowerShell，macOS和Linux假设你熟悉在命令行中设置临时环境变量）

$env:xxx = "yyyy"是设置一个临时环境变量，重启终端或者开启一些新的PowerShell标签页会失效

• 设置JAVA_HOME环境变量 $env:JAVA_HOME = "C:\CommandLineTools\Java\jdk-21\"

  • 使用 gradlew或者mvn的时候，只需要存在JAVA_HOME这个环境变量就可以，不需要java等命令配置在环境变量PATH中

• 设置GRAALVM_HOME环境变量 $env:GRAALVM_HOME = "C:\CommandLineTools\Java\graalvm-jdk-21+35.1"
• 设置JAVA_TOOL_OPTIONS环境变量可以为gradle设置代理$env:JAVA_TOOL_OPTIONS = "-DsocksProxyHost=localhost -DsocksProxyPort=7890"
• 若要进行GraalVM构建，需要使用Maven 3.8.8

对cmd的补充

使用set JAVA_HOME=C:\CommandLineTools\Java\jdk-21方式来设定临时环境变量

项目构建

jpackage

gradle

构建可执行程序

.\gradlew.bat jpackageImage

构建安装包

.\gradlew.bat jpackage

maven

请根据不同操作系统修改exec-maven-plugin插件中有关下方两个命令的--icon的参数值，Windows为${project.basedir}/src/main/resources/application.ico，macOS为${project.basedir}/src/main/resources/application.icns，Linux为${project.basedir}/src/main/resources/application.png

运行（Maven plugin for JavaFX）

mvn javafx:run

构建出.bat形式的可执行程序（Maven plugin for JavaFX）

mvn javafx:jlink

构建可执行程序（手动拼接jpackage命令），此命令构建出的结果其实与上面差别不大，但是是.exe的形式，并且图标已经设置好了

mvn clean
mvn package
mvn exec:exec@image

构建安装包（手动拼接jpackage命令）

mvn clean
mvn package
mvn exec:exec@installer

Oracle GraalVM

• 下载Oracle GraalVM
• 请运行在由Visual Studio提供的命令行环境中，Windows 终端可以直接在标签页中打开Developer PowerShell for VS 2022，其他用户可以在开始菜单的Visual Studio 2022文件夹中找到
• 不关注 module-info.java 文件的存在与否

JAVA_HOME和GRAALVM_HOME可以设置为相同值

> $env:JAVA_HOME
C:\CommandLineTools\Java\graalvm-jdk-21.0.2+13.1\
> $env:GRAALVM_HOME
C:\CommandLineTools\Java\graalvm-jdk-21.0.2+13.1\

此项目使用的 Oracle GraalVM 版本

java 21.0.2 2024-01-16 LTS
Java(TM) SE Runtime Environment Oracle GraalVM 21.0.2+13.1 (build 21.0.2+13-LTS-jvmci-23.1-b30)
Java HotSpot(TM) 64-Bit Server VM Oracle GraalVM 21.0.2+13.1 (build 21.0.2+13-LTS-jvmci-23.1-b30, mixed mode, sharing)

gradle

构建与运行

.\gradlew.bat nativeBuild
.\gradlew.bat nativeRun

Downloading JavaFX static libs...网络问题

Gluon下载JavaFX static libs涉及到的相关源码FileOps.java，因此可以通过配置java的一些系统属性（需要梯子）来加速，在项目根目录下新建文件gradle.properties内容如下，配置项的有关文档Java Networking and Proxies，gradle相关文档Accessing the web through a proxy

org.gradle.jvmargs=-Dfile.encoding=UTF-8
systemProp.http.proxyHost=127.0.0.1
systemProp.http.proxyPort=7890
systemProp.https.proxyHost=127.0.0.1
systemProp.https.proxyPort=7890

重新执行相关命令，可能会因为之前的下载缓存导致重新执行命令失败，这时可以去删除此文件夹C:\Users\你的用户名\.gluon\substrate再重新运行，JavaFX static libs下载成功后可以注释掉相关代理配置以防其他平台梯子配置不同，如果不想改配置文件，也可以通过下述命令的方式来使用代理

gradlew.bat nativeBuild -D"https.proxyHost"=127.0.0.1 -D"https.proxyPort"=7890

maven

构建与运行

mvn -Pwin gluonfx:build
mvn -Pwin gluonfx:run

mvn -Pmac gluonfx:build
mvn -Pmac gluonfx:run

Downloading JavaFX static libs...网络问题

mvn -Pwin gluonfx:build -D"https.proxyHost"=127.0.0.1 -D"https.proxyPort"=7890
mvn -Pmac gluonfx:build -D"https.proxyHost"=127.0.0.1 -D"https.proxyPort"=7890

日志

添加了支持GraalVM的Logback作为日志框架，在你自己的项目，如果是第一次添加以及后续修改了Logback配置文件的时候，在执行GraalVM构建之前，先用mvn -Pwin gluonfx:runagent或.\gradlew.bat nativeRunAgent来为native-image生成一些必要的文件，它会自动保存到src/main/resources/META-INF/native-image，然后在执行GraalVM构建，否则生成的程序执行时不会生成日志文件，正常情况下，会在程序执行目录创建logs目录及日志文件

补充

有时候mvn gluonfx:build或者.\gradlew.bat jpackageImage发生了错误后，执行.\gradlew.bat clean提示文件被占用，这时候可以打开任务管理器-性能-资源监视器-CPU，在关联的句柄处输入gluon、jpackage等关键词来检索出卡住的相关进程并干掉他