Swing程序使用exe4j生成可执行文件的时,文件大启动也慢,达不到产品级要求。通过GraalVM的native-image工具打包的可执行文件大概在45M上下,启动时间基本控制到毫秒级。
Swing运行时使用了一些JNI和反射类,静态分析器无法预测所有可达代码,需要我们提供一些元数据信息,手工编辑元数据麻烦而且容易出错。GraalVM提供了一个native-image-agent工具来收集这些类信息,并保存到 reflect-config.json、jni-config.json、resource-config.json、proxy-config.json、serialization-config.json 和 predefined-classes-config.json 这 6 个 json 格式的配置文件中。当然,如果你熟悉需要用到的库或类,也可以手动编写这几个文件。
1. 创建Swing项目
通过IDEA直接创建了一个Java项目,为了方便打可执行jar包,添加Maven支持。我们创建一个极简的GUI程序,启动后生成如下界面:
2. 打包可执行JAR
有两种可选方式,通过IDEA直接创建Maven工程;或先创建工程,在工程上点击右键选择"Add Framework Support"选择"Maven",把项目转为Maven项目。
这里我们选择maven-shade-plugin,通过你的Maven配置文件里配置如下内容:
<?xml version="1.0" encoding="UTF-8"?>
<project>
<modelVersion>4.0.0</modelVersion>
<groupId>com.randy.graalvm</groupId>
<artifactId>swing</artifactId>
<version>1.0-SNAPSHOT</version>
<properties>
<maven.compiler.source>17</maven.compiler.source>
<maven.compiler.target>17</maven.compiler.target>
<project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
</properties>
<build>
<plugins>
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-shade-plugin</artifactId>
<version>3.5.1</version>
<configuration></configuration>
<executions>
<execution>
<phase>package</phase>
<goals>
<goal>shade</goal>
</goals>
<configuration>
<transformers>
<transformer implementation="org.apache.maven.plugins.shade.resource.ManifestResourceTransformer">
<mainClass>com.company.SwingDemo</mainClass>
</transformer>
</transformers>
</configuration>
</execution>
</executions>
</plugin>
</plugins>
</build>
</project>
执行mvn package完成打包后会生成如下文件,双击运行,确认已经正确打包。
3. 收集元数据
Swing程序因为使用了一些无法通过静态分析(如JNI)识别到的代码。GraalVM提供的java命令行参数-agentlib帮我们收集元数据。
我们这里用swing-1.0.jar演练一边收集元数据的过程。
3.1 设置环境变量
确保java命令使用的GraalVM里的
set GRAALVM_HOME=D:\Programs\GraalVM
set PATH=D:\Programs\GraalVM\bin
3.2 运行JAR程序
这个jar文件Maven打包出来的可执行性jar。通过下面的命令执行jar文件,点击每一个功能,确保需要的类都被加载。
java -cp swing-1.0.jar -agentlib:native-image-agent=config-output-dir=d:/tempDir com.company.SwingDemo
如命令行所示,收集的元数据都会保存在d:/tempDir下。
4. 复制元数据到jar中
将配置文件考到META-INF/native-image/${groupId}/${artificatId}下,如下图所示:
拷贝完成后,使用mvn package命令,重新生成可执行jar。
5. 生成可执行文件
native-image -jar swing-1.0-SNAPSHOT.jar
native-image构建时常用的配置项
配置项 | 描述 |
-H:+ReportExceptionStackTraces | 显示构建期间的异常堆栈跟踪 |
--no-fallback | 构建不依赖JVM的native image或显示构建失败 |
--allow-incomplete-classpath | 允许使用不完整的类路径构建,该参数适用于依赖了弱引用的库 |
-H:ConfigurationFileDirectories=native-image | 配置采集到的meta信息的配置文件目录地址 |
-H:+AddAllCharsets | 支持所有字符集 |
--report-unsupported-elements-at-runtime | 运行native image时才报不受支持的方法和字段,而不在构建期间报错 |
--enable-url-protocols=https,http | 支持的URL协议,不加该参数会导致无法访问web地址 |
执行日志如下,通过日志可以看到构建总共8步,即使我们这个最简单的程序也需要2分钟。
6. 拷贝fontconfig.bfc
构建完成后的目录内容如下图所示,通过swing-1.0-SNAPSHOT.exe可以启动程序。
可惜很遗憾,目前的swing-1.0-SNAPSHOT.exe并不能成功运行,通过cmd命令行运行,我收到了如下的报错:
直到我在程序的main方法第一行,添加了如下代码,设置java.home属性
System.setProperty("java.home", ".");
重新编译后再次执行,依然没有成功,不过换了一个错误,字体错误
我把Java安装目录中lib/fontconfig.bfc拷贝进编译结果,最终的目录是这样的
最终运行结果如下
7. 去掉console
到这里,上面的可执行文件已经能正确的执行了,但是后面多了一个命令行窗口,通过editon工具
editbin /subsystem:windows swing-1.0-SNAPSHOT.exe
窗口输出
到这里,我们拿到了一个能正确执行的exe文件,不会有多余的命令行窗口。