新手程序员求IntelliJ中Gradle JavaFX项目转exe/msi安装包分步指南

一、前置准备 #

• 确保使用JDK 16及以上版本（jpackage工具从JDK16开始内置）
• 确认项目在IntelliJ中能正常运行，Gradle构建无报错
• 若要生成msi安装包，需安装WiX Toolset，并将其bin目录添加到系统环境变量PATH中

二、配置Gradle构建脚本 #

在项目的build.gradle文件中添加jpackage相关配置（已有的JavaFX、application插件保留）：

plugins {
    id 'java'
    id 'application'
    id 'org.openjfx.javafxplugin' version '0.0.13'
    id 'org.beryx.jlink' version '2.25.0' // 可选，用于构建精简JRE
    id 'org.beryx.jpackage' version '2.25.0'
}

// 保持你项目原有的JavaFX配置，替换为实际版本和模块
javafx {
    version = '21'
    modules = ['javafx.controls', 'javafx.fxml']
}

// 指定项目主类的全路径，比如com.example.Main
mainClassName = '你的主类全路径'

jpackage {
    imageName = '你的应用显示名称'
    installerName = '你的安装包名称'
    installerType = 'msi' // 要生成exe则改为'exe'
    mainJar = "${jar.archiveFileName}"
    destinationDir = file("build/installer")
    // 自定义安装选项
    installerOptions = [
        '--win-menu',
        '--win-desktop-shortcut',
        '--win-dir-chooser',
        '--win-shortcut-prompt'
    ]
    // 若使用jlink生成的精简JRE，取消注释下面一行
    // runtimeImage = jlink.outputDir
}

三、（可选）构建精简JRE #

为了减小安装包体积，推荐用jlink生成仅包含项目所需模块的JRE：

• 在IntelliJ右侧的Gradle面板中，找到Tasks > build > jlink，双击运行
• 生成的精简JRE会存放在build/image目录下

四、生成安装包 #

• 打开IntelliJ终端，执行命令：
  Windows平台：gradlew jpackage
• 构建完成后，exe/msi安装包会生成在build/installer目录中

五、测试安装包 #

• 找到生成的安装文件，双击运行测试安装流程
• 安装完成后启动应用，确认功能与原项目一致

常见问题提示 #

• 若提示找不到WiX Toolset，检查其bin目录是否已添加到系统PATH
• 主类路径务必正确，否则jpackage无法找到应用入口
• 如需自定义应用图标，可在installerOptions中添加'--icon', '路径/到/你的图标.ico'参数

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