リンク

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"/>

同じことですが、ネストされたランチャー要素を使用します

<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"/>