jlink:jlink

全名

org.apache.maven.plugins:maven-jlink-plugin:3.0.0:jlink

说明

JLink 目标旨在创建基于http://openjdk.java.net/jeps/282http://openjdk.java.net/jeps/220的 Java 运行时映像文件。

属性

  • 需要执行一个 Maven 项目。
  • 需要范围内工件的依赖解析:运行时
  • 默认绑定到生命周期阶段

可选参数

姓名 类型 自从 描述
<添加模块> 列表 -

通常这不是必需的,因为这是由给定的依赖项自动处理的。

通过使用 --add-modules 您可以定义要解析的根模块。pom.xml文件中的配置可能如下所示:

<addModules>
  <addModule>mod1</addModule>
  <addModule>first</addModule>
  .
  .
</addModules>
jlink 的命令行等效项是:--add-modules <mod>[,<mod>...]
<绑定服务> 布尔值 - 是否添加选项--bind-services
默认值为false
<压缩> 整数 - 您可以在此处定义正在使用的资源的压缩。等效的命令行是:-c, --compress=level>。级别的有效值为: 0, 1, 2
<禁用插件> 细绳 - 您可以使用此选项禁用插件。 --disable-plugin 插件名称
<字节序> 细绳 - 生成的 Java 运行时映像的字节顺序。--endian <小|大>。如果未给出字节序,则默认值为:native
<忽略签名信息> 布尔值 - --ignore-signing-information
默认值为false
<包括区域设置> 列表 - 包括 langtag 是 BCP 47 语言标签的语言环境列表。

此选项支持 RFC 4647 中定义的区域匹配。确保在使用此选项时添加模块 jdk.localedata。

等效的命令行是: --include-locales=en,ja,*-IN

<includeLocales>
  <includeLocale>en</includeLocale>
  <includeLocale>ja</includeLocale>
  <includeLocale>*-IN</includeLocale>
  .
  .
</includeLocales>

<jdk工具链> 地图 -

指定此 jdk 工具链的要求。这会否决 maven-toolchain-plugin 选择的工具链。

注意:至少需要 Maven 3.3.1
<启动器> 细绳 - 插件是否应该通过 jlink 生成启动器脚本?等效的命令行是:--launcher <name>=<module>[/<mainclass>]。该级别的有效值为: <name>=<module>[/<mainclass>]
<limitModules> 列表 - 限制可观察模块的范围。下面给出了可以在 pom.xml文件中使用的配置示例。

  <limitModules>
    <limitModule>mod1</limitModule>
    <limitModule>xyz</limitModule>
    .
    .
  </limitModules>
此配置等效于命令行选项: --limit-modules <mod>[,<mod>...]
<模块路径> 列表 - 在--module-path选项中包含其他路径。项目依赖项和 JDK 模块会自动添加。
<noHeaderFiles> 布尔值 - 这将抑制在生成的 Java 运行时映像中有一个包含目录。JLink 命令行等效项为:--no-header-files
默认值为false
<noManPages> 布尔值 - 这将禁止在生成的 Java 运行时映像中包含man目录。JLink 命令行等效项为:--no-man-pages
默认值为false
<插件模块路径> 细绳 - 定义要使用的插件模块路径。可以定义多个条目,由;分隔。。jlink命令行等效项是: --plugin-module-path <modulepath>
<sourceJdkModules> 文件 - 设置 JDK 位置以创建 Java 自定义运行时映像。
<带调试> 布尔值 - 这是为了去除调试信息。jlink的命令行等价物是:-G, --strip-debug 去除 调试信息。
默认值为false
<建议提供者> 列表 - 建议从模块路径实现给定服务类型的提供者。
<suggestProviders>
  <suggestProvider>name-a</suggestProvider>
  <suggestProvider>name-b</suggestProvider>
  .
  .
</suggestProviders>
jlink 命令链接等效项: --suggest -providers [<name>,...]
<详细> 布尔值 - 这将打开详细模式。jlink 命令行等效项为:--verbose
默认值为false

参数详情

<添加模块>

通常这不是必需的,因为这是由给定的依赖项自动处理的。

通过使用 --add-modules 您可以定义要解析的根模块。pom.xml文件中的配置可能如下所示:

<addModules>
  <addModule>mod1</addModule>
  <addModule>first</addModule>
  .
  .
</addModules>
jlink 的命令行等效项是:--add-modules <mod>[,<mod>...]
  • 类型java.util.List
  • 要求

<绑定服务>

是否添加选项--bind-services
  • 类型布尔值
  • 要求
  • 默认值

<压缩>

您可以在此处定义正在使用的资源的压缩。等效的命令行是:-c, --compress=level>。级别的有效值为: 0, 1, 2
  • 类型java.lang.Integer
  • 要求

<禁用插件>

您可以使用此选项禁用插件。 --disable-plugin 插件名称
  • 类型java.lang.String
  • 要求

<字节序>

生成的 Java 运行时映像的字节顺序。--endian <小|大>。如果未给出字节序,则默认值为:native
  • 类型java.lang.String
  • 要求

<忽略签名信息>

--忽略签名信息
  • 类型布尔值
  • 要求
  • 默认值

<包括区域设置>

包括 langtag 是 BCP 47 语言标签的语言环境列表。

此选项支持 RFC 4647 中定义的区域匹配。确保在使用此选项时添加模块 jdk.localedata。

等效的命令行是: --include-locales=en,ja,*-IN

<includeLocales>
  <includeLocale>en</includeLocale>
  <includeLocale>ja</includeLocale>
  <includeLocale>*-IN</includeLocale>
  .
  .
</includeLocales>
  • 类型java.util.List
  • 要求

<jdk工具链>

指定此 jdk 工具链的要求。这会否决 maven-toolchain-plugin 选择的工具链。

注意:至少需要 Maven 3.3.1
  • 类型java.util.Map
  • 要求

<启动器>

插件是否应该通过 jlink 生成启动器脚本?等效的命令行是:--launcher <name>=<module>[/<mainclass>]。该级别的有效值为: <name>=<module>[/<mainclass>]
  • 类型java.lang.String
  • 要求

<limitModules>

限制可观察模块的范围。下面给出了可以在 pom.xml文件中使用的配置示例。

  <limitModules>
    <limitModule>mod1</limitModule>
    <limitModule>xyz</limitModule>
    .
    .
  </limitModules>
此配置等效于命令行选项: --limit-modules <mod>[,<mod>...]
  • 类型java.util.List
  • 要求

<模块路径>

在--module-path选项中包含其他路径。项目依赖项和 JDK 模块会自动添加。
  • 类型java.util.List
  • 要求

<noHeaderFiles>

这将抑制在生成的 Java 运行时映像中有一个包含目录。JLink 命令行等效项是: --no -header-files
  • 类型布尔值
  • 要求
  • 默认值

<noManPages>

这将禁止在生成的 Java 运行时映像中包含man目录。JLink 命令行等效项是: --no -man-pages
  • 类型布尔值
  • 要求
  • 默认值

<插件模块路径>

定义要使用的插件模块路径。可以定义多个条目,由;分隔。。jlink命令行等效项是: --plugin-module-path <modulepath>
  • 类型java.lang.String
  • 要求

<sourceJdkModules>

设置 JDK 位置以创建 Java 自定义运行时映像。
  • 类型java.io.File
  • 要求

<带调试>

这是为了去除调试信息。jlink的命令行等价物是:-G, --strip-debug 去除 调试信息。
  • 类型布尔值
  • 要求
  • 默认值

<建议提供者>

建议从模块路径实现给定服务类型的提供者。
<suggestProviders>
  <suggestProvider>name-a</suggestProvider>
  <suggestProvider>name-b</suggestProvider>
  .
  .
</suggestProviders>
jlink 命令链接等效项: --suggest -providers [<name>,...]
  • 类型java.util.List
  • 要求

<详细>

这将打开详细模式。jlink 命令行等效项是:-- verbose
  • 类型布尔值
  • 要求
  • 默认值