2

我试图弄清楚如何使用 Maven 创建我的 Javadocs 的 zip 文件而不是 jar 文件。我目前正在使用 maven-javadoc-plugin 创建一个 jar 文件。

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

我查看了此处列出的目标，但没有发现对此有任何帮助。这可以使用 maven-javadoc-plugin 还是必须使用其他插件？

4

1 回答 1

4

您需要maven-javadoc-plugin结合使用maven-assembly-plugin将生成的文档打包到zip. 首先，只使用goal生成apidocs javadoc:javadoc，不要打包。这会默认生成文档${project.build.directory}/apidocs。

然后，使用maven-assembly-plugin以下方式打包这些文档：

添加 maven 程序集插件：

<plugin>
  <artifactId>maven-assembly-plugin</artifactId>
  <executions>
    <execution>
      <id>docs-assembly</id>
      <phase>package</phase>
      <configuration>
        <appendAssemblyId>false</appendAssemblyId>
        <descriptors>
          <descriptor>src/main/assembly/assemble.xml</descriptor>
        </descriptors>
      </configuration>
      <goals>
        <goal>single</goal>
      </goals>
    </execution>
  </executions>
</plugin>

现在，配置 maven 程序集插件：

<?xml version="1.0" encoding="UTF-8"?>
<assembly>
  <id>${project.build.finalName}</id>
  <formats>
    <format>zip</format>
  </formats>
  <includeBaseDirectory>false</includeBaseDirectory>
  <fileSets>
    <fileSet>
      <directory>${project.build.directory}/apidocs</directory>
      <outputDirectory>/</outputDirectory>
    </fileSet>
  </fileSets>
</assembly>
于 2015-02-13T06:13:58.990 回答