Jpackage-制作无需预装Java环境的Jar可执行程序

2024-03-12 0 3,166

JAR 包要在预装 JRE 环境系统上执行。如果没有预先安装 JRE 环境,又想直接运行 Java 程序,该怎么办呢?

Jpackage-制作无需预装Java环境的Jar可执行程序

这篇文章我们会先学习如何将 Java 程序打包成一个可执行的 Java JAR 文件。然后演示如何使用这个 JAR 文件生成 Windows、Linux、MacOS 上的可执行程序。 我们将使用 Java 自带的 jar 命令行工具来创建 JAR 文件。然后学会使用 jpackage 工具创建各个系统上的可执行程序。

注意:jpackage 工具从 Java 14 版本开始提供的,可以用来生成可执行程序。

什么是 jar

jar 文件是一个包含编译后的 Java Class 文件和其他资源的容器。它基于广泛使用的 ZIP 文件格式,因此 jar 文件可以使用 ZIP解压缩工具解压。 一个可执行的 jar 文件需要包含一个 mAIn 类作为程序的入口,并在 MANIFEST.MF 文件中指定

但是为了运行 jar 格式的应用程序,必须有一个Java 运行时环境(JRE)。

jar 命令

Java 的 jar 命令是 Java Archive Tool,它是一个用于创建、查看和管理 jar 文件的命令行工具。此工具包含在 JDK 中。

详细介绍 jar 命令的使用不是本文目的,下面给出 jar 命令的常见用法。

创建一个输出 Hello 的Java 类用于测试。

目录结构:

├── Hello.java
└── META-INF
    └── MANIFEST.MF

查看文件内容然后编译 Hello.java

public class Hello{
    public static void main(String[] args) throws InterruptedException{
        System.out.println("Hello");
        // 3s 后退出
        Thread.sleep(3 * 1000);
    }
}
// 编译:javac Hello.java

配置 MANIFEST.MF 文件,注意,最后一定要有一个换行,否则可能在 Windows 上运行失败。

Manifest-Version: 1.0
Main-Class: Hello

  1. 创建 jar 文件

    jar cmf META-INF/MANIFEST.MF hello.jar Hello.class
    

    其中 c 表示创建新的归档文件,m 指定清单文件,f 指定生成的 jar 文件的名称,最后是要添加到 jar 包中的文件列表。

  2. 执行 jar 文件

    java -jar hello.jar
    Hello
    
  3. 查看 jar 文件

    $ jar tf hello.jar
    META-INF/
    META-INF/MANIFEST.MF
    Hello.class
    

    其中 tlist,列出文件。f 指定 jar 文件。

创建 jar 文件有多种方式,比如借助 Maven 或者 Gradle 工具都可以打包 Java 程序为 jar 文件,而且更加方便。比如 Spring Boot 开发过程中, mvn package 即可生成 jar 文件。

jpackage 命令

jpackage 命令是从 Java 14 开始提供的,可以帮助我们为模块化或非模块化 Java 应用程序生成指定系统平台的可执行程序,而不用预先安装 JRE 环境。如何做到的呢?

我们知道 Java 程序必须在 JRE环境才能运行, jpackage 其实是把 JRE 和 JAR 文件以及所有必要依赖项一起打包生成指定平台的可执行程序。例如 Windows 上的 exe 或 macOS 上的 dmg。每种格式都必须构建在其运行的平台上,没有跨平台支持。工具还提供了常见的自定义操作,如应用名,应用图标等。

查看 jpackage 帮助:

jpackage --help
用法:jpackage <options>

示例用法:
--------------
    生成适合主机系统的应用程序包:
        对于模块化应用程序:
            jpackage -n name -p modulePath -m moduleName/className
        对于非模块化应用程序:
            jpackage -i inputDir -n name \\
                --main-class className --main-jar myJar.jar
        从预构建的应用程序映像:
            jpackage -n name --app-image appImageDir
    生成应用程序映像:
        对于模块化应用程序:
            jpackage --type app-image -n name -p modulePath \\
                -m moduleName/className
        对于非模块化应用程序:
            jpackage --type app-image -i inputDir -n name \\
                --main-class className --main-jar myJar.jar
        要为 jlink 提供您自己的选项,请单独运行 jlink:
            jlink --output appRuntimeImage -p modulePath \\
                --add-modules moduleName \\
                --no-header-files [<additional jlink options>...]
            jpackage --type app-image -n name \\
                -m moduleName/className --runtime-image appRuntimeImage
    生成 Java 运行时程序包:
        jpackage -n name --runtime-image <runtime-image>
    对预定义应用程序映像进行签名:
        jpackage --type app-image --app-image <app-image> \\
            --mac-sign [<additional signing options>...]
        注:此模式下允许的其他选项只有:
              一组其他 mac 签名选项和 --verbose
........

jpackage 创建可执行文件

创建可执行程序命令格式:

jpackage --input . --name YouAppName --main-jar youfile.jar

现在让我们使用上面的 hello.jar 来创建一个可执行的JAR文件。hello.jar 直接运行会输出 Hello 字符。

Windows 平台

注意: 对于 Windows,jpackage 需要 WiX 3.0 或更高版本。

Winx3.14 下载:https://github.com/wixtoolset/wix3/releases/tag/wix314rtm

由于 hello.jar 是一个命令行程序,没有 UI界面,因此打包时使用 --win-console 参数配置以命令行方式启动。

常见的 Windows 下 jpackage 参数还有:

  • --type : 指定打包后的格式,如 msi、exe,默认 exe。
  • --win-console:使用控制台窗口启动我们的应用程序
  • --win-shortcut : 在 Windows 开始菜单中创建快捷方式文件
  • --win-dir-chooser:让最终用户指定自定义目录来安装可执行文件

打包成 exe 程序。

jpackage --input . --name helloApp1 --win-console --win-shortcut --main-jar hello.jar

打包后可以得到 helloApp1-1.0.exe 文件。

PS C:\\Users\\Administrator\\Desktop\\test> jpackage --input . --name helloApp --win-console --win-shortcut --main-jar hello.jar
PS C:\\Users\\Administrator\\Desktop\\test> ls
Mode                 LastWriteTime         Length Name
----                 -------------         ------ ----
-a----          2024/3/7     22:14            526 Hello.class
-a----          2024/3/7     22:14            802 hello.jar
-a----          2024/3/7     22:13            208 Hello.java
-a----          2024/3/7     22:17      110145536 helloApp1-1.0.exe
-a----          2024/3/7     21:58             42 MANIFEST.MF

直接双击运行安装。

Jpackage-制作无需预装Java环境的Jar可执行程序

安装完成后,桌面上会出现图标,双击可以运行并输出 Hello 字符串。

Jpackage-制作无需预装Java环境的Jar可执行程序

Mac 平台

Mac 平台运行 jpackage 命令会自动生成 dmg 安装包。

jpackage --input . --name hello --main-jar hello.jar

生成 hello-1.0.dmg 文件,双击弹出安装界面。

Jpackage-制作无需预装Java环境的Jar可执行程序

因为测试程序 hello.jar 是一个输出 Hello 字符串的命令行程序,并没有 UI,因此测试从命令行启动查看输出。

➜  ~ /Applications/hello.app/Contents/MacOS/hello
Hello

Linux 平台

jpackage --input . --name hello --main-jar hello.jar

我所在 Linux 系统为 Ubuntu22 ,所以生成安装包 hello_1.0_AMD64.deb

$ ls -l -h
total 37M
-rw-r--r-- 1 root root  37M Mar  7 16:50 hello_1.0_amd64.deb
-rw-r--r-- 1 root root  401 Mar  6 11:42 Hello.class
-rw-r--r-- 1 root root 1.1K Mar  7 16:42 hello.jar
-rw-r--r-- 1 root root   96 Mar  6 11:41 Hello.java
-rw-r--r-- 1 root root   41 Mar  6 11:42 MANIFEST.MF

安装 hello_1.0_amd64.deb

$ apt install hello_1.0_amd64.deb

安装后命令位于 /opt 目录下,运行测试:

$ /opt/hello/bin/hello
Hello

总结

本文介绍了在没有预装 JRE 环境的系统上运行 Java 程序的方法。首先,介绍如何使用 Java 的 jar 命令行工具创建一个可执行的 JAR 文件,这需要编写 Java 程序,配置 MANIFEST.MF 文件,并使用 jar 命令创建包含主类的 JAR 文件。接着,介绍了 jpackage 工具(从 Java 14 版本开始提供),该工具可以打包 JAR 文件和必要的 JRE 环境,生成适用于 Windows、Linux、MacOS 的可执行程序,使得 Java 应用程序能够在无需预装 JRE 的情况下运行。

参考

本文 Github.com/niumoo/JavaNotes仓库已经收录。
本文原发于网站:Jpackage - 制作无需预装 Java 环境的 Jar 可执行程序
本文原发于公众号:<a href=\"https://mp.weixin.QQ.com/s/lwaNEfJI4U36_jCsyfpo_w\" rel=\"noopener\" target=\"_blank\">程序猿阿朗

资源下载此资源下载价格为1小猪币,终身VIP免费,请先
由于本站资源来源于互联网,以研究交流为目的,所有仅供大家参考、学习,不存在任何商业目的与商业用途,如资源存在BUG以及其他任何问题,请自行解决,本站不提供技术服务! 由于资源为虚拟可复制性,下载后不予退积分和退款,谢谢您的支持!如遇到失效或错误的下载链接请联系客服QQ:442469558

:本文采用 知识共享署名-非商业性使用-相同方式共享 4.0 国际许可协议 进行许可, 转载请附上原文出处链接。
1、本站提供的源码不保证资源的完整性以及安全性,不附带任何技术服务!
2、本站提供的模板、软件工具等其他资源,均不包含技术服务,请大家谅解!
3、本站提供的资源仅供下载者参考学习,请勿用于任何商业用途,请24小时内删除!
4、如需商用,请购买正版,由于未及时购买正版发生的侵权行为,与本站无关。
5、本站部分资源存放于百度网盘或其他网盘中,请提前注册好百度网盘账号,下载安装百度网盘客户端或其他网盘客户端进行下载;
6、本站部分资源文件是经压缩后的,请下载后安装解压软件,推荐使用WinRAR和7-Zip解压软件。
7、如果本站提供的资源侵犯到了您的权益,请邮件联系: 442469558@qq.com 进行处理!

猪小侠源码-最新源码下载平台 Java教程 Jpackage-制作无需预装Java环境的Jar可执行程序 http://www.20zxx.cn/816499/xuexijiaocheng/javajc.html

猪小侠源码,优质资源分享网

常见问题
  • 本站所有资源版权均属于原作者所有,均只能用于参考学习,请勿直接商用。若由于商用引起版权纠纷,一切责任均由使用者承担
查看详情
  • 最常见的情况是下载不完整: 可对比下载完压缩包的与网盘上的容量,建议提前注册好百度网盘账号,使用百度网盘客户端下载
查看详情

相关文章

官方客服团队

为您解决烦忧 - 24小时在线 专业服务