使用jdk14+提供的jpackage工具打包jar

使用jpackage

• 本次使用jdk16.0.1,在命令行输入命令jpackage xxx,可能会提醒需要安装的软件,下载安装即可

• 创建一个文件夹source-file(名字随意),把jar放进去,如果项目需要其他文件,也放进去,会被统一打包到exe/msi中

• 本次打包命令:
  jpackage -i source-file -n quicKey --type "msi" --icon auto.ico --vendor "刘亚龙" --description "这是app描述" --copyright "这是版权信息" --app-version 1.01 --verbose --win-per-user-install --win-dir-chooser --win-menu --win-shortcut --win-console --main-jar change-music-1.0.jar

• 如果不想弹出黑窗口,可以去掉--win-console命令行模式

• --main-jar 和 -i 是必须要提供的,其他的可以不提供,-n建议设置一个app名字. 注意,如果jar包里没提供主类,需要用--main-class className指定,强烈建议在打包成jar时指定好程序入口,可以看这篇文章

• 简洁常用命令项:jpackage -i 输入路径 -n quicKey --type "msi" --icon 绝对路径/xxx.ico --verbose --win-dir-chooser --win-menu --win-shortcut --win-console --main-jar change-music-1.0.jar

• 示例: D:\Java\jdk-17.0.2\bin\jpackage -i ./ -n note-book --type "msi" --app-version "2.0" --icon ico.ico --vendor "YaLong" --description "这是肥肥仔专用的笔记本" --copyright "版权归属于肥肥仔" --win-per-user-install --win-menu --verbose --win-dir-chooser --win-menu --win-shortcut --main-jar notebook-2.0.jar

• 注意:

  • 如果在jar的文件夹中执行命令,并且输入路径为当前路径时,不需要指定文件路径,例如命令 jpackage -i ./ -n lol-helper --type "msi" --icon huaji.ico --verbose --win-dir-chooser --win-menu --win-shortcut --main-jar lol-helper-1.0.jar
  • 如果输入路径不是当前路径,存放jar的文件夹会拼接到jar路径的前面,但不会拼接到icon的前面,所以icon要用绝对路径
  • 会把输入路径下的所有内容都打包进去,所以尽量选一个空文件夹进行打包,里面只放ico和jar,以及需要用到的资源
  • --win-per-user-install大概率能解决权限问题

命令参数介绍:

```
jpackage -h
用法：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 -m 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>
--------------

一般选项：
  @<filename>
          从文件读取选项和/或模式
          可以多次使用此选项。
  --type -t <type>
          要创建的程序包的类型
          有效值为：{"app-image", "exe", "msi"}
          如果未指定此选项，则将创建与平台相关的
          默认类型。
  --app-version <version>
          应用程序和/或程序包的版本
  --copyright <copyright string>
          应用程序的版权
  --description <description string>
          应用程序的说明
  --help -h
          将用法文本输出到输出流并退出，用法文本中包含
          适用于当前平台的每个有效选项的列表和说明
  --name -n <name>
          应用程序和/或程序包的名称
  --dest -d <destination path>
          用来放置所生成的输出文件的路径
          默认为当前的工作目录。
          （绝对路径或相对于当前目录的路径）
  --temp <file path>
          用来创建临时文件的新目录或空白目录的路径
          （绝对路径或相对于当前目录的路径）
          如果指定，则在任务完成时将不删除临时目录，
          必须手动删除临时目录
          如果未指定，则将创建一个临时目录，
          并在任务完成时删除该临时目录。
  --vendor <vendor string>
          应用程序的供应商
  --verbose
          启用详细的输出
  --version
          将产品版本输出到输出流并退出

用来创建运行时映像的选项：
  --add-modules <模块名称>[,<模块名称>...]
          要添加的模块的逗号 (",") 分隔列表。
          此模块列表连同主模块（如果指定）
          将作为 --add-module 参数传递到 jlink。
          如果未指定，则仅使用主模块（如果指定了 --module），
          或者使用默认的模块集（如果指定了
          --main-jar）。
          可以多次使用此选项。
  --module-path -p <module path>...
          路径的 ; 分隔列表
          每个路径要么是模块的目录，要么是
          模块 jar 的路径。
          （每个路径可以是绝对路径，也可以是相对于当前目录的路径）
          可以多次使用此选项。
  --jlink-options <jlink 选项>
          要传递给 jlink 的选项列表（用空格分隔）
          如果未指定，则默认为 "--strip-native-commands
          --strip-debug --no-man-pages --no-header-files"
          可以多次使用此选项。
  --runtime-image <file path>
          将复制到应用程序映像的预定义
          运行时映像的路径
          （绝对路径或相对于当前目录的路径）
          如果未指定 --runtime-image，jpackage 将运行 jlink 以
          使用如下选项创建运行时映像：
          --strip-debug、--no-header-files、--no-man-pages 和
          --strip-native-commands。

用来创建应用程序映像的选项：
  --icon <icon file path>
          应用程序包图标的路径
          （绝对路径或相对于当前目录的路径）
  --input -i <input path>
          包含要打包的文件的输入目录的路径
          （绝对路径或相对于当前目录的路径）
          输入目录中的所有文件将打包到
          应用程序映像中。

用来创建应用程序启动程序的选项：
  --add-launcher <launcher name>=<file path>
          启动程序的名称和包含关键字-值对列表的
          属性文件的路径
          （绝对路径或相对于当前目录的路径）
          可以使用关键字 "module"、"main-jar"、"main-class"、
          "arguments"、"java-options"、"app-version"、"icon" 和
          "win-console"。
          这些选项将添加到原始命令行选项中或者用来覆盖
          原始命令行选项，以构建额外的替代启动程序。
          将从命令行选项构建主应用程序启动程序。
          可以使用此选项构建额外的替代启动程序，
          可以多次使用此选项来构建
          多个额外的启动程序。
  --arguments <main class arguments>
          在没有为启动程序提供命令行参数时，
          要传递到主类的命令行参数
          可以多次使用此选项。
  --java-options <java options>
          要传递到 Java 运行时的选项
          可以多次使用此选项。
  --main-class <class name>
          要执行的应用程序主类的限定名称
          只有在指定了 --main-jar 时才能使用此选项。
  --main-jar <main jar file>
          应用程序的主 JAR；包含主类
          （指定为相对于输入路径的路径）
          可以指定 --module 或 --main-jar 选项，但是不能同时指定
          两者。
  --module -m <module name>[/<main class>]
          应用程序的主模块（以及可选的主类）
          此模块必须位于模块路径中。
          如果指定了此选项，则将在 Java 运行时映像中
          链接主模块。可以指定 --module 或 --main-jar 选项，
          但是不能同时指定这两个选项。

用来创建应用程序启动程序的与平台相关的选项：
  --win-console
          为应用程序创建控制台启动程序，应当为
          需要控制台交互的应用程序指定

用来创建应用程序包的选项：
  --app-image <file path>
          用来构建可安装程序包的
          预定义应用程序映像的位置
          （绝对路径或相对于当前目录的路径）
  --file-associations <file path>
          包含关键字-值对列表的属性文件的路径
          （绝对路径或相对于当前目录的路径）
          可以使用关键字 "extension"、"mime-type"、"icon" 和 "description"
          来描述此关联。
          可以多次使用此选项。
  --install-dir <file path>
          默认安装位置下面的相对子路径
  --license-file <file path>
          许可证文件的路径
          （绝对路径或相对于当前目录的路径）
  --resource-dir <path>
          覆盖 jpackage 资源的路径
          可以通过向该目录中添加替代资源来覆盖 jpackage 的
          图标、模板文件和其他资源。
          （绝对路径或相对于当前目录的路径）
  --runtime-image <file-path>
          要安装的预定义运行时映像的路径
          （绝对路径或相对于当前目录的路径）
          在创建运行时程序包时需要使用选项。

用来创建应用程序包的与平台相关的选项：
  --win-dir-chooser
          添加一个对话框以允许用户选择
          产品的安装目录
  --win-menu
          将该应用程序添加到系统菜单中
  --win-menu-group <menu group name>
          启动该应用程序所在的菜单组
  --win-per-user-install
          请求基于每个用户执行安装
  --win-shortcut
          为应用程序创建桌面快捷方式
  --win-upgrade-uuid <id string>
          与此程序包升级相关联的 UUID