如何在包含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