无法使用 Ant 编译 javadoc

Question

我正在做一个Java项目，不仅想编译整个应用程序，还想使用Apache Ant编译javadoc文档。

目前，我的 build.xml 脚本中的编译目标如下所示：

<target name="compile">
    <mkdir dir="${build.dir}"/>
    <mkdir dir="${classes.dir}"/>
    <mkdir dir="${jar.dir}"/>
    <javac includeantruntime="false" srcdir="${src.dir}" destdir="${classes.dir}" classpathref="classpath" />
    <javadoc 
      sourcefiles="${src.dir}" 
      destdir="${doc.dir}/forecast"
      classpath="classpath"
      author="true"
      version="true"
      use="true"
      windowtitle="${App-name}"
      doctitle="&lt;h1&gt;${App-name}&lt;/h1&gt;" />
  </target>

我的源文件可以在 src/com//forecast 目录中找到，并且都有标题

package com.<company_name>.forecast

但是，当我跑步时蚂蚁编译我得到以下输出：

[javadoc] Generating Javadoc
  [javadoc] Javadoc execution
  [javadoc] 1 error
  [javadoc] javadoc: error - Illegal package name: "/home/linus/fo/forecast/src/com/<company_name>/forecast"

并且没有创建Javadoc。我想我已经尝试了几乎所有可能的Javadoc属性组合，但无济于事。我错过了什么？！提前感谢，问候

莱纳斯

Answer 1

尝试使用以下命令。

javadoc -sourcepath ./src *.java -d ./docs

Answer 2

看起来包名称未正确识别。您能否尝试指定包名称参数。

更多信息可在此处获得

例：

<javadoc packagenames="com.dummy.test.*"
       sourcepath="src"
       excludepackagenames="com.dummy.test.doc-files.*"
       defaultexcludes="yes"
       destdir="docs/api"
       author="true"
       version="true"
       use="true"
       windowtitle="Test API">  </javadoc>