套用

名稱 execon 已不建議使用，僅保留以維持向後相容性。

說明

執行系統命令。當指定 os 屬性時，命令僅在 Apache Ant 在其中一個指定作業系統上執行時才會執行。

多個 資源集合 的檔案和/或目錄（包括但不限於 檔案集、目錄集（自 Ant 1.6 起）或 檔案清單（自 Ant 1.6 起））作為引數傳遞給系統命令。

如果您指定巢狀 對應器，每個來源檔案的時間戳記會與目標檔案的時間戳記進行比較，目標檔案由巢狀 mapper 元素定義，並在指定的 dest 中搜尋（如果已指定）。

至少需要一個 fileset 或 filelist，且不得指定多個 mapper。

請注意，您無法與分岔程式互動，唯一可以傳送輸入的方式是透過 input 和 inputstring 屬性。

在類 Unix 系統上以背景程序執行 Ant

如果您以背景程序執行 Ant（例如 ant &），並使用 spawn 設定為 false 的 <apply> 任務，您必須提供明確的輸入給分岔程序，否則 Ant 會暫停，因為它會嘗試從標準輸入讀取。

參數

以嵌套元素指定的參數

fileset

您可以使用任意數量的嵌套 <fileset> 元素來定義此任務的檔案，並參考在其他地方定義的 <fileset>。

filelist

自 Ant 1.6 起

您可以使用任意數量的嵌套 <filelist> 元素來定義此任務的檔案，並參考在其他地方定義的 <filelist>。

dirset

自 Ant 1.6 起

您可以使用任意數量的嵌套 <dirset> 元素來定義此任務的目錄，並參考在其他地方定義的 <dirset>。

任何其他 資源集合

自 Ant 1.7 起

您可以使用任意數量的嵌套資源集合。

mapper

單一 <mapper> 指定相對於 dest 屬性的目標檔案，以進行相依性檢查。如果指定 dest 屬性，它將用作解析由對應器傳回的相對路徑名稱的基本目錄。至少需要一個 <fileset> 或 <filelist>。

arg

命令列引數應指定為嵌套 <arg> 元素。請參閱 命令列引數。

srcfile

預設情況下，來源檔案的檔案名稱將新增至命令列的結尾（除非您將 addsourcefile 設定為 false）。如果您需要將其放在其他位置，請在 <arg> 元素之間使用嵌套 <srcfile> 元素來標記插入點。

目標檔案

<targetfile> 類似於 <srcfile>，並標示命令列上目標檔名的位置。如果省略，目標檔名將不會新增到命令列中。只有在您也定義巢狀映射器時，才能指定此元素。

環境

可以透過巢狀 <env> 元素指定要傳遞給系統命令的環境變數。請參閱 exec 部分中的說明

重新導向器

可以指定巢狀 I/O 重新導向器。<apply> 的行為類似於 exec 在重新導向器方面的行為，但例外的是，在非 parallel 模式中，檔案對應會在每次反覆運算時執行。這讓使用者能夠針對每個來源檔案接收輸入和傳送輸出到不同的檔案。

在 parallel 模式中，重新導向器將針對每批執行 (其中 maxparallel > 0) 重設，且 null 將用作來源檔案，就像在 exec 的情況一樣。

範例

呼叫 ls -l，將所有檔案的絕對檔名新增到 /tmp 下方，結尾不是 .txt，以及所有具有 id other.files 的 FileSet 檔案新增到命令列。

<apply executable="ls">
  <arg value="-l"/>
  <fileset dir="/tmp">
    <patternset>
      <exclude name="**/*.txt"/>
    </patternset>
  </fileset>
  <fileset refid="other.files"/>
</apply>

針對 /tmp 中的每個檔案呼叫 somecommand arg1 SOURCEFILENAME arg2，將 SOURCEFILENAME 取代為每個檔案的絕對檔名。如果 parallel 已設定為 true，SOURCEFILENAME 將會取而代之為所有檔案的絕對檔名，並以空白分隔。

<apply executable="somecommand" parallel="false">
  <arg value="arg1"/>
  <srcfile/>
  <arg value="arg2"/>
  <fileset dir="/tmp"/>
</apply>

針對每個比對應 .o 更新的 .c 檔案呼叫 cc -c -o TARGETFILE SOURCEFILE，將 TARGETFILE 取代為 .o 的絕對檔名，並將 SOURCEFILE 取代為 .c 檔案的絕對名稱。

<apply executable="cc" dest="src/C" parallel="false">
  <arg value="-c"/>
  <arg value="-o"/>
  <targetfile/>
  <srcfile/>
  <fileset dir="src/C" includes="*.c"/>
  <mapper type="glob" from="*.c" to="*.o"/>
</apply>

將虛構的 processfile 可執行檔套用至 src 目錄中所有符合 *.file 的檔案。<mapper> 的 out 已設定為將 *.file 對應到 *.out，然後此 <mapper> 用於指定此 <apply> 任務的 targetfile。然後，對 out 的參考用作巢狀於 <redirector> 中的 <outputmapper>，而 <redirector> 又巢狀於此 <apply> 執行個體下方。這讓我們能夠針對輸出檔案執行相依性檢查，在本例中為目標檔案。

<mapper id="out" type="glob"
           from="src${file.separator}*.file"
           to="dest${file.separator}*.out"/>

<apply executable="processfile" dest="dest">
  <fileset dir="src" includes="*.file"/>
  <mapper refid="out"/>
  <redirector>
    <outputmapper refid="out"/>
  </redirector>
</apply>

將 ls 可執行檔套用至 PATH 中的所有目錄，有效列出 PATH 中可用的所有可執行檔。

<apply executable="ls" parallel="true"
       force="true" dest="${basedir}" append="true" type="both">
  <path>
    <pathelement path="${env.PATH}"/>
  </path>
  <identitymapper/>
</apply>

使用命令 jsmin < src/a.js > dest/a.js 轉換 src 目錄中的所有 JavaScript 檔案。由於檔案名稱本身不應傳遞給 jsmin 程式，因此 addsourcefile 設為 false。

<apply executable="jsmin" addsourcefile="false">
    <!-- Collect the JS-files -->
    <fileset dir="src" includes="*.js"/>
    <redirector>
        <!-- redirect STDIN; fileset collects relative to its dir, but we need -->
        <!-- relative to basedir -->
        <inputmapper type="glob" from="*" to="src/*"/>
        <!-- redirect STDOUT to file in dest-dir -->
        <outputmapper id="out" type="glob" from="*.js" to="dest/*.js"/>
    </redirector>
</apply>