Làm thế nào để sử dụng javadoc: tổng hợp đúng trong dự án maven đa mô-đun?

Question

Đây là tập tin của tôi mẹ pom.xml (một phần của nó) trong một dự án đa mô-đun:

... 
<build> 
    <plugins> 
     <plugin> 
      <groupId>org.apache.maven.plugins</groupId> 
      <artifactId>maven-javadoc-plugin</artifactId> 
     </plugin> 
    </plugins> 
</build> 
... 

Plugin này được thừa hưởng ở tất cả các tiểu mô-đun và tôi không nghĩ rằng đó là một cách tiếp cận đúng. Khi tôi đang chạy mvn javadoc:aggregate các tài liệu được tạo ra trong target/site/apidoc, nhưng nhật ký đầy cảnh báo:

... 
[WARNING] Removing: aggregate from forked lifecycle, 
to prevent recursive invocation. 
... 

Tôi đang làm gì sai?

Answer 1

Bạn cần phải bật kết hợp với plugin này:

<plugin> 
    <artifactId>maven-javadoc-plugin</artifactId> 
    <configuration> 
     <aggregate>true</aggregate> <!-- this enables aggretation --> 
    </configuration> 
    </plugin> 

Trên kiểu dòng lệnh:

mvn javadoc:aggregate 

Edit:

Được rồi, tôi đã làm một số đào sâu vào jira maven Plugin và tìm thấy rằng tất cả các mojos plugin javadoc đã được chú thích bằng @aggregator. Nhưng hình như vẫn có vấn đề với aggregator maven của vấn đề mà đã được nộp here lỗi

Ngoài ra còn có liên quan here và here và một số chi tiết

Điều này dường như là một vấn đề chặn với aggregator maven kể từ khi một số plugin như ví dụ clover sẽ không chạy.

Để tóm tắt, bạn đang làm gì sai

Chỉ cần chuyển về phiên bản trước của maven-javadoc-plugin mà không sử dụng @aggregator mojo chú thích và bạn sẽ không nhận được những lời cảnh báo (trừ khi bạn là sử dụng tính năng nhất định của plugin javadoc không có sẵn trong phiên bản cũ hơn)

Lưu ý phụ, Nếu bạn chạy plugin javadoc làm báo cáo thì @aggregator bị bỏ qua.