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 命令來打包應用,執行后將在指定的輸入目錄中生成安裝包