由 Maven 构建

Cookbook：如何附加源代码和 javadoc 工件？

概括

这个秘籍描述了如何将源代码和 javadoc 工件附加到您的构建中。

先决条件插件

以下是使用的插件列表：

插入 版本
source 2.0.4
javadoc 2.3

样本生成的输出

attach-source-javadoc
|-- pom.xml
|-- src\
`-- target
    `-- attach-source-javadoc-1.0-SNAPSHOT.jar
    `-- attach-source-javadoc-1.0-SNAPSHOT-javadoc.jar
    `-- attach-source-javadoc-1.0-SNAPSHOT-sources.jar

食谱

配置 Maven 源插件

source:jar我们在阶段从源插件执行目标package。

<plugin>
  <groupId>org.apache.maven.plugins</groupId>
  <artifactId>maven-source-plugin</artifactId>
  <executions>
    <execution>
      <id>attach-sources</id>
      <goals>
        <goal>jar</goal>
      </goals>
    </execution>
  </executions>
</plugin>

配置 Maven Javadoc 插件

javadoc:jarjavadoc 插件的目标也是如此。

<plugin>
  <groupId>org.apache.maven.plugins</groupId>
  <artifactId>maven-javadoc-plugin</artifactId>
  <executions>
    <execution>
      <id>attach-javadocs</id>
      <goals>
        <goal>jar</goal>
      </goals>
    </execution>
  </executions>
</plugin>

运行 Maven

只需调用 Maven 来生成包：

mvn package

其他提示

为了缩短构建时间或发布版本，您还可以在配置文件中定义这些插件。

资源