Как связать сторонние библиотеки в Javadoc-задаче Ant - PullRequest
Новая
       4

Как связать сторонние библиотеки в Javadoc-задаче Ant

7 голосов
/ 08 июля 2010

У меня есть проект, который использует стороннюю библиотеку в форме файла JAR, и я использую Ant для создания проекта Javadocs. Я не могу заставить Ant связываться со сторонними библиотеками javadocs при использовании задачи javadoc.

Вот задача javadoc: 

<javadoc excludepackagenames="" access="private" destdir="javadoc" author="true" 
         version="true" use="true" windowtitle="title" useexternalfile="true">
  <fileset dir="." defaultexcludes="yes">
    <include name="*/src/com/**/*.java"/>
  </fileset>

  <link href="http://www.redhillconsulting.com.au/products/simian/javadoc/"/> 
  <link href="http://java.sun.com/j2se/1.5.0/docs/api/"/>
</javadoc>

В выходных данных задачи указано, что пакет simian не существует: 

[javadoc] C:\development\java\tools\src\com\cname\DuplicateCodeIdentifier.java:15: package au.com.redhillconsulting.simian does not exist
[javadoc] import au.com.redhillconsulting.simian.Checker;
[javadoc]                                        ^

При запуске задачи ant создаются все ссылки на веб-сайт Sun правильно, но не на сайт redhillconsulting. Оба URL приводят к файлу списка пакетов и соответствующим путям (соответствуют содержимому списка пакетов).

Как настроить задачу Ant <javadoc> для создания ссылок на сторонний сайт?

Примечание: файл обезьяньего фляги находится в tools / lib. Я не видел, чтобы это указывало, что какой-либо путь к классам является опцией, поэтому я не исследовал этот путь, но я попытался добавить файл jar в путь включения набора файлов, и это было не очень хорошо.

Ответы [ 2 ]

15 голосов
/ 09 июля 2010

Тег javadoc принимает встроенный тег classpath 

<javadoc ...>
    <classpath>
        <fileset dir="${dir.lib}">
            <include name="simian.jar"/>
        </fileset>
    </classpath>
</javadoc>
0 голосов
/ 05 ноября 2015

Для * java-файлов по какой-то причине это не сработало.Мне удалось решить эту проблему с помощью наборов файлов , один из которых включает файлы моих текущих проектов, а другой - файлы дополнительных пакетов.Я просто не использовал атрибут sourcepath .Легко добавить больше файлов по желанию.Однако я не пробовал * jar-файлы. 

<target name="doc" depends="init" description="generate documentation">
  <javadoc 
       destdir="${doc.dir}"
       access="private"
       author="yes"
       linksource="yes">
    <fileset dir="./MyProject" includes="**/*.java" />        
    <fileset dir="./GuiPackage" includes="**/*.java" />        
  </javadoc>
</target>
...