在maven中生成javadoc，然后通过scp上传？答案

【问题标题】：Generate javadoc in maven and then upload via scp?在maven中生成javadoc，然后通过scp上传？
【发布时间】：2012-07-05 00:00:23
【问题描述】：

我的 Maven javadoc 插件现在运行良好，但我不知道如何通过 scp 将其添加到远程目录。

如何通过 scp 传输 javadoc 文件，但在它们生成之后？这会在我调用 site:site 时自动发生吗？

谢谢！

【问题讨论】：

标签： maven javadoc maven-javadoc-plugin maven-wagon-plugin

【解决方案1】：

maven-javadoc-plugin 默认不附加到任何阶段/目标，您需要在 pom.xml 中手动配置。

见Generate Javadocs As Part Of Project Reports:

要生成 javadocs 作为站点生成的一部分，您应该在 pom 的部分添加 Javadoc 插件：
 <project>
    ...
    <reporting>
      <plugins>
        <plugin>
          <groupId>org.apache.maven.plugins</groupId>
          <artifactId>maven-javadoc-plugin</artifactId>
          <version>2.8.1</version>
          <configuration>
            ...
          </configuration>
        </plugin>
      </plugins>
      ...
    </reporting>
    ...
  </project>
当您执行 mvn site 时，将生成 javadocs 并将其包含在生成的站点中。将在 Project Reports 菜单中添加指向 javadocs 的链接。

或者，如果您使用 maven-release-plugin，javadoc 生成（和上传）默认情况下会自动处理，请参阅here：

在 release:perform 目标执行完成后，将创建以下可交付产品并将其部署到本地和远程存储库。

工件 id-version.jar
项目当前版本的二进制文件。

工件 id-version-javadoc.jar
解释当前版本中类的当前功能的 javadoc。

工件 id-version-source.jar
用于构建项目当前版本的源代码修订版。

工件 id-version.pom
用于创建项目当前版本的 pom.xml 文件的内容。

如果您想将 javadoc 生成附加到站点以外的某个阶段/目标，请查看 How to deploy Javadoc jar file?

【讨论】：