class - 在 ant 脚本中包含作为类文件分发的库

Question

我目前正在尝试使用 ant 编译一个项目，该项目使用许多作为 .class 文件分发的外部库(特别是 apache.hwpf 和 JDom2)。

我目前正在使用 eclipse 来编辑和构建项目，但我想切换到使用 ant 文件，因为它应该更容易维护(不需要特定版本的 eclipse)，并且更容易构建(只需运行“ant build”或其他东西。

问题是，我不确定应该将库包含在 ant 文件中的何处。我当前的 ant 文件(见下文)总是在 javac 阶段失败，所以我认为它应该在那里。这通常是因为它找不到像“Element”这样的东西，它是 JDom2 库定义的类。

有人可以解释一下我应该在哪里导入它以及如何导入它。

(编辑:作为附录，我想要获得的功能类似于在 Eclipse 中的项目属性中的构建路径的库选项卡下添加类文件夹。这当前适用于构建我的项目，但我会如果可能的话，希望远离 Eclipse。)

(编辑:进一步说明；我在 Eclipse 中通过执行“项目”->“属性”->“Java 构建路径”->“库”->“添加类文件夹”来执行什么操作，我希望能够使用 ant 执行此操作。)

到目前为止我的 ant 脚本是:

<project>
    <property name="src.dir" value="src"/>
    <property name="lib.dir" value="lib"/>
    <property name="build.dir" value="build"/>
    <property name="classes.dir" value="${build.dir}/classes"/>
    <property name="jar.dir" value="${build.dir}/jar"/>
    <property name="main-class" value="ba_cc.Main"/>

    <target name="clean">
        <delete dir="${build.dir}"/>
    </target>

    <target name="compile">
        <mkdir dir="${classes.dir}"/>
        <javac srcdir="${src.dir}" destdir="${classes.dir}"/>
    </target>

    <target name="jar">
        <mkdir dir="${jar.dir}"/>
        <jar destfile="${jar.dir}/Change_Checker.jar" basedir="${classes.dir}">
            <manifest>
                <attribute name="Main-Class" value="${main-class}"/>
            </manifest>
        </jar>
    </target>

    <target name="run">
        <java jar="${jar.dir}/Change_Checker.jar" fork="true"/>
    </target>

    <target name="clean-build" depends="clean,compile,jar"/>

    <target name="main" depends="clean,run"/>
</project>

Answer 1

ant 构建中的 javac 任务根本没有引用您的第三方类。为了解决这个问题，您需要在类路径中专门引用它们。处理此问题的最佳方法是设置一个 project.class.path 属性，并使用 classpath 或 classpathref 属性引用该属性javac 任务。

这是一个示例project.class.path。我假设 lib.dir 将包含您的第三方 jar 或类:

<path id="project.class.path">
  <fileset dir="${lib.dir}"/>
  <pathelement location="${src.dir}"/>
  <pathelement location="${classes.dir}"/>
</path>

或者，您可以专门使用更多 pathelement 属性来提供单独的 jar 文件:

<path id="project.class.path">
  <pathelement location="${lib.dir}/JDom2.jar"/>
  <pathelement location="${lib.dir}/AnotherSupportLibrary.jar"/>
  ...

现在，在您的编译任务中:

<target name="compile">
    <mkdir dir="${classes.dir}"/>
    <javac srcdir="${src.dir}" destdir="${classes.dir}"
           classpath="${project.class.path}"/>
</target>

现在，您还需要将第三方库包含在您构建的 jar 中。 jar 任务可以将支持 jar 的内容合并到正在构建的 jar 中，请参阅 documentation for the jar task 中合并存档下的描述。 .

此外，您还应该阅读文档并仔细查看示例以查找 javac task并查看 Writing a Simple Buildfile ，最后要设置更复杂的类路径，请查看 Directory-based Tasks 的文档.