javadoc と doclava を使用して Android プロジェクトのドキュメントを生成しようとしています。doclava jar をダウンロードし、[Project] -> [generate javadoc] でドキュメントを生成しようとしています。
メカニズムを理解していれば、doclava ドックレットを使用するように javadoc に指示する方法が 2 つあります。
1) 次のオプションで「カスタムドックレットを使用」を選択します。
ドックレット名: com.google.doclava.Doclava
ドックレット パス: /full/path/of/my/doclava/dir/doclava-1.0.6.jar
2) 「標準のドックレットを使用する」を選択し、「javadoc オプション」に以下を入力します。
-doclet com.google.doclava.Doclava
-docletpath ${/full/path/of/my/doclava/dir/doclava-1.0.6.jar}
私はこれらの問題に遭遇しました：
最初の方法を使用すると、ドキュメントを正常に生成できますが、Android クラスが認識されないようです。doclava が "import android.util.SparseArray" を解析するとエラーが発生します
2 番目の方法を使用すると、「javadoc: エラー - ドックレット クラス com.google.doclava.Doclava 1 エラーが見つかりません」というエラーが表示されます。
実際のところ、Doclava を使用しない場合、Android API へのリンクを含むドキュメントが正しく生成されます。
android/java doc (android/java オブジェクト用) へのリンクを含むプロジェクト javadoc を作成し、「android ルック アンド フィール」を持たせたいだけです。