长期以来,Java开发人员一直希望构建可以直接安装在本机平台上的应用程序,而不是分发jar和配置类路径。使用jpackage,可以按照特定平台的用户使用的方式安装/卸载Java应用程序,它支持Windows上的msi和exe格式,MacOS 上的pkg和dmg以及Linux上的deb和rpm。安装使用jpackage构建的应用程序时,最终用户不应注意到任何差异。
Java应用的分发一直是一个比较麻烦的问题。这是因为Java应用的运行需要虚拟机的支持,仅有Java应用打包的JAR文件是不够的,目标机器还需要安装版本匹配的JDK或JRE。随着云原生和容器化技术的流行,Java应用可以选择以容器镜像的形式来打包和分发,极大地降低了分发难度。不过仍然有相当一部分的Java应用需要直接安装在客户的机器上。
通常的解决方案是使用第三方安装工具,如install4j,创建应用的安装包。安装包负责打包应用和所依赖的Java运行环境。安装工具的问题在于过于繁琐,并且通常是收费的。很多时候我们只是需要简单的运行一个Java程序而已。比如,在客户的机器上运行Java编写的数据迁移工具,第三方框架如: quarkus 等
jpackage的输出是一个Java应用程序映像,包含所有必需的Java依赖项。映像存储在文件系统的单个目录中,可以包含以下内容:
- 本机应用程序启动器
- Java运行时映像,包括模块化应用程序时的应用程序模块
- 应用程序资源,例如jar,ico,png
- 配置文件,例如plist,cfg,properties
jpackage工具计划在新的jdk.jpackage模块中成为JDK 13的一部分。
jpackage工具有两种模式:
- create-image - 生成特定于平台的应用程序镜像
- create-installer - 为应用程序生成特定于平台的安装程序
要生成模块化应用程序镜像:
jpackage create-image --output outputdir --name AppName \ --main-class package.ClassName -module moduleName -p modulePath jpackage create-image --o outputdir -n AppName \ -c package.ClassName -m moduleName -p modulePath |
要生成非模块化应用程序映像:
jpackage create-image --input inputdir --output outputdir \ --name AppName --main-class package.ClassName --main-jar MyJar.jar jpackage create-image -i inputdir -o outputdir -n AppName \ -c package.ClassName -j MyJar.jar |
要生成应用程序安装程序:
jpackage create-installer -i inputdir -o outputdir \ -n -c package.ClassName -j MyJar.jar jpackage create-installer -o outputdir -n \ --app-image |
要生成Java运行时安装程序:
jpackage create-installer --runtime-installer\ --name --output outputdir jpackage create-installer --runtime-installer \ -n -o outputdir --runtime-image |
一些适用于所有平台的选项:
- --main-jar -j <main jar file> - 应用程序的主要JAR; 包含主类
- --main-class -c <class name> - 要执行的应用程序主类的限定名称
- --installer-type <type> - 在create-image模式下创建的安装程序的类型(msi,exe,rpm,deb,dmg,pkg,pkg-app-store)
- --runtime-installer - 为Java运行时生成特定于平台的安装程序。
- --jvm-args <java vm arguments> - 传递给虚拟机的Java参数
- --install-dir <文件路径> - 应用程序安装目录的绝对路径
某些选项仅适用于Mac OS X平台:
- --mac-sign - 请求对包进行签名
- --mac-bundle-name <name string> - 菜单栏中显示的应用程序的名称
- --mac-app-store-category <category string> - Mac App Store类别
- --mac-signing-keychain <文件路径> - 要使用的钥匙串的路径
关于jpackage的其他有趣的事情包括:
- 支持打包Java应用程序,使其适合提交到Windows或MacOS应用程序商店
- 设置文件关联时的本机集成,以便在打开具有关联后缀的文件时启动应用程序
- 本机集成,可以启动特定于平台的菜单组,例如Windows上的“开始”菜单项
- 不支持交叉编译; 应该通过在Windows上运行jpackage来创建Windows程序包
- 将不支持超出JMOD文件中已提供的法律文件,例如单个许可证文件
- 不支持原生启动画面
- 不支持自动更新机制
- 该工具在Solaris平台上不可用
- 不支持Java Web Start应用程序和JavaFX特定功能
- 该工具没有GUI; 仅提供命令行界面(CLI)