Javac

說明

編譯 Java 原始碼樹。

原始碼和目標目錄將會遞迴掃描 Java 原始碼檔案以進行編譯。只有沒有對應的 .class 檔案或 .class 檔案比 .java 檔案舊的 .java 檔案才會被編譯。

注意：Apache Ant 僅使用原始碼和類別檔案的名稱來尋找需要重新建置的類別。它不會掃描原始碼，因此不會知道巢狀類別、名稱與原始碼檔案不同的類別等。請參閱 <depend> 任務，以取得基於其他而非僅存在/修改時間的相依性檢查。

當原始碼檔案是套件的一部分時，原始碼樹的目錄結構應遵循套件階層。

可以精簡要編譯的檔案組。這可以使用 includes、includesfile、excludes 和 excludesfile 屬性來完成。使用 includes 或 includesfile 屬性，您可以指定要包含的檔案。exclude 或 excludesfile 屬性用於指定要排除的檔案。在兩種情況下，檔案清單都可以透過檔案名稱（相對於 srcdir 屬性或巢狀 <src> 元素中指定的目錄）或使用萬用字元模式來指定。請參閱 基於目錄的任務 部分，以取得有關如何包含/排除檔案以及如何撰寫萬用字元模式的資訊。

可以使用不同的編譯器。這可以透過設定全域性 build.compiler 屬性（這會影響建置中的所有 <javac> 任務）、設定特定於目前的 <javac> 任務的 compiler 屬性，或使用任何 typedef 或 componentdef 輸入類型（實作 org.apache.tools.ant.taskdefs.compilers.CompilerAdapter）的巢狀元素來指定。build.compiler 屬性或 compiler 屬性的有效值為

• classic（JDK 1.1/1.2 的標準編譯器）– javac1.1 和 javac1.2 可用作別名。
• modern（JDK 1.3 和更高版本的標準編譯器）– javac1.3、javac1.4、javac1.5、javac1.6、javac1.7（自 Ant 1.8.2 起）、javac1.8（自 Ant 1.8.3 起）、javac1.9（自 Ant 1.9.5 起）、javac9（自 Ant 1.9.8 起）和 javac10+（自 Ant 1.10.2 起）可用作別名。
• jikes（Jikes 編譯器）。
• jvc（Microsoft 的 Java/Visual J++ SDK 中的命令列編譯器）– microsoft 可用作別名。
• kjc（kopi 編譯器）。
• gcj（GCC 中的 gcj 編譯器）。
• sj (Symantec Java 編譯器) – symantec 可用作別名。
• extJavac (在自己的 JVM 中執行新式或舊式編譯器)。

預設值為 javacX，其中 X 取決於執行 Ant 時所使用的 JDK 版本。如果您希望使用提供的編譯器介面以外的介面，您可以撰寫一個實作 CompilerAdapter 介面的類別 (套件 org.apache.tools.ant.taskdefs.compilers)。在 build.compiler 屬性或 compiler 屬性中提供完整的類別名稱。

fork 屬性會覆寫 build.compiler 屬性或 compiler 屬性設定，並預期在 JAVA_HOME 中設定 JDK 1.1 或更高版本。

您也可以使用 compiler 屬性來告訴 Ant 在組合命令列開關時應該假設哪個 JDK 版本，即使您設定 fork=true。如果您要在目前的 JDK 為 1.2+ 時執行 JDK 1.1 的編譯器，這會很有用。如果您使用 compiler=javac1.1 且 (例如) depend=true，Ant 會使用命令列開關 -depend，而不是 -Xdepend。

此任務會從傳遞給編譯器的類別路徑中移除指向不存在檔案/目錄的所有項目。

分岔執行檔 (如果有) 的工作目錄是專案的基本目錄。

Windows 注意事項：當新式編譯器在 Windows 上以非分岔模式使用時，它會鎖定存在於 <javac> 任務類別路徑中的檔案，且不會釋放它們。這會導致的副作用是您無法在稍後的建置中刪除或移動這些檔案。解決方法是在呼叫編譯器時分岔執行。

如果您的來源包含使用 @Native 註解註解的原生方法或欄位，您可以設定 nativeheaderdir 屬性，以便使用 javac 的 -h 開關來產生原生標頭檔。請注意，Ant 用來判斷要編譯哪些檔案的邏輯不會考量原生標頭，也就是說，如果 .class 比對應的 .java 檔案新，則即使為其產生的原生標頭檔已過時，檔案也不會被編譯。

參數

以巢狀元素指定的參數

此任務形成一個隱含的 FileSet，並支援大多數 <fileset> 的屬性（dir 變成 srcdir），以及巢狀的 <include>、<exclude> 和 <patternset> 元素。

srcdir、classpath、sourcepath、bootclasspath、modulepath、modulesourcepath、upgrademodulepath 和 extdirs

<javac> 的 srcdir、classpath、sourcepath、bootclasspath、extdirs、modulepath、modulesourcepath 和 upgrademodulepath 屬性是 類別路徑結構，也可以透過巢狀的 <src>（注意名稱不同！）、<classpath>、<sourcepath>、<bootclasspath>、<extdirs>、<modulepath>、<modulesourcepath> 和 <upgrademodulepath> 元素分別設定。

compilerarg

您可以使用巢狀的 <compilerarg> 元素，為編譯器指定額外的命令列引數。這些元素的指定方式類似於 命令列引數，但有一個額外的屬性，可用於僅在使用特定編譯器實作時啟用引數。

compilerclasspath

自 Ant 1.8.0 起

載入編譯器實作時，若已指定自訂類別，則持有要使用的類別路徑的 類別路徑結構。使用內建編譯器之一時，不會有任何影響。

實作 CompilerAdapter 型別的任何巢狀元素

自 Ant 1.8.0 起

如果已定義的型別實作 CompilerAdapter 介面，則可將該型別的巢狀元素用作 compiler 屬性的替代方案。

範例

編譯 .java 目錄下的所有檔案，並將 .class 檔案儲存在 .build 目錄中。所使用的類別路徑包含 xyz.jar，且已開啟使用偵錯資訊進行編譯。來源層級為 1.4，因此您可以使用 assert 陳述式。

<javac srcdir="${src}"
       destdir="${build}"
       classpath="xyz.jar"
       debug="on"
       source="1.4"/>

編譯 .java 目錄下的所有檔案，並將 .class 檔案儲存在 .build 目錄中。使用預設 javac 可執行檔分岔 Java 編譯器。來源層級為 1.2（類似於 1.1 或 1.3），且類別檔案也應該可以在 JDK 1.2+ 中執行。

<javac srcdir="${src}"
       destdir="${build}"
       fork="true"
       source="1.2"
       target="1.2"/>

編譯 .java 目錄下的所有檔案，並將 .class 檔案儲存在 .build 目錄中。使用名為 java$javac.exe 的可執行檔分岔 Java 編譯器。請注意，$ 符號需要用另一個符號進行跳脫。來源層級為 1.5，因此您可以使用泛型。

<javac srcdir="${src}"
       destdir="${build}"
       fork="java$$javac.exe"
       source="1.5"/>

編譯 .java 目錄下的檔案，並將 .class 檔案儲存在 ${build} 目錄中。所使用的類別路徑包含 xyz.jar，且已開啟偵錯資訊。僅使用 mypackage/p1 和 mypackage/p2 下的檔案。mypackage/p1/testpackage 目錄中及以下的所有檔案都從編譯中排除。您未指定來源或目標層級，因此實際使用的值會取決於您使用 Ant 執行 JDK。

<javac srcdir="${src}"
       destdir="${build}"
       includes="mypackage/p1/**,mypackage/p2/**"
       excludes="mypackage/p1/testpackage/**"
       classpath="xyz.jar"
       debug="on"/>

這與前一個範例相同，但增加了第二個來源路徑，由屬性 src2 定義。也可以使用巢狀 <src> 元素來表示，如下所示

<javac destdir="${build}"
       classpath="xyz.jar"
       debug="on">
  <src path="${src}"/>
  <src path="${src2}"/>
  <include name="mypackage/p1/**"/>
  <include name="mypackage/p2/**"/>
  <exclude name="mypackage/p1/testpackage/**"/>
</javac>

如果您想執行不同 JDK 的 javac 編譯器，您應該告訴 Ant 在哪裡可以找到編譯器以及您將使用哪個版本的 JDK，以便它可以選擇正確的命令列開關。下列範例在新的程序中執行 JDK 1.1 javac，並使用正確的命令列開關，即使 Ant 在不同版本的 JVM 中執行

<javac srcdir="${src}"
       destdir="${build}"
       fork="yes"
       executable="/opt/java/jdk1.1/bin/javac"
       compiler="javac1.1"/>

注意：如果您只想編譯位於共用根目錄下特定套件中的來源檔案，請使用 include/exclude 屬性或 <include>/<exclude> 內嵌元素來過濾這些套件。請勿在 srcdir 屬性（或內嵌 <src> 元素）中包含套件結構的一部分，否則每次執行編譯目標時，Ant 都會重新編譯您的來源檔案。請參閱 Ant 常見問答集 以取得更多資訊。

如果您只想編譯明確指定的檔案並停用 javac 的預設搜尋機制，則可以取消設定 sourcepath 屬性

<javac sourcepath="" srcdir="${src}"
       destdir="${build}" >
  <include name="**/*.java"/>
  <exclude name="**/Example.java"/>
</javac>

這樣，javac 將會編譯 ${src} 目錄下的所有 Java 來源檔案，但會略過範例。如果某些非範例檔案參照範例檔案，編譯器甚至會產生錯誤。

如果您想使用特殊 JDK（與 Ant 目前使用的 JDK 不同）編譯，請設定 executable 和 fork 屬性。使用 taskname 可以顯示在記錄中，這些設定是固定的。

<javac srcdir=""
       destdir=""
       executable="path-to-java14-home/bin/javac"
       fork="true"
       taskname="javac1.4"/>

如果您想啟用其他編譯器選項，例如 lint，您可以使用 <compilerarg> 元素

<javac srcdir="${src.dir}"
       destdir="${classes.dir}"
       classpathref="libraries">
  <compilerarg value="-Xlint"/>
</javac>

如果您想使用自訂 CompilerAdapter org.example.MyAdapter，您可以使用 compiler 屬性

<javac srcdir="${src.dir}"
       destdir="${classes.dir}"
       compiler="org.example.MyAdapter"/>

或定義一個類型並將其內嵌到任務中，如下所示

<componentdef classname="org.example.MyAdapter"
              name="myadapter"/>
<javac srcdir="${src.dir}"
       destdir="${classes.dir}">
  <myadapter/>
</javac>

在這種情況下，您的編譯器適配器可以支援自己的屬性和內嵌元素。

下列範例示範如何使用 Java 9+ 模組。

在 ${src} 目錄下的單一模組中編譯所有 .java 檔案，並將 .class 檔案儲存在 ${build} 目錄中。編譯使用位於 modules 資料夾中的應用程式模組。來源層級為 9 以啟用模組。

<javac srcdir="${src}"
       destdir="${build}"
       includeantruntime="false"
       modulepath="modules"
       source="9"/>

編譯 .java 檔案在 gen/classes，lin32/classes 和 lin64/classes 在 ${src} 目錄下的所有原始碼模組。在 ${build} 目錄產生模組目錄。每個在 ${build} 目錄下產生的模組目錄包含 .class 檔案從對應的原始碼模組。* 是代表編譯模組集中任何模組名稱的代碼。{ ... , ... } 表示擴充的替代。編譯使用位於 modules 資料夾的應用程式模組。原始碼層級是 9 以啟用模組。

<javac modulesourcepath="${src}/*/{gen,lin{32,64}}/classes"
       destdir="${build}"
       includeantruntime="false"
       modulepath="modules"
       source="9"/>

Jikes 筆記

你需要 Jikes 1.15 或更新版本。

Jikes 支援一些額外的選項，可以在呼叫任務之前定義顯示在下面的屬性來設定。每個屬性的設定會在整個建置中對所有 <javac> 任務生效。Ant 開發人員知道這很醜陋而且不靈活 – 預期未來會有更好的解決方案。所有選項都是布林值，而且必須設定為 true 或 yes 才能解釋為除了 false 之外的任何東西。預設值，build.compiler.warnings 是 true，而其他都是 false。

Jvc 筆記

Jvc 會啟用 Microsoft 擴充，除非你在呼叫 <javac> 之前將屬性 build.compiler.jvc.extensions 設定為 false。

Bootstrap 選項

Sun javac 編譯器有一個 -bootclasspath 命令列選項—這對應到 <javac> 任務的 bootclasspath 屬性/元素。Sun 編譯器也允許使用 -X 和 -J-X 屬性對引導類別路徑進行更多控制。可以透過使用 <compilerarg> 來設定這些。自 Ant 1.6.0 起，有一個捷徑可以將路徑參照轉換成字串，可以在作業系統獨立的方式中使用（請參閱 pathshortcut）。例如

<path id="lib.path.ref">
  <fileset dir="lib" includes="*.jar"/>
</path>
<javac srcdir="src" destdir="classes">
  <compilerarg arg="-Xbootclasspath/p:${toString:lib.path.ref}"/>
</javac>

OpenJDK 筆記

javac 編譯器 由 OpenJDK 專案提供，是一個開源專案。此專案的輸出為包含 javac 編譯器的 javac.jar。此編譯器可用於 <javac> 任務，並搭配 -Xbootclasspath/p Java 參數使用。參數必須提供給 javac 可執行檔的執行時期系統，因此需要加上 -J 前綴，例如

<property name="patched.javac.jar"
          location="${my.patched.compiler}/dist/lib/javac.jar"/>

<presetdef name="patched.javac">
  <javac fork="yes">
    <compilerarg value="-J-Xbootclasspath/p:${patched.javac.jar}"/>
  </javac>
</presetdef>


<patched.javac srcdir="src/java" destdir="build/classes"
               debug="yes"/>

package-info.java 注意事項

package-info.java 檔案在 Java 5 中引入，用於允許套件層級註解。在編譯時，如果 .java 檔案不包含執行時期註解，則不會有對應的 .class 檔案。在 Ant 1.7.1 之前，當 <javac> 任務再次執行時，任務會嘗試再次編譯 package-info.java 檔案。

在 Ant 1.7.1 中，引入了不同的邏輯，其中涉及通常會包含 .class 檔案的目錄的時間戳記。此邏輯導致 Ant 在某些設定中無法重新編譯 package-info.java。

自 Ant 1.8.0 起，如果 Ant 編譯 package-info.java，且編譯器本身未建立 package-info.class 檔案，則會建立「空的」package-info.class 檔案。