問題タブ [maven-javadoc-plugin]

pom.xmlプロジェクトは、複数のモジュールを持つルートで構成されています。ルート パッケージcom.exampleにはコードがまったく含まれていません(srcディレクトリがありません)。各モジュールには、サブパッケージを含む 1 つのパッケージが、典型的な Maven 構造com.example.foo( 、com.example.bar、com.example.bar.bazなど) で含まれています。

root にグループ構成pom.xmlがあります。

コマンドでjavadocを作成していmvn clean javadoc:aggregateます。

com.example結果の javadocs は、1 つの例外を除いて、期待どおりにパッケージをグループ化します。グループOther Packages内の root package の javadocs も取得し、1 つのクラスが含まれていAppますHello world!。ただし、これAppは存在しません。実際、コードベース全体を grep すると、Hello world!ゼロの結果が得られます。

存在しないクラスのドキュメントが生成されないようにするにはどうすればよいですか?

すでに試しました：

• <excludePackageNames>com.example</excludePackageNames>--> これにより、サブパッケージも除外されるため、javadoc がまったく生成されません。

私はマルチモジュールプロジェクトを持っています:

すべてのモジュールに対して集約された Javadocを生成したいと考えています。これは、parentの pom.xml ( pomパッケージを持ち、子モジュールを定義する)で次のようなものを使用することによって機能します。

集約された Javadoc が正しく生成され、うまく機能します。

しかし、問題は、生成された集約された Javadoc をmodule3最終的な .jarに含める必要があることです! module3.jarつまり、生成されたすべてのモジュールの集約された Javadoc のコピーを結果に含める必要があります。

そのため、プロジェクトの準備パッケージフェーズでmaven-javadoc-pluginプラグインを実行しようとしています。パッケージ化が完了する前にJavadoc を生成したいので、それを含めることができます (たとえば、プラグインを使用してコピーすることにより)。 .parentmodule3maven-antrun-plugin

しかし、ここに私の問題があります。準備パッケージフェーズを使用しても、アーティファクトpackageに対してフェーズが実行されたときに、集約された Javadoc がまだ生成されていないようです! module3親プラグインがすべての子プラグインの後に実行される場合のように、前に実行されるはずのフェーズを使用して宣言されていても...

のフェーズの前にすべてのモジュールの集約された Javadoc を生成する方法についてのアイデアがあるので、その Javadoc を含めることができますか?packagemodule3

このタグの正しい使い方はよくわかりませんが、次のように使用します。

まったく機能しません。これらのスレッドが見つかったため、このタグが機能しないという既知のバグが maven にあったようです: https://stackoverflow.com/a/26223872/3209177

しかし、それは少し前のことです。Maven Web サイトでも、有用な情報はあまり見つかりませんでした。

では、maven を使用して javadoc をビルドする際に、特定のソース ファイルやクラスを除外するにはどうすればよいでしょうか。

プロジェクト用に javadoc を生成し、生成されたファイルを HTTPS 経由でホストします。しかし、リンクをクリックして外部クラスの JavaDoc をフェッチすると、コンテンツがブロックされます。これは、HTTP (たとえば、Oracle クラス) 上にあるためです。したがって、Object クラスへの参照は、私の JavaDoc では次のようになります。

http://docs.oracle.com/javase/8/docs/api/java/lang/Object.html?is-external=true

javadoc maven プラグインでこれを構成するものを見つけることができませんでした。適切な HTTPS 外部 JavaDoc ページにリンクするにはどうすればよいですか?

私は目標を持ってMavenプロジェクトを構築していsiteます。出力に Javadoc 警告があります。この場合、私の Maven ビルドは失敗する必要があります。それを行う方法はありますか？

これが私のPOMのコードスニペットです（私はMaven 3.3を使用しています）：

私は独自の Java 8 Stream 実装を作成しており、元のjava.util.stream.Streamインターフェースから Javadoc を継承したいと考えています。しかし、私はそれを機能させることができません。生成された Javadoc には、私のドキュメントのみが表示され、拡張 Stream インターフェイスからのドキュメントは表示されません。

したがって、たとえば、このメソッドの javadoc には「いくつかの追加情報」というテキストのみが含まれており、Streamインターフェースからのドキュメントは含まれていません。

これは、maven-javadoc-plugin の私の構成です。

この構成で何かが欠けていますか? maven-compiler-plugin でsourceandを 1.8に設定しました。targetしたがって、maven-javadoc-pluginのドキュメントによると、Java API は自動的に検出されるはずです。

Stack Overflowにも同様の質問がありましたが、その回答は役に立たないようです。

Maven を使用してプロジェクトをビルドしているときに、親プロジェクトのバージョンを更新した後に javadoc を生成するという問題に遭遇しました。

ご覧のとおり、実際には存在しないmaven_rt_plugin_config-master-2.0.7-site_ en .xml をダウンロードしようとします。ただし、_en サフィックスのない xml は存在します...

私が確認できる限り、ロケールを指定していません。また、サイトまたは javadoc の生成に関連する親プロジェクトに変更はないようです。

Maven がデフォルトのロケールにフォールバックしないのはなぜですか?