使用 ant javac 适配器

通过使用 javac 适配器,可以在 Ant 构建文件中使用 Eclipse 编译器。为了使用 Eclipse 编译器,只需在构建文件中定义 build.compiler 属性。

为了让批处理编译器在 Ant 构建文件中工作,Ant 运行时类路径必须包含 Eclipse 批处理编译器。在运行 Ant 构建文件时:

  1. 在 Eclipse 外部:最简单的方法是设置 Ant 运行时类路径以使用 -lib 参数添加 ecj.jar 文件或者将其转储到 ANT_HOME 位置。
  2. 在 Eclipse 内部,使用与 Eclipse 相同的 JRE:隐式地将 Eclipse 批处理编译器添加到 Ant 运行时类路径中。
  3. 在 Eclipse 内部,使用另一个 JRE:必须显式地将 Eclipse 批处理编译器添加到 Ant 运行时类路径。这可以使用 ecj.jar 文件实现,也可以使用 JAR 文件 org.eclipse.jdt.core 和 org.eclipse.jdt.core 中的 jdtCompilerAdapter.jar 文件实现(首先需要将这个 JAR 文件解压缩)。

以下是一个简单示例:


<?xml version="1.0" encoding="UTF-8"?>
<project name="compile" default="main" basedir="../.">

 <property name="build.compiler" value="org.eclipse.jdt.core.JDTCompilerAdapter"/>

 <property name="root" value="${basedir}/src"/>

 <property name="destdir" value="d:/temp/bin" />

 <target name="main">
  <javac srcdir="${root}" destdir="${destdir}" debug="on" nowarn="on" extdirs="d:/extdirs" source="1.4">
      <classpath>
        <pathelement location="${basedir}/../org.eclipse.jdt.core/bin"/>

      </classpath>
  </javac>
 </target>
</project>

可以在 Ant javac 任务文档中找到用于 javac Ant 任务的语法。当前适配器支持 Javac Ant 任务 1.4.1 到 1.6.5 版本。

如果您使用的是 1.5.0 以上的版本,那么可以使用嵌套的编译器参数元素 (<compilerarg>) 来指定特定于编译器的选项。


...
<javac srcdir="${root}" destdir="${destdir}" debug="on" nowarn="on" extdirs="d:/extdirs" source="1.4">
    <classpath>
      <pathelement location="${basedir}/../org.eclipse.jdt.core/bin"/>
    </classpath>

    <compilerarg compiler="org.eclipse.jdt.core.JDTCompilerAdapter" line="-1.5 -warn:+boxing"/>
</javac>
...

注意:
  1. 为了防止使用编译器的从属构建文件,强烈建议您使用 <compilerarg>,其“compiler”属性值为 org.eclipse.jdt.core.JDTCompilerAdapter。如果未设置此参数,那么该构建文件只能与 Eclipse 编译器配合使用。如果设置了该参数,并且名称与属性 build.compiler 指定的编译器名不同,那么将忽略嵌套的编译器参数。
  2. 不应使用 <compilerarg> 来设置诸如下面这些值:目标值、源值、调试选项或者可以使用已为 javac Ant 任务定义的属性来设置的任何选项。必须将它用来传递特定于编译器的选项(例如,警告选项)。如果多次指定了一个命令行参数,那么 Eclipse 批处理编译器可能会报告如下所示的错误:
    目标一致性设置规范 1.5 重复