解锁Java打包新姿式

时间 2020-01-28

标签解锁 java 打包栏目 Java 繁體版

原文原文链接

在平时咱们打包会将其打成Jar，那么在其余平台运行的时候就须要安装jre来支持运行。css

那么实际上Java是能够打包成native平台所属类型的，例如：html

exe
installer
image
msi
dmg
rpm
deb

固然我在查阅了不少博客，及其官网的信息，java

见到最多的是exe4j，可是看到有一些评论说，打包以后没法运行，并且我下载了exe4j以后是不能运行的。因此排除此选项。node

除了exe4j呢还有，install4j，jwrapper等工具，可是他们都是收费的，因此也排除。git

还有Java9的jaot，早期版本的java14的jpackage，java8的javapackagergithub

在查阅的博客中有人提到了java9的jaot，下载了java9，可是并无找到jaot，考虑到经常使用版本是8，因此也排除了jaot。shell

那么只剩下java14的jpackage和java8的javapackager，这两个我都有过实践，效果几乎一直，打出来的包大小也差很少（没有对jre作过任何裁剪的状况下）。windows

最终选择了Java8自带的javapackager这个工具。（可是遗憾的是，没法显示控制台的内容，建议使用日志文件去代替。java14的jpackage是能够指定是否显示控制台）api

如今咱们就来看看，如何将jar包打包成native形式的包。安全

准备内容

Inno Setup Compiler（Java8支持6版本如下的，不要下载6及其6以上的版本，不然没法打包成功）
wix（打包成msi必须下载，没有下载javapackager会提示缺乏wix）
java8的环境
示例的jar程序（本文使用这个jar做为示例，方便交流学习）

程序介绍

启动程序以后，会在c盘建立一个名为我是测试文件.txt的文件，每秒会给文件中写入”休眠*秒“的字样，直到10s以后程序运行结束，结尾会有写入成功的字样。（若是启动以后没有生成该文件，请在任务管理器找到该进程结束，而后以管理员身份运行该程序。）

让咱们开始第一个打包吧！

在此以前，默认您准备内容已经阅读而且完成了。

进入你下载jar的包的文件夹，而且打开powershell

输入：

javapackager -deploy -native image  -outdir cs -outfile cs -srcfiles pack.jar -appclass cn.qs.CS -name CS
复制代码

你会在同级目录找到一个叫cs的文件夹，进入cs，再进入bundles文件夹。找到cs.exe，用管理员身份运行。
进入C盘就能找到该程序生成的我是测试文件.txt的文件

至此，简单的打包结束。

如今咱们来看一下上面的命令表明什么意思。

javapackager---java8自带的打包程序

-deploy---用来构建目标机器的发行版本，简单说就是打包成exe或者其余平台的包，若是不带任何参数，会生成一个基本的应用程序，不建议不带任何参数

-native image---为jar建立磁盘镜像（能够将image替换为其余的类型，例如exe，msi，deb，rpm）

-outdir cs---输出目录。

-outfile cs----输出文件（不要带后缀，好比cs.exe，就写cs就好了）。

-srcfiles pack.jar---要打包的jar文件。

-appclass cn.qs.CS---jar文件的主类的全限定名。（注意是全限定名）

-name CS---启动以后的应用名称
复制代码

更多的参数将会在文章最后附上。也能够直接输入javapackager来查看帮助，或者进入官网查看

来作一些定制吧

目标

修改应用图标
修改应用说明（按照官网操做，指定了可是无效，能够忽略）
修改应用程序的供应商（vendor）

注意：由于是控制台程序呢，因此 标题，宽，高指定的话也没什么意义。因此咱们在此就修改这两个属性就能够了。

咱们开始定制吧

注意：测试过image的形式，描述（description）和说明（vendor）是无效的，在exe和msi形式下是能够的

在下载的jar的同级目录，删掉刚才生成的cs文件夹。

从新执行命令：

javapackager -deploy -native exe  -outdir cs -outfile cs -srcfiles pack.jar -appclass cn.qs.CS -name CS -description "测试的描述" -vendor "测试厂商" -Bicon=".\cs.ico"
复制代码

如今咱们就定义成功了。（能够自行看一下，是否是咱们自定义的图标，说明，供应商）关于更多自定义的话请查阅官网（这些自定义的bundle参数在使用的时候要注意，-B加上参数名=值例如 icon 使用的时候就是 -Bicon=“path”）

bundle参数说明

除了上述打包bundle参数以外呢，在介绍一些通用的bundle参数和windows的bubdle参数。

通用参数

appVersion=version 应用的版本，例如：-BappVersion=1.0.1

classPath=path 类路径相对于打包后应用的目录（默认不用设置。）

icon=path 应用图标的路径，例如：-Bicon=".\cs.ico"

identifier 用于其余特定平台的默认值。

jvmOptions=option 用来指定jvm参数，例如：-BjvmOptions=-Xmx128m -BjvmOptions=-Xms128m

jvmProperties=property=value 当程序运行的时候，这个参数会被传入到jvm中，能够经过System.getProperty()来获取，java -Dproperty 均可以使用，须要指定参数名和值，若是要传递多个请参考：-BjvmProperties=apiUserName=example -BjvmProperties=apiKey=abcdef1234567890

mainJar=filename 包含主类的jar文件的名称，该文件名一般是从jar文件的mainfest中得到，若是你使用javapackager命令，不用指定这个值

preferencesID=node 用来检查用户可覆盖的jvm选项，被指定的选项在运行时做为 -Dapp.preferences.id.参数传给应用，这个参数须要和userJVMOptions一块儿使用。

runtime=path Jdk或者jre的位置，若是使用系统默认的jre则不须要提供。例如：-Bruntime=

userJvmOptions=option=value 能被用户覆盖的jvm选项 java命令所使用的任何选项都是有效的，要传入多个，请参考： -BuserJvmOptions=-Xmx=128m -BuserJvmOptions=-Xms=128m

windows

copyright=string 应用的版本字符串，例如：2002-2020 Jetbrains s.r.o.

licenseFile=path 最终用户许可协议的位置（EULA），例如 -BlicenseFile=COPYING

menuHit=boolean

标志着是否在开始菜单或开始屏幕上安装快捷方式，设置为true来安装快捷方式，默认是true 例如：-BmenuHint=true

shortcutHint=boolean 标志着是否在桌面安装快捷图标，设置为true表示安装，默认是false。例如：-BshortcutHint=true

systemWide=boolean 标志着应用程序是安装在Programs Files中仍是在UserData中，设置为true安装在Programs Files，默认为false

win.menuGroup=group menuGroup只有在menuHint为true的时候才生效，menuHint为false这个参数会被忽略掉。

vendor=value 也就是做者，能够是我的，组织，公司等。用于exe，或者registry metadata.

参数简述

用法: javapackager -command [-options]

其中 command 为如下项之一:
  -createjar
          打包程序根据其余参数生成 jar 档案。
  -deploy
          打包程序根据其余参数生成 jnlp 和 html
          文件。
  -createbss
          将 css 文件转换为二进制形式
  -signJar
          使用提供的证书为 jar 文件签名。
  -makeall
          将 compilation, createjar 和 deploy 步骤做为一个调用执行,
          在其中预约义大多数参数。源必须位于 "src"
          文件夹中, 生成的文件 (jar, jnlp, html) 将放入 "dist"
          文件夹中。此命令只能以最简单方式配置, 而且
          尽量自动进行。

createjar 命令的选项包括:
  -appclass <application class>
          要执行的应用程序类的限定名称。
  -preloader <preloader class>
          要执行的预加载器类的限定名称。
  -paramfile <file>
          包含默认命名应用程序参数的属性文件。
  -argument arg
          JNLP 文件的 <fx:argument> 元素中要放入的未命名
          参数。
  -classpath <files>
          相关 jar 文件名列表。
  -manifestAttrs <manifest attributes>
          附加清单属性列表。语法: "name1=value1,
          name2=value2,name3=value3"。
  -noembedlauncher
          若是存在, 打包程序将不会向 jarfile 添加 JavaFX
          启动程序类。
  -nocss2bin
          在复制到 jar 以前, 打包程序不会将 CSS 文件转换为
          二进制形式。
  -runtimeversion <version>
          所需 JavaFX 运行时的版本。
  -outdir <dir>
          要将输出文件生成到的目录的名称。
  -outfile <filename>
          生成的文件的名称 (不带扩展名)。
  -srcdir <dir>
          待打包文件的基目录。
  -srcfiles <files>
          srcdir 中的文件的列表。若是省略, 将对 srcdir (在
          这种状况下是必需的参数) 中的全部文件进行打包。

deploy 命令的选项包括:
  -title <title>
          应用程序的标题。
  -vendor <vendor>
          应用程序的供应商。
  -description <description>
          应用程序的说明。
  -appclass <application class>
          要执行的应用程序类的限定名称。
  -preloader <preloader class>
          要执行的预加载器类的限定名称。
  -paramfile <file>
          包含默认命名应用程序参数的属性文件。
  -htmlparamfile <file>
          包含所生成小应用程序参数的属性文件。
  -width <width>
          应用程序的宽度。
  -height <height>
          应用程序的高度。
  -native <type>
          生成自包含的应用程序包 (若是可能)。
          若是指定了类型, 则只建立此类型的包。
          所支持类型的列表包括: installer, image, exe, msi, dmg, rpm 和 deb。
  -name <name>
          应用程序的名称。
  -embedjnlp
          若是存在, 会将 jnlp 文件嵌入 html 文档中。
  -embedCertificates
          若是存在, 会将证书嵌入 jnlp 文件中。
  -allpermissions
          若是存在, 应用程序将须要 jnlp 文件中的全部
          安全权限。
  -updatemode <updatemode>
          设置 jnlp 文件的更新模式。
  -isExtension
          若是存在, srcfile 将被视为扩展。
  -callbacks
          在生成的 HTML 中指定用户回调方法。格式为
          "name1:value1,name2:value2,..."
  -templateInFilename
          html 模板文件的名称。占位符格式为
          #XXXX.YYYY(APPID)#
  -templateOutFilename
          要将已填充的模板写入到的 html 文件的名称。
  -templateId
          用于模板处理的应用程序的应用程序 ID。
  -argument arg
          JNLP 文件的 <fx:argument> 元素中要放入的未命名
          参数。
  -outdir <dir>
          要将输出文件生成到的目录的名称。
  -outfile <filename>
          生成的文件的名称 (不带扩展名)。
  -srcdir <dir>
          待打包文件的基目录。
  -srcfiles <files>
          srcdir 中的文件的列表。若是省略, 将对 srcdir (在
          这种状况下是必需的参数) 中的全部文件进行打包。

createbss 命令的选项包括:
  -outdir <dir>
          要将输出文件生成到的目录的名称。
  -srcdir <dir>
          待打包文件的基目录。
  -srcfiles <files>
          srcdir 中的文件的列表。若是省略, 将对 srcdir (在
          这种状况下是必需的参数) 中的全部文件进行打包。

signJar 命令的选项包括:
  -keyStore <file>
          密钥库文件名。
  -alias
          密钥的别名。
  -storePass
          用于检查密钥库完整性或对密钥库取消锁定的口令。
  -keyPass
          用于恢复密钥的口令。
  -storeType
          密钥库类型, 默认值为 "jks"。
  -outdir <dir>
          要将输出文件生成到的目录的名称。
  -srcdir <dir>
          待签名文件的基目录。
  -srcfiles <files>
          srcdir 中的文件的列表。若是省略, 将对 srcdir (在
          这种状况下是必需的参数) 中的全部文件进行打包。

makeAll 命令的选项包括:
  -appclass <application class>
          要执行的应用程序类的限定名称。
  -preloader <preloader class>
          要执行的预加载器类的限定名称。
  -classpath <files>
          相关 jar 文件名列表。
  -name <name>
          应用程序的名称。
  -width <width>
          应用程序的宽度。
  -height <height>
          应用程序的高度。
  -v      启用详细输出。

示例用法:
--------------
javapackager -createjar -appclass package.ClassName
  -srcdir classes -outdir out -outfile outjar -v
          将类目录的内容打包到 outjar.jar,
          将应用程序类设置为 package.ClassName。
javapackager -deploy -outdir outdir -outfile outfile -width 34 -height 43
  -name AppName -appclass package.ClassName -v -srcdir compiled
          在由 package.ClassName 类启动且大小为 34x43 的
          应用程序 AppName 的 outdir 中生成
          outfile.jnlp 和对应的 outfile.html 文件。
javapackager -makeall -appclass brickbreaker.Main -name BrickBreaker
  -width 600 -height 600
          此命令执行包含编译在内的全部打包工做:
          compile, createjar 和 deploy。

复制代码

结语

通过这一番操做，其实应该对打包有必定的我的理解了。

也有的人提出建立一个bat来启动java程序，好处不言而喻，可是也有弊端。例如：在任务管理器里面显示的进程是java进程，那么若是有多个这样的程序呢，就会致使分不清进程。并且须要依赖JRE。

那么在这种打包方式中呢，存在不少弊端，例如，包体积太大，可是解决了上面的弊端问题，并且在java9中可使用jlink来对jre进行裁剪，包体积会进一步缩小，我的更倾向于第二种打包方式，如何抉择，请结合业务场景和需求。

关于javapackager打包相关的内容，请参考官网

遇到问题，请在下方评论留言。