java - 无法使用 Ant 创建 Javadoc

Question

我正在尝试使用 Ant 构建我的项目。在创建 javadocs 时，我收到一个错误，如下所示：

如果错误在下图中没有清晰可见，请参考：

[javadoc] javadoc: error - Illegal package name: "E:\junoWrkspace\StrutsHelloWorld\src\com\igate\resources\ApplicationResources.properties"

我在 build.xml 中用于创建 javadocs 的脚本如下：

<target name="docs" depends="compile">
    <javadoc packagenames="src" sourcepath="${src.dir}" destdir="${docs.dir}">
        <fileset dir="${src.dir}">
            <include name="**" />
        </fileset>
    </javadoc>
</target>

Answer 1

我遇到了类似的问题，排除非 .java 文件（如 .properties 文件）对我有用。

<javadoc packagenames="src" sourcepath="${src.dir}" destdir="${docs.dir}">
  <fileset dir="${src.dir}">
      <include name="**/*.java" />
  </fileset>
</javadoc>

Answer 2

尝试更换

<javadoc packagenames="src" sourcepath="${src.dir}" destdir="${docs.dir}">
    <fileset dir="${src.dir}">
        <include name="**" />
    </fileset>
</javadoc>

只需

<javadoc packagenames="src" sourcepath="${src.dir}" destdir="${docs.dir}"/>

Answer 3

请阅读错误信息！（和@ReOffender 回答）

[javadoc] javadoc: error - Illegal package name: "E:\junoWrkspace\StrutsHelloWorld\src\com\igate\resources\ApplicationResources.properties"

javadoc 尝试从 .properties 文件生成文档，这就是 javadoc 找不到“包指令”的原因，您必须要求您的目标仅从 .java 文件和其他任何文件生成 javadoc

所以@ReOffender 是对的：

改变你<include name="**" />的<include name="**/*.java" />