端口javadoc到ant任务：如何实现“[@files]”选项？

Question

我正在尝试将javadoc添加到我的ant构建过程中，真的不知道如何将javadoc的一个选项“转换”为蚂蚁任务“< javadoc>”。 这里的Javadoc用法：

usage: javadoc [options] [packagenames] [sourcefiles] [@files] 

这是我已经尝试过：

<javadoc sourcefiles="build/sourcefiles.txt"> 
    </javadoc> 

而且我想在我的Ant任务选项[@files]，但无法找到一个合适的方式这样做......你可能有什么想法吗？

在此先感谢...

Answer 1

最简单的（原始）的方法是使用arg子元素，以提供更多的命令行参数。

<javadoc> 
    <arg value="@build/sourcefiles.txt" /> 
</javadoc> 

但我想这不会以这种方式工作，因为javadoc任务想至少要给予必要的属性。

要共同采取文件的列表从一个文件中，filelist资源集合与loadfile任务可以帮助：

<loadfile property="sourcefiles-list" 
      srcFile="build/sourcefiles.txt" 
      encoding="US-ASCII" /> 
<javadoc destdir="..."> 
    <sourcefiles> 
    <filelist files="${sourcefiles-list}"/> 
    </sourcefiles> 
</javadoc> 

---

其实，packagelist属性可能是你想要什么：

<javadoc destdir="..." sourcepath="..." 
     packageList="build/sourcefiles.txt"> 
</javadoc> 

试试这个（我不知道它是否也接受文件名）。

Answer 2

为什么在可用时将其移植？

http://ant.apache.org/manual/Tasks/javadoc.html