嘿，老友，今天聊聊怎么用 Spring Boot 搭配 JPackage Zuo一个独立安装包。

你想想，之前把 Spring Boot 打成 fat jar，然后让业务同事直接跑 jar，结果总是得装 Java 环境、手动配置类路径……这流程真是慢半拍。 JPackage 从 JDK14 起就跟着官方走上前线，它Ke以把 jar 包变成 Windows 的 MSI/EXE、macOS 的 DMG/PKG 或 Linux 的 DEB/RPM。 一键搞定图标、快捷方式、开始菜单，还Neng自带一个Zui小化的 JRE，让用户点开安装包就Neng直接跑。

假设你Yi经有了一个标准的 Spring Boot 项目：

my-springboot-app/
├─ src/
│   └─ main/
│       ├─ java/
│       │   └─ com/example/app/
│       │       ├─ DemoApplication.java
│       │       └─ ...
│       └─ resources/
├─ pom.xml
└─ target/   # 编译后会生成 my-app-1.0.0.jar

记得用 Maven 或 Gradle 打一次包，得到可执行的 fat jar。Spring Boot 默认就把 JarLauncher 当主类，所以我们后面用它来启动。

打开终端，输入：

jpackage --version

Ru果kan到版本号，那就说明你的 JDK Yi经装好。要是提示找不到命令，记得检查 $JAVA_HOME/bin 是否在 PATH。

说到这个问题，其实原因hen简单：内容原创度低或者没有足够外链。 再加上技术性文章往往被搜索引擎识别为“技术教程”，Ru果缺少社交分享和外部引用，就hen难上首页。 所以我们现在写的这篇文章，要尽量多放实际代码、案例，还有自己的经验分享，让它geng有价值。

下面给你一段 Windows 下的 jpackage 命令示例：

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 \  
 --win-menu-group "我的应用"

一句一句拆开kan：

—input: 指向包含 jar 的目录；

—name: 给安装包起名；

—main-jar: 主 jar 文件名；

—main-class: 主类，这里是 JarLauncher；

—type msi: Windows 安装包类型；

—app-version: 版本号；

—icon: 图标文件；其他参数dou是让用户geng友好的 UI 选项。

--add-modules java.base,java.logging,... 
--strip-debug \
--no-header-files \
--no-man-pages \
--compress=fast

The macOS 示例跟 Windows hen像，只是 type 换成 dmg，并且 icon 用 icns 格式：

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 \
 --icon src/main/resources/app.icns \
 --mac-package-name "com.mycompany.myapp" \
 --mac-package-identifier "com.mycompany.myapp"

LinuX 的打包稍微复杂一点，需要额外安装 fakeroot 或 rpm-build 等工具，但 jpackage 本身Yi经支持 DEB 和 RPM：

jpackage \
 --input target \
 --name myapp \
 --main-jar my-app-1.0.0.jar \
 --main-class org.springframework.boot.loader.JarLauncher \
 --type deb \
 --app-version 1.0.0 \
 --icon src/main/resources/app.png \
 --linux-shortcut \
 --linux-menu-group "Development"
 

五、自定义 JRE——减小体积的关键步骤😎

Straight up，Ru果你想让安装包geng轻量，就需要裁剪掉不必要的 Java 模块。那就是 jlink 的舞台了。

步骤一：先确定需要哪些模块 jdeps -list-deps target/my-app-1.0.x.jar

"jdeps" 会告诉你哪些模块被引用。一般来说一个纯净的 Spring Boot 应用会用到 java.base、java.logging、java.sql、java.naming、java.desktop 等等。Ru果还有 WebSocket 那就再加一个 java.net.http 等等。

 org.codehaus.mojo
 exec-maven-plugin
 1.*
 
  
    package
    
    goal'exec
 

 configuration'       executable'jpackage
     ...  ...
     ...
     ...
     ...
     ... 
 
}
 

* 插件中省略了一大堆参数，为了演示方便，只保留核心部分。
* Ru果你想让每次 mvn clean package dou自动生成 MSI，那么把上面配置粘进 pom.xml 即可。
* 对于 Linux，你只需改 type 为 deb 或 rpm 并保持其它参数一致即可。
Maven+JPackage 一体化流程完成后只需要一句 mvn clean package 就Neng拿到完整的独立安装包！💪🏻‍♂️ 
常见坑点与调试技巧🛠️ 

**没找到 Java Runtime** —— 确认你的 JAVA_HOME 指向的是 JDK，而不是仅有运行时环境的 OpenJDK / OracleJDK 安装版。因为 jlink/jpackage 必须访问完整工具链。
**图标显示异常** —— Windows 要 .ico 格式，Linux 要 .png，而 macOS 要 .icns。Ru果图标尺寸不匹配，也会导致显示错误或失败。
*“主类找不到”错误* —— 确认 main‑class 参数写的是 JarLauncher 而不是自己的 Application 类。有时候手误写成 DemoApplication 就报错 “Could not find or load main class”。别担心，一对双斜杠改正就行！ *
*“未找到依赖模块”* —— 用 `jdeps` 
检查，Ru果遗漏了 `java.sql` 或 `java.naming` 那么在裁剪时一定要加进去，否则运行时抛 ModuleNotFoundException。
注：Ru果你只想快速验证而不关心体积，Ke以跳过自定义 JRE 步骤，直接用默认完整 JRE 打包。但这样Zui终文件往往超过百 MB，不太适合大规模分发哦~😉
**** ：

`spring boot + fat jar` -> `jlink 自定义 runtime` -> `jpackage 原生 installer` = 完全独立可执行软件包；
- 支持多平台；
- 无需预装 Java；
- 易于分发与管理；
- 可通过 Maven 自动化部署；
- 成熟稳定。　
 

无论是企业内部工具还是面向客户的软件发布，dou推荐使用这个方案——因为它既省事又专业，而且未来还Neng轻松升级到 GraalVM Native Image，geng进一步缩小体积和提升启动速度哦~🤗😄`
 

Zui后一句话送给所有刚开始玩这套技术的小伙伴们：
别怕试错，每一次失败dou是学习曲线上的加速器。继续尝试，下次一定Neng顺利打出第一个 MSI/DMG/DEB！
　  — 老友祝福 🚀

🌟 回到顶部 ▲︎︎︎︎︎︎︎︎︎︎︎︎︎  … … … … … … …           🙈🙈🙈⁠⁠⁠⁠⁠⁠⁠⁠⁠  🏃‍♂️🏃‍♀️🏃‍♂️🕹️👾🧨🤘🏻💻🔥👨‍💻💬📦📲🌍✉️🖥️🖱️🚀🎯🗂️🎁✨✌🏼😊🍕🍺🥳🔧🔩⚙️🚚🔬🔭💡🌐⏱⏰⌛🎉🥇🚑🚓🏁🎊👏👏👏​'
 


                        

                        

                         

                    

                    

                        

                            标签：  
                            安装包  
                        
                    
                    

                    
                    

                        

                            

                                 上一篇： 
                                手打茶变机打，奶茶口感提升，你愿意尝试吗？  
                            
                            

                                 下一篇： 
                                2023年9月彩虹易支付新增付款功能，如何轻松实现高效收款？