Javadoc на Android (Eclipse)

Я пытаюсь создать Javadoc html-страницы для моего проекта Android в Eclipse. Я попытался использовать аргумент -linkoffline , как предлагается здесь , а также использовать аргумент -classpath указывающий на мой файл android.jar. Ни один из них не работал, поскольку я все еще получаю package android.app does not exist (и других) предупреждений. Я также попытался запустить javadoc-инструмент из командной строки, вместо использования Eclipse.

В идеале я хотел бы иметь свои собственные страницы для своих классов, со всеми классами android. * И java. *, Ссылающимися на онлайн-страницы. Я использую Mac OS 10.6 с Java версии 1.6.0_20.

Стремясь решить подобную проблему самостоятельно, два основных момента, которые я нашел, были:

  • Чтобы включить файл android.jar, который вы связываете с атрибутом classpath задачи javadoc Ant. Это означает следующее:

     <javadoc ... classpath="some/local/library.jar; C:/Android/platforms/android-8/android.jar; D:/another/library.jar" ... > к <javadoc ... classpath="some/local/library.jar; C:/Android/platforms/android-8/android.jar; D:/another/library.jar" ... > 
  • Чтобы добавить подтип ссылки в javadoc-задаче, чтобы соответствовать онлайн-адресу ссылки на Android с локальной копией списка пакетов Android Reference. Это означает следующее:

     <javadoc ...> <link offline="true" href="http://developer.android.com/reference/" packagelistloc="C:/Android/docs/reference" /> </javadoc> 

Этого было достаточно для того, чтобы показывать ссылки на Android в моем проекте Javadoc.

Вы пробовали использовать скрипт ant для javadocs? Назовите его javadoc.xml или что-то другое, кроме build.xml – иначе eclipse заберет его как сценарий сборки по умолчанию. Запустите скрипт ant изнутри eclipse ( RMB on file | Run As | Ant Build ) или с консоли: ant -f <file-name.xml> .

Моя выглядит примерно так:

 <project basedir="." default="doc" name="metagloss api docs"> <property name="android-sdk-docs" value="/home/blackrax/opt/dev/android-sdk-linux_86/docs/reference"/> <target name="doc" description="api docs - no piwik" depends="clean, delombok"> <javadoc destdir="docs"> <link offline="true" href="http://d.android.com/reference" packagelistLoc="${android-sdk-docs}" /> <fileset dir="src" includes="**/*.java" /> </javadoc> </target> <!-- more implementation, any remaining targets --> </project>