Skip to content

Commit fe5693f

Browse files
icuxikaicuxika
committed
update
1 parent fbc3314 commit fe5693f

File tree

2 files changed

+119
-32
lines changed

2 files changed

+119
-32
lines changed

‎README.en-US.md

Lines changed: 46 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,46 @@
1+
<h1 align="center">JavaFX-Package-Sample</h1>
2+
<p align="center">JavaFX Project Packaging Example</p>
3+
<p align="center">English | <a href="README.md">中文</a></p>
4+
5+
## Branches
6+
- `java21` Package a `modular` JavaFX project using `Maven`, `Gradle`, and `GraalVM`.
7+
- `java21-non-modular` [Link](https://github.com/JavaFX-Starter/JavaFX-Package-Sample/tree/java21-non-modular) Package a `non-modular` JavaFX project using `Maven`.
8+
- `java22-win32` [Link](https://github.com/JavaFX-Starter/JavaFX-Package-Sample/tree/java22-win32) A JavaFX project that implements Windows global keyboard event listening by utilizing the `Foreign Function and Memory (FFM) API`.
9+
10+
## Requirements
11+
PowerShell:
12+
```
13+
$env:JAVA_HOME = "C:\CommandLineTools\Java\jdk-21\"
14+
```
15+
```
16+
$env:GRAALVM_HOME = "C:\CommandLineTools\Java\graalvm-jdk-21.0.2+13.1\"
17+
```
18+
19+
## Getting Started
20+
Gradle:
21+
```
22+
.\gradlew.bat jpackageImage
23+
.\gradlew.bat jpackage
24+
```
25+
26+
Maven:
27+
```
28+
mvn clean
29+
mvn package
30+
mvn exec:exec@image
31+
mvn exec:exec@installer
32+
```
33+
34+
GraalVM:
35+
```
36+
.\gradlew.bat nativeRunAgent
37+
.\gradlew.bat nativeBuild
38+
.\gradlew.bat nativeRun
39+
```
40+
```
41+
mvn -Pwin gluonfx:build
42+
mvn -Pwin gluonfx:run
43+
44+
mvn -Pmac gluonfx:build
45+
mvn -Pmac gluonfx:run
46+
```

‎README.md

Lines changed: 73 additions & 32 deletions
Original file line numberDiff line numberDiff line change
@@ -1,120 +1,149 @@
1-
JavaFX 打包示例（完结篇）
2-
------------------------------------------------------------
1+
<h1 align="center">JavaFX-Package-Sample</h1>
2+
<p align="center">JavaFX 打包示例（完结篇）</p>
3+
<p align="center"><a href="README.en-US.md">English</a> | 中文</p>
34

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

7-
## !!! Maven 非模块化
8-
非模块化的项目（即不存在文件`module-info.java`），请直接切换到[java21-non-modular](https://github.com/JavaFX-Starter/JavaFX-Package-Sample/tree/java21-non-modular)，`jpackage`支持以一个可执行jar包作为输入通过非模块化构建，可以在`jpackage.exe --help`中看到
9-
```shell
10-
对于非模块化应用程序：
11-
jpackage --type app-image -i inputDir -n name \
12-
--main-class className --main-jar myJar.jar
13-
```
14-
因此，通过`maven-shade-plugin`,`maven-assembly-plugin`构建出的单一可执行jar包（即第三方依赖包也已经通过某种方式集成到了同一个jar包中）也可以利用这种方式，而如果你使用`maven-jar-plugin`，那么还需要同时告诉`jpackage`第三方依赖的`jar`包位置
7+
- `java21` 使用`Maven`，`Gradle`和`GraalVM`打包一个模块化的JavaFX项目。
8+
- `java21-non-modular` [链接](https://github.com/JavaFX-Starter/JavaFX-Package-Sample/tree/java21-non-modular) 使用
9+
`Maven`打包一个非模块化的JavaFX项目。
10+
- `java22-win32` [链接](https://github.com/JavaFX-Starter/JavaFX-Package-Sample/tree/java22-win32) 一个利用
11+
`Foreign Function and Memory (FFM) API`实现Windows全局键盘事件监听的JavaFX项目。
1512

16-
## [HelloWorld](https://github.com/icuxika/HelloWorld)
17-
这个项目演示了如何完全使用命令行来编译一个Java项目并创建可执行的jar包和可运行exe文件，项目存在包结构并引入第三方依赖，根据不同步骤可以了解`maven`和`gradle`构建项目的一些基本底层逻辑
13+
## HelloWorld [链接](https://github.com/icuxika/HelloWorld)
1814

19-
## 说明
20-
- 当前为Java21版本，其他版本请切换分之查看
21-
- 由于本项目中gradle配置使用的插件功能更完整，所以推荐使用gradle来构建本项目，如果只能选择maven的话，由于`Maven plugin for JavaFX`已经许久没有更新，`JDK21`中`jlink`的参数`--compress`新的值也不支持，建议去寻找第三方维护的插件来使用，当然你的项目足够简单的话，`pom.xml`自定义的构建命令也许能够完全支持你的项目
22-
- 若你实在没有办法处理非模块化的第三方依赖及分裂包相关的模块化问题，可以参考使用[The Badass Runtime Plugin](https://badass-runtime-plugin.beryx.org/releases/latest/) 插件来对非模块化项目进行构建
23-
- [IMFrameworkFX](https://github.com/icuxika/IMFrameworkFX) （Java）
24-
- [KtFX-Lets-Plot](https://github.com/icuxika/KtFX-Lets-Plot/tree/non-modular) 的`non-modular`分支实现 （Kotlin）
25-
- 刚开始接触的朋友建议跟着`Windows下手动构建的演示`的步骤亲自在命令行跑一遍，这样再使用不管是maven还是gradle提供的插件都会更加清楚配置
26-
- `Windows下遇到编码问题可以看看`展示了在`PowerShell`遇到乱码的形式，`IDEA`中gradle报错乱码可以尝试在`帮助 | 编辑自定义虚拟机选项`添加一行`-Dfile.encoding=UTF-8`
15+
这个项目演示了如何完全使用`PowerShell7`来编译一个Java项目并创建可执行的jar包和可运行exe文件，项目存在包结构并引入第三方依赖。
2716

2817
## 环境设置
2918
#### `jpackage` 构建出安装包依赖的程序（如果只需要构建出可执行程序就可以跳过此配置）
3019
- Windows: 需要安装 [WIX TOOLSET](https://wixtoolset.org/) ，并将其bin目录添加到环境变量中
3120
- macOS/Linux: 缺失的包一般可以根据提示通过包管理器直接安装
21+
3222
#### 在IDEA中构建项目
3323
- 项目结构 SDK 选择 JDK21
3424
- Gradle：Settings -> Build, Execution, Deployment -> Build Tools -> Gradle -> 指定 Gradle JVM 为项目 SDK
25+
3526
#### 使用命令行（此处演示使用Windows的PowerShell，macOS和Linux假设你熟悉在命令行中设置临时环境变量）
3627
> `$env:xxx = "yyyy"`是设置一个临时环境变量，重启终端或者开启一些新的PowerShell标签页会失效
28+
3729
- 设置`JAVA_HOME`环境变量 `$env:JAVA_HOME = "C:\CommandLineTools\Java\jdk-21\"`
38-
- > 使用 `gradlew`或者`mvn`的时候，只需要存在`JAVA_HOME`这个环境变量就可以，不需要`java`等命令配置在环境变量PATH中
30+
- > 使用 `gradlew`或者`mvn`的时候，只需要存在`JAVA_HOME`这个环境变量就可以，不需要`java`等命令配置在环境变量PATH中
3931
- 设置`GRAALVM_HOME`环境变量 `$env:GRAALVM_HOME = "C:\CommandLineTools\Java\graalvm-jdk-21+35.1"`
40-
- 设置`JAVA_TOOL_OPTIONS`环境变量可以为`gradle`设置代理`$env:JAVA_TOOL_OPTIONS = "-DsocksProxyHost=localhost -DsocksProxyPort=7890"`
32+
- 设置`JAVA_TOOL_OPTIONS`环境变量可以为`gradle`设置代理
33+
`$env:JAVA_TOOL_OPTIONS = "-DsocksProxyHost=localhost -DsocksProxyPort=7890"`
4134
- 若要进行`GraalVM`构建，需要使用`Maven 3.8.8`
42-
#### 对cmd的补充
43-
使用`set JAVA_HOME=C:\CommandLineTools\Java\jdk-21`方式来设定临时环境变量
4435

4536
## 项目构建
37+
4638
### `jpackage`
39+
4740
##### gradle
41+
4842
> 构建可执行程序
43+
4944
```shell
5045
.\gradlew.bat jpackageImage
5146
```
47+
5248
> 构建安装包
49+
5350
```shell
5451
.\gradlew.bat jpackage
5552
```
53+
5654
##### maven
57-
请根据不同操作系统修改`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`
55+
56+
请根据不同操作系统修改`exec-maven-plugin`插件中有关下方两个命令的`--icon`的参数值，Windows为
57+
`${project.basedir}/src/main/resources/application.ico`，macOS为`${project.basedir}/src/main/resources/application.icns`
58+
，Linux为`${project.basedir}/src/main/resources/application.png`
5859
> 运行（Maven plugin for JavaFX）
60+
5961
```shell
6062
mvn javafx:run
6163
```
64+
6265
> 构建出`.bat`形式的可执行程序（Maven plugin for JavaFX）
66+
6367
```shell
6468
mvn javafx:jlink
6569
```
70+
6671
> 构建可执行程序（手动拼接jpackage命令），`此命令构建出的结果其实与上面差别不大，但是是.exe的形式，并且图标已经设置好了`
72+
6773
```shell
6874
mvn clean
6975
mvn package
7076
mvn exec:exec@image
7177
```
78+
7279
> 构建安装包（手动拼接jpackage命令）
80+
7381
```shell
7482
mvn clean
7583
mvn package
7684
mvn exec:exec@installer
7785
```
7886

7987
### `Oracle GraalVM`
88+
8089
- 下载[Oracle GraalVM](https://www.graalvm.org/downloads/)
81-
- 请运行在由`Visual Studio`提供的命令行环境中，`Windows 终端`可以直接在标签页中打开`Developer PowerShell for VS 2022`，其他用户可以在开始菜单的`Visual Studio 2022`文件夹中找到
90+
- 请运行在由`Visual Studio`提供的命令行环境中，`Windows 终端`可以直接在标签页中打开`Developer PowerShell for VS 2022`
91+
，其他用户可以在开始菜单的`Visual Studio 2022`文件夹中找到
8292
- 不关注 `module-info.java` 文件的存在与否
8393

8494
#### JAVA_HOME和GRAALVM_HOME可以设置为相同值
95+
8596
```shell
8697
> $env:JAVA_HOME
8798
C:\CommandLineTools\Java\graalvm-jdk-21.0.2+13.1\
8899
> $env:GRAALVM_HOME
89100
C:\CommandLineTools\Java\graalvm-jdk-21.0.2+13.1\
90101
```
102+
91103
#### 此项目使用的 Oracle GraalVM 版本
104+
92105
```shell
93106
java 21.0.2 2024-01-16 LTS
94107
Java(TM) SE Runtime Environment Oracle GraalVM 21.0.2+13.1 (build 21.0.2+13-LTS-jvmci-23.1-b30)
95108
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)
96109
```
110+
97111
##### gradle
112+
98113
###### 构建与运行
114+
99115
```shell
100116
.\gradlew.bat nativeBuild
101117
.\gradlew.bat nativeRun
102118
```
119+
103120
###### `Downloading JavaFX static libs...`网络问题
104-
Gluon下载`JavaFX static libs`涉及到的相关源码[FileOps.java](https://github.com/gluonhq/substrate/blob/master/src/main/java/com/gluonhq/substrate/util/FileOps.java)，因此可以通过配置`java`的一些系统属性（需要梯子）来加速，在项目根目录下新建文件`gradle.properties`内容如下，配置项的有关文档[Java Networking and Proxies](https://docs.oracle.com/javase/8/docs/technotes/guides/net/proxies.html)，gradle相关文档[Accessing the web through a proxy](https://docs.gradle.org/current/userguide/build_environment.html#ex-configuring-an-http-proxy-using-gradle-properties)
121+
122+
Gluon下载`JavaFX static libs`
123+
涉及到的相关源码[FileOps.java](https://github.com/gluonhq/substrate/blob/master/src/main/java/com/gluonhq/substrate/util/FileOps.java)
124+
，因此可以通过配置`java`的一些系统属性（需要梯子）来加速，在项目根目录下新建文件`gradle.properties`
125+
内容如下，配置项的有关文档[Java Networking and Proxies](https://docs.oracle.com/javase/8/docs/technotes/guides/net/proxies.html)
126+
，gradle相关文档[Accessing the web through a proxy](https://docs.gradle.org/current/userguide/build_environment.html#ex-configuring-an-http-proxy-using-gradle-properties)
127+
105128
```properties
106129
org.gradle.jvmargs=-Dfile.encoding=UTF-8
107130
systemProp.http.proxyHost=127.0.0.1
108131
systemProp.http.proxyPort=7890
109132
systemProp.https.proxyHost=127.0.0.1
110133
systemProp.https.proxyPort=7890
111134
```
112-
重新执行相关命令，可能会因为之前的下载缓存导致重新执行命令失败，这时可以去删除此文件夹`C:\Users\你的用户名\.gluon\substrate`再重新运行，`JavaFX static libs`下载成功后可以注释掉相关代理配置以防其他平台梯子配置不同，如果不想改配置文件，也可以通过下述命令的方式来使用代理
135+
136+
重新执行相关命令，可能会因为之前的下载缓存导致重新执行命令失败，这时可以去删除此文件夹`C:\Users\你的用户名\.gluon\substrate`
137+
再重新运行，`JavaFX static libs`下载成功后可以注释掉相关代理配置以防其他平台梯子配置不同，如果不想改配置文件，也可以通过下述命令的方式来使用代理
138+
113139
```
114140
gradlew.bat nativeBuild -D"https.proxyHost"=127.0.0.1 -D"https.proxyPort"=7890
115141
```
142+
116143
##### maven
144+
117145
###### 构建与运行
146+
118147
```shell
119148
mvn -Pwin gluonfx:build
120149
mvn -Pwin gluonfx:run
@@ -124,13 +153,25 @@ mvn -Pmac gluonfx:run
124153
```
125154

126155
###### `Downloading JavaFX static libs...`网络问题
156+
127157
```shell
128158
mvn -Pwin gluonfx:build -D"https.proxyHost"=127.0.0.1 -D"https.proxyPort"=7890
129159
mvn -Pmac gluonfx:build -D"https.proxyHost"=127.0.0.1 -D"https.proxyPort"=7890
130160
```
131161

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

135169
## 补充
136-
有时候`mvn gluonfx:build`或者`.\gradlew.bat jpackageImage`发生了错误后，执行`.\gradlew.bat clean`提示文件被占用，这时候可以打开`任务管理器-性能-资源监视器-CPU`，在`关联的句柄`处输入`gluon`、`jpackage`等关键词来检索出卡住的相关进程并干掉他
170+
171+
有时候`mvn gluonfx:build`或者`.\gradlew.bat jpackageImage`发生了错误后，执行`.\gradlew.bat clean`提示文件被占用，这时候可以打开
172+
`任务管理器-性能-资源监视器-CPU`，在`关联的句柄`处输入`gluon`、`jpackage`等关键词来检索出卡住的相关进程并干掉他
173+
174+
## Windows安装包制作
175+
`jpackage`默认使用`WiX Toolset`来制作安装包文件，可以通过命令行参数修改`WiX Toolset`相关配置文件，若不想使用`jpackage`内置安装包的制作工具，也可以在构建出image后自行制作安装包
176+
- [NSISBuilder](https://github.com/icuxika/NSISBuilder)
177+
- [WiXToolset3Builder](https://github.com/icuxika/WiXToolset3Builder)

0 commit comments

Comments
 (0)