应用

名称 execon 已弃用，仅保留以提供向后兼容性。

描述

执行系统命令。当指定了 os 属性时，该命令仅在 Apache Ant 在指定的操作系统之一上运行时执行。

多个 资源集合（包括但不限于 FileSet、DirSet（自 Ant 1.6 起）或 FileList（自 Ant 1.6 起））的文件和/或目录作为参数传递给系统命令。

如果指定了嵌套的 mapper，则会将每个源文件的日期戳与由嵌套的 mapper 元素定义的目标文件的日期戳进行比较，并在指定的 dest 中搜索目标文件。

至少需要一个 fileset 或 filelist，并且您不能指定多个 mapper。

请注意，您无法与分叉的程序进行交互，向其发送输入的唯一方法是通过 input 和 inputstring 属性。

在 Unix（类 Unix）系统上将 Ant 作为后台进程运行

如果将 Ant 作为后台进程运行（例如 ant &）并使用 <apply> 任务并将 spawn 设置为 false，则必须向分叉的进程提供显式输入，否则 Ant 将被挂起，因为它会尝试从标准输入读取。

参数

作为嵌套元素指定的参数

fileset

您可以使用任意数量的嵌套 <fileset> 元素来定义此任务的文件，并引用在其他地方定义的 <fileset>。

filelist

自 Ant 1.6 起

您可以使用任意数量的嵌套 <filelist> 元素来定义此任务的文件，并引用在其他地方定义的 <filelist>。

dirset

自 Ant 1.6 起

您可以使用任意数量的嵌套 <dirset> 元素来定义此任务的目录，并引用在其他地方定义的 <dirset>。

任何其他 资源集合

自 Ant 1.7 起

您可以使用任意数量的嵌套资源集合。

mapper

单个 <mapper> 指定相对于 dest 属性的依赖项检查的目标文件。如果指定了 dest 属性，它将用作解析 mapper 返回的相对路径名的基本目录。至少需要一个 <fileset> 或 <filelist>。

arg

命令行参数应指定为嵌套的 <arg> 元素。请参阅 命令行参数。

srcfile

默认情况下，源文件的文件名将添加到命令行的末尾（除非您将 addsourcefile 设置为 false）。如果您需要将其放置在其他位置，请在 <arg> 元素之间使用嵌套的 <srcfile> 元素来标记插入点。

targetfile

<targetfile> 与 <srcfile> 类似，并标记命令行上目标文件名的位置。如果省略，则目标文件名将根本不会添加到命令行中。仅当您还定义了嵌套的 mapper 时，才能指定此元素。

env

可以通过嵌套的 <env> 元素指定要传递给系统命令的环境变量。请参阅有关 exec 的部分中的描述

redirector

可以指定嵌套的 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> 被设置为将 *.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>