jpackage  --input target/  --main-jar note.jar  --runtime-image H:/Dpanbeifeng/apps/finalshell/jre  --type app-image --dest output/ --main-class com.textmanager.Main --icon logo2.png  --name 猫咪快笔记

jpackage 打包指令详细介绍

jpackage 概述

jpackage 是 Java 14 正式加入的一个用于独立打包的工具，该工具将以 Java 应用程序和 Java 运行时映像作为输入，并生成一个包含所有必要依赖项的 Java 应用程序映像。它可以生成特定于平台格式的本机软件包，例如 Windows 上的 exe 或 macOS 上的 dmg。每种格式都必须在其所在的平台上构建，没有跨平台支持。该工具还提供各种选项，允许以不同方式自定义打包的应用程序1。

前期准备

Java 版本

JPackage 指令是 JAVA 14 新增的，所以安装的 JAVA 版本必须 14+。若使用 jpackage 打包 JavaFX 应用，需确保 Java 版本是 17 或更高，因为从 Java 17 开始引入了对打包 JavaFX 应用的支持12。

打包成 jar 文件

使用 mvn package 命令在项目下生成 target 目录，且包含打包成的 jar（例如：demo - 1.0.jar ），并确认这个 jar 能使用 java -jar ***.jar 命令运行。也可以通过 IDE 或使用 Maven、Gradle 等构建工具来生成 JAR 文件12。

安装 WiX Toolset（可选，生成 msi 安装程序时需要）

若要生成 Windows 平台的 msi 安装程序，需要提前安装 WiX Toolset。安装 wix311 需要 .NET 3.5.1 环境，在 win10 电脑上可按以下步骤操作：打开控制面板，点击程序，点击启用或关闭 Windows 功能，在打开的窗口里勾选 .NET Framework 3.5，然后让 Windows 下载安装即可。安装完 wix 工具后就可以使用 jpackage 生成 msi 安装程序1。

运行过程

进入 jdk 对应 bin 目录

进入安装的 JDK 版本（如 jdk17）的 bin 目录下。

打开命令行工具

可以使用 CMD 或 Powershell 打开命令行窗口。

使用 jpackage 打包文件

生成运行程序 app - image

使用相应的 jpackage 命令来生成 app - image，具体命令需根据实际情况配置参数。

生成运行程序 exe

配置好相关参数后，使用 jpackage 命令生成 Windows 平台的 exe 运行程序。

生成安装程序 msi

在安装好 WiX Toolset 后，通过配置合适的参数使用 jpackage 命令生成 msi 安装程序1。

jpackage 参数解释

jpackage 有很多参数可以配置，例如应用名称、版本、许可证文件等。可以在命令行中使用 --help 参数来查看所有可用的参数。以下是一些常见参数及其作用示例：

参数	作用
--input	指定包含 JAR 文件的目录2
--name	设置应用的名称2
--type	指定生成的安装包类型（例如 dmg、exe、deb 等）2

打包 JavaFX 应用的流程

编写 JavaFX 应用

若还没有编写应用，可以使用 JavaFX SDK 和喜欢的 IDE 来创建一个2。

检查 Java 版本

确保 Java 版本是 17 或更高，可通过在终端或命令提示符中运行相应命令来检查 Java 版本2。

使用 jpackage 打包

生成 JAR 文件

可通过 IDE 或使用 Maven、Gradle 等构建工具完成2。

配置 jpackage 参数

根据需求配置如应用名称、版本、许可证文件等参数2。

执行 jpackage 命令

使用配置好参数的 jpackage 命令来打包应用，执行后将在指定的输入目录中生成安装包