使用jpackage打包Java应用：如何强制使用自带runtime避免JDK/JRE冲突

问题场景 #

在Windows平台使用jpackage工具打包Java应用，执行命令如下：
jpackage --java-options '-splash:$APPDIR/splash.png' --type app-image -n AppName -i jar --main-jar myApp.jar -d output --icon icon.ico

生成的应用镜像结构为：

appName\
  AppName.exe
  icon.ico
  app\
    myApp.jar
    myApp.cfg
    some more data files
  runtime\
    bin\
    conf\
    legal\
    lib\
    release

当系统未安装其他JDK/JRE时，点击AppName.exe可正常启动；但用户系统已安装JDK/JRE且配置了JAVA_HOME环境变量、java.exe在系统路径中时，程序会优先使用系统Java环境而非打包的runtime，导致应用启动失败或出现异常。手动修改系统环境变量可解决，但操作繁琐且可能影响其他应用，需通过jpackage配置实现强制使用内置runtime。

可行解决方案 #

1. 添加--win-console参数（控制台应用适用） #

如果你的应用是控制台程序，在jpackage命令中加入--win-console参数，生成的exe会优先调用打包的runtime，而非系统Java环境。修改后的命令：
jpackage --java-options '-splash:$APPDIR/splash.png' --type app-image -n AppName -i jar --main-jar myApp.jar -d output --icon icon.ico --win-console

2. 修改应用配置文件（通用方案） #

打开生成的app\myApp.cfg文件，添加一行配置指定java-home路径：

java-home=$APPDIR/../runtime

$APPDIR是jpackage内置变量，指向app目录，$APPDIR/../runtime正好对应打包的runtime文件夹，以此强制应用使用内置环境。

3. 自定义启动脚本（进阶方案） #

编写批处理脚本（如start_app.bat）放在appName根目录，直接指定使用打包的java.exe启动应用：

@echo off
setlocal
set JAVA_HOME=%~dp0runtime
"%JAVA_HOME%\bin\java.exe" -splash:"%~dp0app\splash.png" -jar "%~dp0app\myApp.jar"
endlocal

引导用户通过该脚本启动，完全绕过系统Java环境。

4. 用--runtime-image指定独立runtime（推荐方案） #

先通过jlink生成定制化的独立JRE，再用jpackage打包时指定该JRE，确保应用严格使用内置环境：

1. 生成定制JRE（根据应用依赖调整模块）：
   jlink --add-modules java.desktop,java.logging --output custom_runtime
2. 修改jpackage命令添加--runtime-image参数：
   jpackage --java-options '-splash:$APPDIR/splash.png' --type app-image -n AppName -i jar --main-jar myApp.jar -d output --icon icon.ico --runtime-image custom_runtime

内容的提问来源于stack exchange，提问作者ndbd