启动使用 jpackage 创建的已安装可执行文件时出现 ClassNotFoundException
ClassNotFoundException when launching an installed executable created with jpackage
我生成MSI安装程序的过程如下。
- 运行
mvn install
生成 Example-1.0-SNAPSHOT-jar-with-dependencies.jar
.
- 运行
windows-executable.bat
生成Example-1.0.0.msi
.
- 安装
Example-1.0.0.msi
.
- 转到安装目录,打开终端,然后运行
Example-1.0.0.exe
查看任何阻止应用程序启动的错误。
此 POM 文件(已删除无关部分)在 mvn install
期间用于生成 Example-1.0-SNAPSHOT-jar-with-dependencies.jar
。
<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
<modelVersion>4.0.0</modelVersion>
<groupId>com.github.Valkryst</groupId>
<artifactId>Example</artifactId>
<version>1.0-SNAPSHOT</version>
<properties>
<maven.compiler.source>11</maven.compiler.source>
<maven.compiler.target>11</maven.compiler.target>
<maven.compiler.release>11</maven.compiler.release>
<project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
<project.reporting.outputEncoding>UTF-8</project.reporting.outputEncoding>
</properties>
<repositories>
<!-- REMOVED -->
</repositories>
<dependencies>
<!-- REMOVED -->
</dependencies>
<build>
<sourceDirectory>src</sourceDirectory>
<resources>
<resource>
<directory>res</directory>
</resource>
</resources>
<plugins>
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-compiler-plugin</artifactId>
<configuration>
<compilerArgs>
<arg>--add-exports=java.desktop/sun.java2d.d3d=ALL-UNNAMED</arg>
<arg>--add-exports=java.desktop/sun.java2d.pipe.hw=ALL-UNNAMED</arg>
<arg>--add-exports=java.desktop/java.awt.peer=ALL-UNNAMED</arg>
<arg>--add-exports=java.desktop/sun.java2d=ALL-UNNAMED</arg>
</compilerArgs>
<fork>true</fork>
</configuration>
</plugin>
<!-- Used, during the test phase of the build, to run the unit tests -->
<plugin>
<groupId>org.apache.maven.surefire</groupId>
<artifactId>surefire</artifactId>
<version>2.21.0</version>
</plugin>
<!-- Used to include all of the dependencies in the packaged Jar file -->
<plugin>
<artifactId>maven-assembly-plugin</artifactId>
<configuration>
<archive>
<manifest>
<mainClass>com.valkryst.Example.Driver</mainClass>
</manifest>
</archive>
<descriptorRefs>
<descriptorRef>jar-with-dependencies</descriptorRef>
</descriptorRefs>
</configuration>
<executions>
<execution>
<id>make-assembly</id> <!-- this is used for inheritance merges -->
<phase>package</phase> <!-- bind to the packaging phase -->
<goals>
<goal>single</goal>
</goals>
</execution>
</executions>
</plugin>
</plugins>
</build>
</project>
此脚本使用 jpackage 生成 MSI 安装程序。
mkdir temp
mklink "%~dp0temp\Example-1.0-SNAPSHOT-jar-with-dependencies.jar" "%~dp0..\..\target\Example-1.0-SNAPSHOT-jar-with-dependencies.jar"
"C:\Program Files\Java\jdk-14\bin\jpackage.exe" ^
--type msi ^
--app-version "1.0.0" ^
--copyright "Valkryst, 2020" ^
--name "Example" ^
--vendor "Valkryst" ^
--verbose ^
--icon "%~dp0..\..\res\icon\icon.ico" ^
--input "%~dp0temp" ^
--java-options "-Djdk.module.illegalAccess=permit" ^
--main-class "com.valkryst.Example.Driver" ^
--main-jar "Example-1.0-SNAPSHOT-jar-with-dependencies.jar" ^
--win-dir-chooser ^
--win-shortcut ^
--win-console
del "%~dp0temp\Example-1.0-SNAPSHOT-jar-with-dependencies.jar"
rmdir "%~dp0temp
pause
这是步骤 #4 的输出。
PS C:\Program Files\Example> .\Example.exe
Error: Could not find or load main class com.valkryst.Example.Driver
Caused by: java.lang.ClassNotFoundException: com.valkryst.Example.Driver
经过进一步调查,jpackage 实用程序似乎不支持符号链接。它没有将 Example-1.0-SNAPSHOT-jar-with-dependencies.jar
打包到可执行文件中,因此安装的 Example-1.0.0.exe
无法加载主 Driver
class 因为它不存在于安装目录中。
mkdir temp
copy "%~dp0..\..\target\Example-1.0-SNAPSHOT-jar-with-dependencies.jar" "%~dp0temp\Example-1.0-SNAPSHOT-jar-with-dependencies.jar"
"C:\Program Files\Java\jdk-14\bin\jpackage.exe" ^
--type msi ^
--app-version "1.0.0" ^
--copyright "Valkryst, 2020" ^
--name "Example" ^
--vendor "Valkryst" ^
--verbose ^
--icon "%~dp0..\..\res\icon\icon.ico" ^
--input "%~dp0temp" ^
--java-options "-Djdk.module.illegalAccess=permit" ^
--main-class "com.valkryst.Example.Driver" ^
--main-jar "Example-1.0-SNAPSHOT-jar-with-dependencies.jar" ^
--win-dir-chooser ^
--win-shortcut ^
--win-console
rmdir /S /Q "%~dp0temp
pause
我生成MSI安装程序的过程如下。
- 运行
mvn install
生成Example-1.0-SNAPSHOT-jar-with-dependencies.jar
. - 运行
windows-executable.bat
生成Example-1.0.0.msi
. - 安装
Example-1.0.0.msi
. - 转到安装目录,打开终端,然后运行
Example-1.0.0.exe
查看任何阻止应用程序启动的错误。
此 POM 文件(已删除无关部分)在 mvn install
期间用于生成 Example-1.0-SNAPSHOT-jar-with-dependencies.jar
。
<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
<modelVersion>4.0.0</modelVersion>
<groupId>com.github.Valkryst</groupId>
<artifactId>Example</artifactId>
<version>1.0-SNAPSHOT</version>
<properties>
<maven.compiler.source>11</maven.compiler.source>
<maven.compiler.target>11</maven.compiler.target>
<maven.compiler.release>11</maven.compiler.release>
<project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
<project.reporting.outputEncoding>UTF-8</project.reporting.outputEncoding>
</properties>
<repositories>
<!-- REMOVED -->
</repositories>
<dependencies>
<!-- REMOVED -->
</dependencies>
<build>
<sourceDirectory>src</sourceDirectory>
<resources>
<resource>
<directory>res</directory>
</resource>
</resources>
<plugins>
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-compiler-plugin</artifactId>
<configuration>
<compilerArgs>
<arg>--add-exports=java.desktop/sun.java2d.d3d=ALL-UNNAMED</arg>
<arg>--add-exports=java.desktop/sun.java2d.pipe.hw=ALL-UNNAMED</arg>
<arg>--add-exports=java.desktop/java.awt.peer=ALL-UNNAMED</arg>
<arg>--add-exports=java.desktop/sun.java2d=ALL-UNNAMED</arg>
</compilerArgs>
<fork>true</fork>
</configuration>
</plugin>
<!-- Used, during the test phase of the build, to run the unit tests -->
<plugin>
<groupId>org.apache.maven.surefire</groupId>
<artifactId>surefire</artifactId>
<version>2.21.0</version>
</plugin>
<!-- Used to include all of the dependencies in the packaged Jar file -->
<plugin>
<artifactId>maven-assembly-plugin</artifactId>
<configuration>
<archive>
<manifest>
<mainClass>com.valkryst.Example.Driver</mainClass>
</manifest>
</archive>
<descriptorRefs>
<descriptorRef>jar-with-dependencies</descriptorRef>
</descriptorRefs>
</configuration>
<executions>
<execution>
<id>make-assembly</id> <!-- this is used for inheritance merges -->
<phase>package</phase> <!-- bind to the packaging phase -->
<goals>
<goal>single</goal>
</goals>
</execution>
</executions>
</plugin>
</plugins>
</build>
</project>
此脚本使用 jpackage 生成 MSI 安装程序。
mkdir temp
mklink "%~dp0temp\Example-1.0-SNAPSHOT-jar-with-dependencies.jar" "%~dp0..\..\target\Example-1.0-SNAPSHOT-jar-with-dependencies.jar"
"C:\Program Files\Java\jdk-14\bin\jpackage.exe" ^
--type msi ^
--app-version "1.0.0" ^
--copyright "Valkryst, 2020" ^
--name "Example" ^
--vendor "Valkryst" ^
--verbose ^
--icon "%~dp0..\..\res\icon\icon.ico" ^
--input "%~dp0temp" ^
--java-options "-Djdk.module.illegalAccess=permit" ^
--main-class "com.valkryst.Example.Driver" ^
--main-jar "Example-1.0-SNAPSHOT-jar-with-dependencies.jar" ^
--win-dir-chooser ^
--win-shortcut ^
--win-console
del "%~dp0temp\Example-1.0-SNAPSHOT-jar-with-dependencies.jar"
rmdir "%~dp0temp
pause
这是步骤 #4 的输出。
PS C:\Program Files\Example> .\Example.exe
Error: Could not find or load main class com.valkryst.Example.Driver
Caused by: java.lang.ClassNotFoundException: com.valkryst.Example.Driver
经过进一步调查,jpackage 实用程序似乎不支持符号链接。它没有将 Example-1.0-SNAPSHOT-jar-with-dependencies.jar
打包到可执行文件中,因此安装的 Example-1.0.0.exe
无法加载主 Driver
class 因为它不存在于安装目录中。
mkdir temp
copy "%~dp0..\..\target\Example-1.0-SNAPSHOT-jar-with-dependencies.jar" "%~dp0temp\Example-1.0-SNAPSHOT-jar-with-dependencies.jar"
"C:\Program Files\Java\jdk-14\bin\jpackage.exe" ^
--type msi ^
--app-version "1.0.0" ^
--copyright "Valkryst, 2020" ^
--name "Example" ^
--vendor "Valkryst" ^
--verbose ^
--icon "%~dp0..\..\res\icon\icon.ico" ^
--input "%~dp0temp" ^
--java-options "-Djdk.module.illegalAccess=permit" ^
--main-class "com.valkryst.Example.Driver" ^
--main-jar "Example-1.0-SNAPSHOT-jar-with-dependencies.jar" ^
--win-dir-chooser ^
--win-shortcut ^
--win-console
rmdir /S /Q "%~dp0temp
pause