如何在包含javadoc的單個jar包中使用maven程序集插件

Question

我有一個庫，我想在單個jar文件中提供javadoc。我使用Maven Assembly插件來獲得單個程序集。我有以下設置在pom.xml：

<build> 
    ... 
    <plugins> 
     <plugin> 
      <artifactId>maven-assembly-plugin</artifactId> 
      <configuration> 

       <descriptorRefs> 
        <descriptorRef>jar-with-dependencies</descriptorRef> 
       </descriptorRefs> 
       <appendAssemblyId>false</appendAssemblyId> 
      </configuration> 
     </plugin> 
     <plugin> 
      <groupId>org.apache.maven.plugins</groupId> 
      <artifactId>maven-javadoc-plugin</artifactId> 
      <version>2.10.4</version> 
      <executions> 
       <execution> 
        <id>attach-javadoc</id> 
        <phase>compile</phase> 
       </execution> 
      </executions> 
     </plugin> 
    </plugins> 
    ... 
    <build> 

要獲得一個jar我運行此命令行家：

clean compile assembly:single 

但不要生成的罐子裏的Javadoc。除此之外，我還需要做些什麼？

Answer 1

maven的標準方式是創建一個jar，只包含您的應用程序沒有javadoc/sources。如果你想提供的javadoc /來源庫的用戶，那麼你應該使用attach-sources/attach-javadoc這裏documentend：attach-source-javadoc-artifacts

這樣你會得到Maven倉庫內的其他文件，名稱分別

• （<yourlibrary>-1.0-SNAPSHOT.jar）
• <yourlibrary>-1.0-SNAPSHOT-sources.jar
• <yourlibrary>-1.0-SNAPSHOT-javadoc.jar