適用

名前execonは非推奨であり、下位互換性のためにのみ残されています。

説明

システムコマンドを実行します。os属性が指定されている場合、コマンドは、指定されたオペレーティングシステムのいずれかでApache Antが実行された場合にのみ実行されます。

リソースコレクション（FileSet、DirSet（Ant 1.6以降）、FileList（Ant 1.6以降）など、これらに限定されません）の複数のファイルやディレクトリは、システムコマンドの引数として渡されます。

ネストされたmapperを指定した場合、各ソースファイルのタイムスタンプは、ネストされたmapper要素によって定義され、指定されたdest内にあるターゲットファイルのタイムスタンプと比較されます。

少なくとも1つのfilesetまたはfilelistが必要です。また、mapperは1つ以上指定できません。

フォークされたプログラムとやり取りすることはできません。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属性が指定されている場合、mapperによって返される相対パスの解決のためのベースディレクトリとして使用されます。少なくとも1つの<fileset>または<filelist>が必要です。

arg

コマンドライン引数は、ネストされた<arg>要素として指定する必要があります。コマンドライン引数を参照してください。

srcfile

デフォルトでは、ソースファイルのファイル名はコマンドラインの最後に追加されます（addsourcefileをfalseに設定しない限り）。別の場所に配置する必要がある場合は、<arg>要素間にネストされた<srcfile>要素を使用して挿入点をマークします。

targetfile

<targetfile>は<srcfile>と似ており、コマンドライン上のターゲットファイル名の位置を示します。省略した場合、ターゲットファイル名はコマンドラインに追加されません。この要素は、ネストされたマッパーも定義した場合にのみ指定できます。

env

ネストされた<env>要素を使用して、システムコマンドに渡す環境変数を指定できます。execに関するセクションの説明を参照してください。

リダイレクタ

ネストされたI/Oリダイレクタを指定できます。<apply>の動作は、リダイレクタに関する限りexecと同様ですが、非parallelモードでは、各反復でファイルマッピングが行われます。これにより、ユーザーは各ソースファイルに対して異なるファイルから入力を受け取り、異なるファイルに出力することができます。

parallelモードでは、リダイレクタは各実行バッチ（maxparallel > 0）でリセットされ、execの場合と同様に、ソースファイルにはnullが使用されます。

例

/tmp以下の.txtで終わらないすべてのファイルと、idがother.filesのFileSetのすべてのファイルの絶対ファイル名をコマンドラインに追加して、ls -lを実行します。

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

/tmp内の各ファイルに対して、SOURCEFILENAMEを各ファイルの絶対ファイル名に順次置き換えて、somecommand arg1 SOURCEFILENAME arg2を実行します。parallelがtrueに設定されていた場合、SOURCEFILENAMEはスペースで区切られたすべてのファイルの絶対ファイル名に置き換えられます。

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

対応する.oより新しい.cファイルごとに、TARGETFILEを.oの絶対ファイル名に、SOURCEFILEを.cファイルの絶対名に置き換えて、cc -c -o TARGETFILE SOURCEFILEを実行します。

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

srcディレクトリの*.fileに一致するすべてのファイルに、架空の実行可能ファイルprocessfileを適用します。out<mapper>は*.fileを*.outにマッピングするように設定されており、この<mapper>を使用してこの<apply>タスクのtargetfileを指定します。次に、outへの参照を、<redirector>にネストされた<outputmapper>として使用します。これは、この<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>

PATH内のすべてのディレクトリにls実行可能ファイルを適用し、PATHで使用可能なすべての実行可能ファイルを効果的に一覧表示します。

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

srcディレクトリ内のすべてのJavaScriptファイルをjsmin < src/a.js > dest/a.jsコマンドを使用して変換します。ファイル名自体は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>