链接

自 Apache Ant 1.10.6 起

描述

将 jmod 文件组装成可执行映像。等效于 JDK 的 jlink 工具。

需要 Java 9 或更高版本。

参数

作为嵌套元素指定的参数

<link> 可以具有以下嵌套元素

• modulepath
• module
• observableModule
• launcher
• locale
• resourceOrder
• excludeResources
• excludeFiles
• compress
• releaseInfo

modulepath

路径状结构，指向要链接到映像中的 jmod 文件。

module

命名要放入链接映像中的单个模块。这可以多次指定。

属性

observableModule

命名对链接过程可见的模块，而不是将模块路径中的每个模块都视为可见。这可以多次指定。

属性

launcher

指定将添加到链接映像中的可执行文件，该文件执行特定模块的主类。属性

locale

指定要包含在链接映像中的语言环境。可以多次指定。需要 jdk.localedata 模块。属性

resourceOrder

链接映像中的显式资源搜索顺序。可以多次指定。属性

如果任务上也存在 resourceOrder 属性，则其模式将被视为在嵌套的 <resourceOrder> 元素中的模式之前出现。

excludeResources

从链接映像树中排除文件。可以多次指定。属性

excludeFiles

从链接映像中排除文件。可以多次指定。属性

compress

描述映像应如何压缩。属性

<compress> 还可以具有任意数量的嵌套 <files> 元素，具有以下属性

releaseInfo

替换、增加或修剪映像的发布信息属性。可以多次指定。属性

<releaseInfo> 还可以具有任意数量的以下嵌套元素

add

指定其他发布信息属性。属性

delete

要从应用程序的发布信息中删除的属性键。属性

示例

基本链接

<jmod destfile="MyApp.jmod" classpath="build/myapp.jar"/>
<link destDir="build/image" modulepath="MyApp.jmod"
      modules="com.example.myapp"/>

自定义二进制文件

这将导致在映像中出现 bin/MyEditor 脚本

<jmod destfile="MyApp.jmod" classpath="build/myapp.jar"/>
<link destDir="build/image" modulepath="MyApp.jmod"
      modules="com.example.myapp"
      launchers="MyEditor=com.example.myapp/com.example.myapp.editors.EditorMain"/>

相同的事情，使用嵌套的 launcher 元素

<jmod destfile="MyApp.jmod" classpath="build/myapp.jar"/>
<link destDir="build/image" modulepath="MyApp.jmod"
      modules="com.example.myapp">

    <launcher name="MyEditor" module="com.example.myapp"
              mainClass="com.example.myapp.editors.EditorMain"/>

</link>

限制语言环境

仅包含应用程序从 jdk.localedata 模块中需要的语言环境

<jmod destfile="MyApp.jmod" classpath="build/myapp.jar"/>
<link destDir="build/image" modulepath="MyApp.jmod"
      modules="com.example.myapp,jdk.localedata"
      locales="zh,jp-*"/>

压缩映像

压缩整个映像

<jmod destfile="MyApp.jmod" classpath="build/myapp.jar"/>
<link destDir="build/image" modulepath="MyApp.jmod"
      modules="com.example.myapp,jdk.localedata"
      compress="zip"/>

仅压缩映像中的某些文件

<jmod destfile="MyApp.jmod" classpath="build/myapp.jar"/>
<link destDir="build/image" modulepath="MyApp.jmod"
      modules="com.example.myapp,jdk.localedata">

    <compress level="zip" files=".*\.xml"/>

</link>

交叉编译

要为其他平台创建映像

• 下载该平台的 JDK，并将存档手动扩展到您选择的目录中。（下载 JDK 的 zip 或 tar.gz 版本，而不是安装程序，将使此操作更容易。）
• 确定外来 JDK 的平台字符串。这可以通过检查 JDK 的 jmods/java.base.jmod 文件的命令来完成

  jmod describe "$FOREIGN_JDK_HOME"/jmods/java.base.jmod | grep '^platform'
  

• 使用外来 JDK 的平台字符串创建您的 jmod

  <jmod destfile="MyApp.jmod" classpath="build/myapp.jar" platform="windows-amd64"/>
  

• 使用外来 JDK 的 jmods 目录在模块路径中进行链接

  <link destDir="build/image"
        modulepath="MyApp.jmod;${foreign-jdk-home}/jmods"
        modules="com.example.myapp"/>