首发! JDK14 之 jpackage 命令尝鲜

jpackage 命令使用场景

使用场景是面向 java 桌面端程序打包. 可以让 windows/mac 直接双击使用 java 程序,对系统里面有没有 jdk/jre 不做要求.

在这里,我们先理一下以前 java 桌面程序是怎么运行的:

jdk8 及以前

这时候的 java 客户端程序,主要分两部分, 一部分是可执行 jar 包, 一部分是电脑里面要装 jdk/jre , 然后通过

java -jar XXXXX.jar 来运行程序.

jdk9 及以后的模块化

这是 java 模块化的一个分界线,其实 jdk9,jdk10,我都没有用过, 我是直接尝试的 jdk11. 在模块化的基础上, 项目多了一个文件, moudle-info.java 如下图所示:

module red.lixiang.tools.desktopmain {
    requires fastjson;
    requires javafx.controls;
    requires javafx.fxml;
    requires red.lixiang.tools.common;
    requires red.lixiang.tools.base;
    requires com.jfoenix;
    
    opens com.platform.tools.desktop to javafx.fxml;
    opens com.platform.tools.desktop.controller.kub to javafx.fxml;
    opens com.platform.tools.desktop.controller.host to javafx.fxml;
    opens com.platform.tools.desktop.controller.set to javafx.fxml;
    opens com.platform.tools.desktop.conf to fastjson;

    exports com.platform.tools.desktop;
    exports com.platform.tools.desktop.controller;
    exports com.platform.tools.desktop.conf;

}

如上图,所示,主要是 requires , opens , exports 这三个关键字.

requires : 当前模块想要运行的话,需要哪些依赖,相当于在 maven 引包的基础上,要再声明一遍依赖

opens: 当前模块中的哪些包,可以被反射. 如 fxml 中要声明处理的 controller , 每当 fxml 加载的时候,都会去新建一个 controller 实例, 所以需要 opens controller 的包名给 javafx.fxml

exports: 当前模块有哪些包,可以被引用. 一般用于别的模块依赖当前模块的时候

jdk9 及以后的打包方式

在 jdk9 及以后,打包方式,可以不局限于打 jar 包,可以把 jdk 的这些模块给一起用 jlink 打成一个镜像.

如下我用 gradle 的 jlink 去打包

最后的成果:

如上所示, 会在 build 目录,生面 image 镜像文件夹,然后在其中有 bin , conf, lib .然后用 cmd 运行 bin 目录中的 Sunflower 就可以了, 如下所示: 记住这朵 Sunflower , 我要让他盛开在广大 java 程序员的桌面,哈哈

可以看到, 这时候除了程序主体存在,还有一个 cmd 窗口在这里,何其不方便!!! 这时候, jdk13 及以后的 jpackage 命令就派上用场了, 刚好我写这个的时候, jdk14 early access 版本发布了, 就直接拿 jdk14 做了实验

JDK14 的 jpackage 命令

在安装好 jdk14 之后,可以使用 jpackage -h 命令看下使用说明,如下图所示

其实这个是在上一部 jlink 有镜像之后,对镜像做了一层封装.

我最后实验成功的打包命令是:

/Users/lixiang/soft/jdk-14.jdk/Contents/Home/bin/jpackage --runtime-image image --type dmg --name Sunflower --module red.lixiang.tools.desktopmain/com.platform.tools.desktop.DesktopMain

--runtime-image 后面跟的是文件夹, 就是我们 build 目录下的 image 文件夹

--type 打成什么样的包, 在 mac 系统中有 app-image , dmg , pkg 三个选项, windows 的我没试,应该是有 exe 选项

--name 软件的名字, 这里是 Sunflower(向日葵)

--moudle 模块的名字,相当于以前的 Main 函数的格式,这里换成了模块 '包名'/Main 函数名

运行后结果如下:

最终如上图,可以看到生成的 dmg 文件, 在 mac 上,进行安装就可以使用了

项目源码

一.Sunflower 应用还在开发中, 不久后会开放下载.

二. javafx+gradle 应用: https://openjfx.io/openjfx-docs/#gradle

三. 项目所用到的判断系统工具类,读取/更改 host 工具类等开源地址如下:

xiaodaojava/sunshine Do you like sunshine? Yes. . Contribute to xiaodaojava/sunshine development by creating an account on GitHub. GitHub - github.com

里面还有很多很多常用的工具类. 求一个 star~~~