1. 简介jpackage 是 JDK 14 引入的一个工具，旨在帮助开发者将 Java 应用程序打包成原生的可执行文件，支持 Windows、macOS 和 Linux 平台。通过 jpackage，你可以将 Java 应用和其所需的依赖打包在一起，并创建本地安装程序。
本文将展示如何使用 jpackage 将一个简单的 Java 应用程序打包成可执行文件，包括打包 Windows (.exe)，macOS (.app)，和 Linux (.deb) 文件的步骤。
2. 准备工作2.1. 安装 JDK 14 或更高版本jpackage 工具是从 JDK 14 开始提供的，因此你需要安装 JDK 14 或更高版本。你可以从 Oracle 官网 或者 OpenJDK 下载并安装。
安装完成后，通过命令行验证安装是否成功：
代码语言：javascript代码运行次数：0运行复制java -version你应该看到类似以下输出，确认你安装的是 JDK 14 或更高版本：
代码语言：javascript代码运行次数：0运行复制C:\Users\mobai>java -version
java version "23.0.2" 2025-01-21
Java(TM) SE Runtime Environment (build 23.0.2+7-58)
Java HotSpot(TM) 64-Bit Server VM (build 23.0.2+7-58, mixed mode, sharing)2.2. 安装 WiX 工具直接执行 jpackage 命令会报错，所以需要安装 WiX
代码语言：javascript代码运行次数：0运行复制[18:01:09.359] 找不到 WiX 工具 (light.exe, candle.exe)
[18:01:09.359] 从 https://wixtoolset.org 下载 WiX 3.0 或更高版本，然后将其添加到 PATH。
错误：类型 [msi] 无效或不受支持下载地址：https://github.com/wixtoolset/wix3/releases
image-202502201055107582.3. Jpackage 参数说明代码语言：javascript代码运行次数：0运行复制C:\>jpackage --help
用法：jpackage
示例用法:
--------------
生成适合主机系统的应用程序包：
对于模块化应用程序：
jpackage -n name -p modulePath -m moduleName/className
对于非模块化应用程序：
jpackage -i inputDir -n name \
--main-class className --main-jar myJar.jar
从预构建的应用程序映像：
jpackage -n name --app-image appImageDir
生成应用程序映像：
对于模块化应用程序：
jpackage --type app-image -n name -p modulePath \
-m moduleName/className
对于非模块化应用程序：
jpackage --type app-image -i inputDir -n name \
--main-class className --main-jar myJar.jar
要为 jlink 提供您自己的选项，请单独运行 jlink：
jlink --output appRuntimeImage -p modulePath \
--add-modules moduleName \
--no-header-files [
jpackage --type app-image -n name \
-m moduleName/className --runtime-image appRuntimeImage
生成 Java 运行时程序包：
jpackage -n name --runtime-image
一般选项：
@
从文件读取选项和 / 或模式
可以多次使用此选项。
--type -t
要创建的程序包的类型
有效值为：{"app-image", "exe", "msi"}
如果未指定此选项，则将创建与平台相关的
默认类型。
--app-version
应用程序和 / 或程序包的版本
--copyright
应用程序的版权
--description
应用程序的说明
--help -h
将用法文本输出到输出流并退出，用法文本中包含
适用于当前平台的每个有效选项的列表和说明
--icon
应用程序包图标的路径
（绝对路径或相对于当前目录的路径）
--name -n
应用程序和 / 或程序包的名称
--dest -d
用来放置所生成的输出文件的路径
（绝对路径或相对于当前目录的路径）
默认为当前的工作目录。
--temp
用来创建临时文件的新目录或空白目录的路径
（绝对路径或相对于当前目录的路径）
如果指定，则在任务完成时将不删除临时目录，
必须手动删除临时目录。
如果未指定，则将创建一个临时目录，
并在任务完成时删除该临时目录。
--vendor
应用程序的供应商
--verbose
启用详细的输出
--version
将产品版本输出到输出流并退出。
用来创建运行时映像的选项：
--add-modules <模块名称 >[,< 模块名称>...]
要添加的模块的逗号 (",") 分隔列表
此模块列表连同主模块（如果指定）
将作为 --add-module 参数传递到 jlink。
如果未指定，则仅使用主模块（如果指定了 --module），
或者使用默认的模块集（如果指定了
--main-jar）。
可以多次使用此选项。
--module-path -p
路径的 ; 分隔列表
每个路径要么是模块的目录，要么是
模块化 jar 的路径。
（每个路径可以是绝对路径，也可以是相对于当前目录的路径。）
可以多次使用此选项。
--jlink-options
要传递给 jlink 的选项列表（用空格分隔）
如果未指定，则默认为 "--strip-native-commands
--strip-debug --no-man-pages --no-header-files"。
可以多次使用此选项。
--runtime-image
将复制到应用程序映像的预定义
运行时映像的路径
（绝对路径或相对于当前目录的路径）
如果未指定 --runtime-image，jpackage 将运行 jlink 以
使用如下选项创建运行时映像：
--strip-debug、--no-header-files、--no-man-pages 和
--strip-native-commands。
用来创建应用程序映像的选项：
--input -i
包含要打包的文件的输入目录的路径
（绝对路径或相对于当前目录的路径）
输入目录中的所有文件将打包到
应用程序映像中。
--app-content
要添加到应用程序有效负载中的文件和 / 或
目录的逗号分隔路径列表。
此选项可以多次使用。
用来创建应用程序启动程序的选项：
--add-launcher
启动程序的名称和包含关键字 - 值对列表的
属性文件的路径
（绝对路径或相对于当前目录的路径）
可以使用关键字 "module"、"main-jar"、"main-class"、"description"、
"arguments"、"java-options"、"app-version"、"icon"、
"launcher-as-service"、
"win-console"、"win-shortcut"、"win-menu"、
"linux-app-category" 和 "linux-shortcut"。
这些选项将添加到原始命令行选项中或者用来覆盖
原始命令行选项，以构建额外的替代启动程序。
将从命令行选项构建主应用程序启动程序。
可以使用此选项构建额外的替代启动程序，
可以多次使用此选项来构建
多个额外的启动程序。
--arguments
在没有为启动程序提供命令行参数时，
要传递到主类的命令行参数
可以多次使用此选项。
--java-options
要传递到 Java 运行时的选项
可以多次使用此选项。
--main-class
要执行的应用程序主类的限定名称
只有在指定了 --main-jar 时才能使用此选项。
--main-jar
应用程序的主 JAR；包含主类
（指定为相对于输入路径的路径）
可以指定 --module 或 --main-jar 选项，但是不能同时指定
两者。
--module -m
应用程序的主模块（以及可选的主类）
此模块必须位于模块路径中。
如果指定了此选项，则将在 Java 运行时映像中
链接主模块。可以指定 --module 或 --main-jar 选项，
但是不能同时指定这两个选项。
用来创建应用程序启动程序的与平台相关的选项：
--win-console
为应用程序创建控制台启动程序，应当为
需要控制台交互的应用程序指定
用来创建应用程序包的选项：
--about-url
应用程序主页的 URL
--app-image
用来构建可安装程序包的
预定义应用程序映像的位置
（绝对路径或相对于当前目录的路径）
--file-associations
包含关键字 - 值对列表的属性文件的路径
（绝对路径或相对于当前目录的路径）
可以使用关键字 "extension"、"mime-type"、"icon" 和 "description"
来描述此关联。
可以多次使用此选项。
--install-dir
默认安装位置下面的相对子路径
--license-file
许可证文件的路径
（绝对路径或相对于当前目录的路径）
--resource-dir
覆盖 jpackage 资源的路径
可以通过向该目录中添加替代资源来覆盖 jpackage 的
图标、模板文件和其他资源。
（绝对路径或相对于当前目录的路径）
--runtime-image
要安装的预定义运行时映像的路径
（绝对路径或相对于当前目录的路径）
在创建运行时程序包时需要使用选项。
--launcher-as-service
请求创建安装程序，以将主
应用程序启动程序注册为后台服务类型应用程序。
用来创建应用程序包的与平台相关的选项：
--win-dir-chooser
添加一个对话框以允许用户选择
产品的安装目录。
--win-help-url
用户可以从中获取更多信息或技术支持的 URL
--win-menu
请求为此应用程序添加开始菜单快捷方式
--win-menu-group