Gradle配置jpackage添加--win-console后执行文件异常求助

问题概述 #

使用Gradle配置jpackage任务生成Windows可执行文件，添加--win-console参数后出现运行异常，已排除JavaFX、SimpleITK、dcm4che的影响，确定问题与LWJGL相关。

解决方案 #

1. 调整--win-console参数的位置 #

--win-console是控制应用可执行文件是否显示控制台的参数，属于应用镜像创建参数，而非安装程序参数，需要从installerOptions移到createOptions中：

jlink{
    jpackage {
        if (org.gradle.internal.os.OperatingSystem.current().windows) {
            // 控制台参数放到createOptions
            createOptions += ['--win-console']
            // 安装程序相关参数保留在installerOptions
            installerOptions += ['--win-per-user-install', '--win-menu', '--win-shortcut', '--win-menu-group', '--win-dir-chooser']
        }
    }
}

2. 传递LWJGL所需的JVM运行参数 #

run任务中的JVM参数不会自动传递到jpackage打包后的应用，需要手动在jpackage配置中添加这些参数，确保LWJGL能正确加载原生库并获取必要权限：

jlink{
    jpackage {
        if (org.gradle.internal.os.OperatingSystem.current().windows) {
            jvmArgs += [
                // 指向打包后的原生库路径
                '-Djava.library.path="./runtime/bin"',
                '--add-opens', 'java.desktop/javax.imageio.stream=dcm4che.imageio.opencv',
                '--add-opens', 'java.base/java.io=dcm4che.imageio.opencv',
                '-Dorg.lwjgl.util.Debug=true',
                '-Dorg.lwjgl.util.DebugLoader=true'
            ]
            // 其他createOptions、installerOptions配置...
        }
    }
}

3. 确保LWJGL模块被jlink正确包含 #

jlink生成最小化JRE镜像，需确保LWJGL核心模块及你使用的子模块被包含，避免运行时类缺失：

jlink {
    // 根据实际使用的LWJGL模块添加，示例包含核心、GLFW、OpenGL模块
    modules += ['org.lwjgl', 'org.lwjgl.glfw', 'org.lwjgl.opengl']
    // 其他jpackage配置...
}

4. 验证原生库的复制逻辑 #

检查jpackageImage.doLast中的复制操作，确保LWJGL原生DLL文件完整复制到runtime/bin，且版本与依赖的LWJGL一致：

tasks.jpackageImage.doLast {
    // 明确复制所需的LWJGL DLL文件
    copy {
        from lwjglNativesPath
        into("$buildDir/jpackage/$project.name/runtime/bin")
        include 'lwjgl.dll', 'lwjgl_glfw.dll', 'lwjgl_opengl.dll'
    }
    // 其他复制操作...
}

5. 测试运行 #

重新执行jpackage任务后，直接运行runtime/bin下的Java可执行文件（而非安装后的快捷方式），查看控制台输出的错误信息，进一步定位问题。

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