ソースなしでパッケージ化する jar ファイルを作成していますが、Eclipse で開発者向けに javadoc を公開したいと考えています。
5 に答える
JAR のユーザーは、JAR が使用される Java プロジェクトの Java ビルド パス プロパティで、Javadoc の場所 (アーカイブ内の URL、ファイル、またはパス) を JAR に関連付けることができます。
これがバイナリと同じ JAR 内の Javadoc でどの程度うまく機能するかはわかりませんが (これまでに見たことがない)、理論的には機能するはずです。
あなたのビルドプロセスは何ですか?Maven リリース プロセスでは、実際には 3 つの jar が生成されます。1 つはコンパイルされたクラスを含み、1 つはソースを含み、もう 1 つは javadoc を含みます。ソース jar の配布を防ぐために POM をカスタマイズできる必要があります。また、Maven を使用して依存関係を管理する人は、jar への依存関係を宣言すると、自動的に javadoc を取得します (Eclipse Maven プラグインで javadoc のダウンロードをオンにします)。
JIDE には、ソース コードに対して実行し、すべてのメソッド本体を取り除き、javadoc を残して zip ファイルを生成するツール (25 ドルの費用) があります。その後、この zip をソース zip として配布できます。IDE は javadoc を読み取ることができますが、もちろんすべてのロジックが削除されているため、クローズド ソース性を維持できます。zip ファイルには、プライベート メンバーとメソッドは含まれません。
また、intellisense のメソッド パラメーター名を保持するという追加のボーナスもあるため、次のメソッド
public void foo( String text, Integer index ) {
}
オートコンプリートすると、foo( String arg1, Integer arg2 ) の代わりに foo ( String text, Integer index )が表示されるため、パラメーターがどうあるべきかをヒントできます。