如何构建 jar 文件，以便使用该库的用户能够在 Eclipse 中看到 javadoc

Question

我正在开发一个供公司内部使用的小型库，并对其进行了大量记录。现在我正在使用以下代码构建我的 jar：

<project name="commonutils" default="compile" basedir="."> 

    <property name="src" location="src" />

    <property name="build" location="buildDirecotry" />

    <target name="compile">
        <delete file="${ant.project.name}.jar" />
        <mkdir dir="${build}"/>
        <javac srcdir="${src}" destdir="${build}" debug="on" target="1.5">
            <classpath>
                <pathelement location="lib/build/server.zip" />
                <pathelement path="${java.class.path}/"/>
            </classpath>
        </javac>
        <jar basedir="${build}" destfile="${ant.project.name}.jar" />
        <delete dir="${build}" />
    </target>

</project>

效果很好，它构建了包含所有 src 文件的 jar 文件，但是当我将 jar 文件包含在另一个项目中时，我不再有任何 javadoc 注释。使用 JDDecompiler 我看不到类文件中的注释，尽管我不确定是剥离它们的 java 编译器还是 JD。

我的问题是：如何构建 jar 文件，以便使用该库的用户能够在 Eclipse 中看到 javadoc。

Answer 1

如果您将源文件包含在 jar 中（每个类和 java 文件都在同一包目录中），它应该可以工作。

<target name="jar.noCompile.src">  
    <jar destfile="${ant.project.name}.jar">  
      <fileset dir="${build}"/>  
      <fileset dir="${src}" includes="**/*.java"/>  
    </jar>  
</target>  

Answer 2

AFAIK 文档是 Eclipse 的一项功能。您必须手动配置它。在您的构建中生成文档（通常放入“javadoc”文件夹中）并将其与 JAR 一起打包。一旦有人想要使用您的库，他/她必须进入 Java 构建路径选择库，添加您的库，单击它旁边的以打开树节点，然后双击 Javadoc 位置进行配置。