lein-javadocLeiningen ビルド ツールのプラグインの改善に取り組んでいます。これは JVM プロセスで実行され、プロジェクトのクラスパスを自由に使用できます。Javadoc を生成する最もクロスプラットフォームな方法は何ですか?
- それを見つけ
$JAVA_HOME/../lib/tools.jarてプラグインのクラスパスに含めてから、 を呼び出しますcom.sun.tools.javadoc.Main。(古いアプローチ。) $JAVA_HOME/../lib/tools.jarへの呼び出しを見つけて作成しますjava -cp path/to/tools.jar:rest:of:project:classpath com.sun.tools.javadoc.Main -javadoc -options -here。（新しいアプローチ。）- オプションを呼び出し
javadocて渡します。
振り返ってみると選択肢 3 は正しいように思えますが、OpenJDK に tools.jar がないことに気付いた後で初めてそれを発見しました。【実はあるんです！そのバージョン用の JRE パッケージしかインストールしていませんでした -- JDK パッケージには tools.jar があります。]
ただし、それを使用するためにコードを作り直す前に、知っておくべきトレードオフはありますか? 例:
- javadoc を呼び出すと、Windows での処理が難しくなりますか? (Windows であることを嗅ぎ分けて、代わりに javadoc.exe を呼び出す必要がありますか?)
- Java の 1 つのバージョン (シェル PATH にあるもの) にシェルアウトし、別のバージョンの tools.jar (現在の JVM のバージョン) を使用すると、問題が発生する可能性はありますか?