前言

从 JDK 14 开始，Java 官方引入了 JPackage 工具。它能够将 Java 应用打包成特定网站的原生安装包，自带定制化的 JRE 运行环境。这代表着使用者无需提前安装 Java 环境。双击安装包就可以完成应用部署，极大地简化了交付流程。

使用者痛点：

• 传统方式需要手动下载并配置 JRE，步骤繁琐。
• 不同机器之间 Java 版本不一致导致运行异常。不过，
• 跨网站发布需要维护多套启动脚本。

一、JPackage 简介

什么是 JPackage

JPackage 是 JDK 自带的打包工具，位于 $JA_HOME/bin 目录下。它的主要功能包括：

• 生成网站原生安装包Windows 的 .exe/.msimacOS 的 .dmg/.pkgLinux 的 .deb/.rpm
• 自定义 JRE配合 jlink 裁剪 JDK。仅保留应用所需模块，大幅减小体积。
• 简化部署安装包自带运行时无需额外装配 Java 环境。

JPackage 的优势 vs 传统部署方式

二、环境准备

JDK 版本要求

推荐使用 JDK 16 或更高版本。确认工具可用的观点是，

jpackage --version

网站特定工具

Windows

WiX Toolset

• 下载地址这方面。
• 安装后将 wix\bin 添加到程序环境变量 %PATH%

macOS

Xcode 命令行工具：

xcode-select --install

Linux

• Debian/Ubuntu：

  sudo apt-get install fakeroot
  

• RedHat/CentOS：

  sudo yum install rpm-build
  

三、Spring Boot 项目准备

示例项目结构

my-springboot-app/
├── src/
│ └── main/
│ ├── java/
│ └── resources/
├── pom.xml
└── target/
└── my-app-1.0.0.jar

建立可执行 JAR

Maven 或 Gradle 均可：

# Maven
mvn clean package
# Gradle
gradle clean build

*确保生成的 JAR 为 Spring Boot 可执行文件。按理说，*

四、使用 JPackage 打包

基础打包命令

jpackage \
--input target \
--name MySpringBootApp \
--main-jar my-app-1.0.0.jar \
--main-class org.springframework.boot.loader.JarLauncher \
--type msi \
--app-version 1.0.0 \
--vendor "我的公司" \
--description "基于 Spring Boot 的公司级应用" \
--icon src/main/resources/app-icon.ico \
--win-dir-chooser \
--win-menu \
--win-shortcut

参数说明

自定义 Runtime Image – 减小体积

你可能只想把运行时裁剪到最小，只保留 Spring Boot 所需模块。下面演示完整流程，

步骤 1 : 分析依赖模块

 jdeps – list - deps target / my - app -1 .0 .0 . jar

再看示例输出，

<代码类=“语言-csharp”> java.base java.logging java.sql java.naming java.desktop java.xml java.management ...

**Note**: Ensure you have required modules before cutting down;orwise runtime errors may occur. **Step 2**: Build a custom runtime image bash jlink \ --add-modules java.base,java.logging,java.sql,java.naming,java.desktop,java.xml。java.management \ --output custom-jre \ --strip-debug \ --no-header-files \ --no-man-pages \ --compress=2 **Step 3**: Use custom runtime when packaging bash jpackage \ --input target \ --name MySpringBootApp \ --main-jar my-app-1.0.0.jar\ --main-class org.springframework.boot.loader.JarLauncher\ --type msi\ --runtime-image custom-jre\ --app-version 1.0.0\ --vendor "我的公司"

⚠️ 注意： 如果你的 Spring Boot 应用使用了第三方库，请确保对应模块已被加入 jlink 的 `–add-modules` 参数中，否则可能出现 `ClassNotFoundException`。其实，

---

五、不同网站的打包示例

Windows

bash jpackage ^ —input target ^ —name MyApp ^ —main‑jar my‑app‑1\.0\.0\.jar ^ —main‑class org.springframework.boot.loader.JarLauncher ^ —type msi ^ —app-version 1\.0\.0 ^ —icon src/main/resources/app.ico ^ —win-dir‑chooser ^ —win-menu ^ —win-shortcut

macOS

bash jpackage \ —input target \ —name MyApp \ —main‑jar my‑app‑1\.0\.0\.jar \ —main‑class org.springframework.boot.loader.JarLauncher \ —type dmg \ —app-version 1\.0\.0 \ …

六 集成到 Maven 建立流程

使用 exec-maven-plugin 自动调用 jpackage

在 pom.xml 中添加以下插件配置：

xml

---

---

---

---

---