ant javadoc does not build

Question

这是我第一个部署ant的java项目。我必须尽快提交我的代码，没有时间为 Ant 做 Hello World 之类的事情。在做了一些谷歌之后.xml我试图为我的项目做一个构建，但现在我被卡住了！

蚂蚁javadoc对我不起作用。下面是它在给定命令时显示的错误：ant javadoc -debug

Attempting to create object of type org.apache.tools.ant.helper.DefaultExecutor
Adding reference: ant.executor
BUILD FAILED
Target "javadoc" does not exist in the project "Ant-Test".
    at org.apache.tools.ant.Project.tsort(Project.java:1912)
    at org.apache.tools.ant.Project.topoSort(Project.java:1820)
    at org.apache.tools.ant.Project.topoSort(Project.java:1783)
    at org.apache.tools.ant.Project.executeTarget(Project.java:1368)
    at org.apache.tools.ant.helper.DefaultExecutor.executeTargets(DefaultExe
cutor.java:41)
    at org.apache.tools.ant.Project.executeTargets(Project.java:1251)
    at org.apache.tools.ant.Main.runBuild(Main.java:811)
    at org.apache.tools.ant.Main.startAnt(Main.java:217)
    at org.apache.tools.ant.launch.Launcher.run(Launcher.java:280)
    at org.apache.tools.ant.launch.Launcher.main(Launcher.java:109)
Total time: 0 seconds

我创建所有四个类的包

package org.acrusys.customers;

最后但并非最不重要的是目录结构

Directory of C:UsersSalmanJavaWorkspaceArcusyssrcorgacrusyscustomers
04/11/2012  07:40 PM    <DIR>          .
04/11/2012  07:40 PM    <DIR>          ..
04/11/2012  06:20 PM               757 AllCustomers.class 
04/11/2012  12:22 PM               520 AllCustomers.java
04/11/2012  07:40 PM    <DIR>          build
04/11/2012  07:30 PM             1,746 build.xml
04/11/2012  03:09 PM    <DIR>          classes
04/11/2012  06:20 PM             1,470 Customer.class
04/11/2012  05:27 PM             1,456 Customer.java
04/11/2012  06:20 PM             1,396 CustomerFullAddress.class
04/10/2012  11:55 PM             1,343 CustomerFullAddress.java
04/11/2012  06:20 PM             2,890 CustomerMain.class
04/11/2012  06:19 PM             2,392 CustomerMain.java
04/11/2012  07:40 PM    <DIR>          dist
04/11/2012  07:40 PM    <DIR>          docs
04/11/2012  06:55 PM    <DIR>          src

这是Javadoc（我最初忘记粘贴它）

<target name="docs" depends="compile">
<javadoc packagenames="org.acrusys.customers.*" sourcepath="${src.dir}"    destdir="${docs.dir}">
<!-- Define which files / directory should get included, we include all -->
<fileset dir="${src.dir}">
<include name="**" />
</fileset>
</javadoc>
</target>

Answer 1

Javadoc通常与你以注释的形式写入代码中的文档相关联，并自动提取到HTML文件中。

尝试跑步：蚂蚁罐

在构建文件中指定的目标是"jar"。 这不会解决您的所有问题，因为我看不到您的编译目标。 似乎您的源代码在错误的位置（它应该位于 src 目录中，在正确的包结构下），并且构建的.class文件也没有最终出现在构建目录中。

Answer 2

你在做什么：

$ ant javadoc

或

$ ant docs

您的目标名称是docs而不是javadoc。你应该做后者。

Answer 3

这段代码对我有用。我在这里只给出您需要使用此目标的目标。

<target name="docs" depends="compile">
    <javadoc packagenames="src" sourcepath="${src.dir}" destdir="${docs.dir}">
      <!-- Define which files / directory should get included, we include all -->
       <fileset dir="${src.dir}">
                <include name="**" />
           </fileset>
    </javadoc>
  </target>

运行此目标后，您将把所有文档放入文档文件夹中。