Apache Ant 任務 - JAR

描述

Jar 任務將一組檔案打包成 JAR 檔案。

屬性

序號	屬性及描述
1	Destfile 要建立的 JAR 檔案。
2	Basedir 打包檔案的目錄。
3	Compress 不僅儲存資料，還壓縮它們。除非將 keepcompression 屬性設定為 false，否則這將應用於整個歸檔檔案，而不僅僅是更新時新增的檔案。
4	Keepcompression 對於來自現有歸檔檔案（如巢狀的 zipfileset 或更新歸檔檔案時）的條目，請保持其原始壓縮方式，而不是使用 compress 屬性。
5	Encoding 用於歸檔檔案內檔名的字元編碼。
6	Filesonly 僅儲存檔案條目。
7	Include 要包含的檔案模式的逗號或空格分隔列表。
8	Includesfile 檔名。此檔案的每一行都被視為一個包含模式。
9	Excludes 要排除的檔案模式的逗號或空格分隔列表。
10	Excludesfile 檔名。此檔案的每一行都被視為一個排除模式。
11	Defaultexcludes 指示是否應使用預設排除項（yes\|no）。
12	Menifest 要使用的清單檔案。
13	Filesetmanifest 在 zipfileset 或 zipgroupfileset 檔案中找到清單檔案時的行為。有效值為 skip、merge 和 mergewithoutmain。merge 將合併所有清單，並將此合併到任何其他指定的清單中。mergewithoutmain 合併所有內容，但清單的主部分除外。
14	Whenmanifestonly 當沒有檔案匹配時的行為。有效值為 fail、skip 和 create。
15	Manifestencoding 用於讀取 JAR 清單的編碼，當指定清單檔案時。
16	Index 是否建立索引列表以加快類載入速度。除非使用巢狀的 indexjars 元素指定其他 jar，否則只有此 jar 的內容將包含在索引中。
17	indexMetaInf 是否將 META-INF 及其子項包含在索引中。如果 index 為 false，則沒有任何效果。Oracle 的 jar 實現過去會跳過 META-INF 目錄，而 Ant 遵循了該示例。Java 5 已更改了此行為。為了避免 Ant 生成的 jar 在 Java 1.4 或更早版本上出現問題，除非明確要求，否則 Ant 不會包含 META-INF。
18	Manifestencoding 用於讀取 JAR 清單的編碼，當指定清單檔案時。
19	Update 指示如果目標檔案已存在，是否更新或覆蓋它。
20	Duplicate 找到重複檔案時的行為。有效值為 add、preserve 和 fail。
21	Roundup 檔案修改時間是否將四捨五入到下一個偶數秒。
22	Level 應執行檔案壓縮的非預設級別。有效值範圍為 0（無壓縮/最快）到 9（最大壓縮/最慢）。
23	preserve0permissions 更新歸檔檔案或從其他歸檔檔案新增條目時，Ant 將假設 Unix 許可權值為 0（沒有人被允許對檔案/目錄執行任何操作）意味著許可權根本沒有儲存，而不是實際許可權，並將應用其自己的預設值。
24	useLanguageEncodingFlag 如果編碼為 UTF-8，是否設定語言編碼標誌。如果編碼不是 UTF-8，則此設定沒有任何效果。
25	createUnicodeExtraFields 是否建立 Unicode 額外欄位以在條目的元資料中第二次儲存檔名。
26	fallbacktoUTF8 如果無法使用指定的編碼對檔名進行編碼，是否使用 UTF-8 和語言編碼標誌而不是指定的編碼。
27	mergeClassPathAttributes 是否合併不同清單中找到的 Class-Path 屬性（如果合併清單）。如果為 false，則僅保留最後一個合併的清單的屬性。
28	flattenAttributes 是否將某個部分中多次出現的屬性（這隻能發生在 Class-Path 屬性中）合併到單個屬性中。
29	zip64Mode 何時對條目使用 Zip64 擴充套件。可能的值為 never、always 和 as-needed。

示例

用法

建立包含以下內容的 build.xml 檔案：

<?xml version="1.0"?>
<project name="TutorialPoint" default="info">
   <target name="info">
      <jar basedir="app" destfile="app.jar" />
      <echo>jar created.</echo>
   </target>
</project>

上述指令碼將在當前目錄中建立一個名為 myapp.ear 的 EAR 檔案。

輸出

在上述構建檔案上執行 Ant 會產生以下輸出：

F:\tutorialspoint\ant>ant
Buildfile: F:\tutorialspoint\ant\build.xml

info:
   [jar] Building jar: F:\tutorialspoint\ant\app.jar
   [echo] jar created.

BUILD SUCCESSFUL
Total time: 0 seconds

列印頁面