<jar>
SYNOPSIS
| destfile*="ファイル名" |
| basedir="ディレクトリ名" |
| compress="true|false" |
| keepcompression="true|false" |
| encoding="UTF-8|文字エンコーディング" |
| filesonly="true|false" |
| includes="ファイル名リスト|全ファイル" |
| includesfile="ファイル名" |
| excludes="ファイル名リスト|全ファイル" |
| excludesfile="ファイル名" |
| defaultexcludes="true|false" |
| manifest="ファイル名" |
| filesetmanifest="skip|marge|mergewithoutmain" |
| update="true|false" |
| whenmanifestonly="create|skip|fail" |
| duplicate="add|preserve|fail" |
| index="true|false" |
| manifestencoding="文字エンコーディング" |
| roundup="true|false" |
| level="0|1|2|3|4|5|6|7|8|9" |
| <fileset> * | - | JAR ファイルに格納するファイルパターン. |
| <zipfileset> * | - | 別の ZIP または JAR ファイルに格納されているファイルをこの JAR ファイルに 取り込む場合に使用します. |
| <metainf> ? | - | 内包するファイルセットをメタ情報として JAR の META-INF/ ディレクトリに 格納します. |
| <manifest> | - | このビルドファイル内で JAR のマニフェストを定義します. |
| <indexjars> | - | index 属性が true でない場合は無視されます. |
| <service> | - | サービスプロバイダを定義します. |
| ※Ant は自由度が高いため、このタスクでよく使用される要素のみ説明しています. | ||
説 明
JAR ファイルを作成または更新するタスクです。
JAR のマニフェストはファイルとして存在するものを指定するか、このタスク内で 定義することが出来ます。どちらも指定されていない場合はデフォルトの簡単な マニフェストファイルが追加されます。
格納するファイルのパーミッションは JAR には取り込まれません。パーミッションを
指定する場合は <zipfileset> の filemode 属性を使用して
ください。
<manifest> JARファイル仕様 属 性
<fileset> を使用します。
zipfilesets や既存 JAR へなど) に対して、
compression 属性を無視して圧縮状態を維持するかどうかを指定します。
アーカイブに格納するファイル名のエンコーディング。省略時は Java 標準の UTF-8 で ファイル名を格納します。
この属性は、作成した JAR ファイルを通常の ZIP ファイルとして unzip コマンド
などの ZIP ユーティリティで使用する時に使用します。一般的にこれらのユーティリティは
実行環境用に作成されており、実行環境の文字エンコーディングでしか ZIP 内のファイルを
正しく取り出せません。
この属性は ZIP ファイル内のファイル割り当てテーブルエントリのエンコーディングを指定します。 格納するファイルの内容のエンコーディングを指定するものではありません。
JAR に格納するマニフェストファイル。実際に存在するマニフェストファイル名か、
または格納対象の JAR ファイルを <fileset> で指定しているなら
その JAR ファイル名のどちらでも指定できます。格納対象の JAR を指定した場合、
その JAR には META-INF/MANIFEST.MF が格納されている必要があります。
値を省略した場合、jar タスク内に定義された <manifest> に基づいて
マニフェストファイルを生成します。<manifest> も省略されている場合は
デフォルトのマニフェストが自動生成されます。
zipfileset で見つかったか、または zipgroupfileset
ファイルが見つかった時の挙動を指定します。skip, marge, mergewithoutmain
のいずれかを指定することが出来ます。
内 容
basedir 属性の代わりに使用します。
META-INF/ ディレクトリに
格納します。ファイルセットに MANIFEST.MF というファイルが含まれている
場合は警告を出して無視します。
<manifest>
の file および mode 属性は無視されます。
使用例
./classes 以下の全てのファイルから myprogram.jar を作成します。
<jar basedir="./classes" jarfile="myprogram.jar" />
./classes 以下から特定のファイルのみを除外して JAR ファイルを作成します。
<jar basedir="./classes"
excludes="**/package.html,**/Thumbs.db,**/*Test.class"
jarfile="myprogram.jar" />
<jar basedir="./classes" jarfile="myprogram.jar">
<manifest>
<attribute name="Main-Class" value="biz.moyo.lab.Sample"/>
</manifest>
</jar>
<jar basedir="./classes"
jarfile="myprogram.jar" manifest="./mymanifest.mf" />
<jar jarfile="myprogram.jar">
<fileset dir="./classes" />
<fileset dir="./build/classes" />
</jar>
