自从使用Maven以来,我已经能够在本地存储库中构建和安装具有不完整Javadoc标记(例如,缺少参数)的项目.
然而,因为我迁移到Java8(1.8.0-ea-b90),所以Maven对于缺少文档标记是绝对严格的,并且当我try 构建或安装Javadoc不是"完美"的项目时,它会向我显示许多与Javadoc问题相关的Javadoc错误.我试图在本地存储库中编译和安装的一些项目是我无法控制的第三方项目.因此,在我的场景中,仅修复所有这些项目中的所有Javadoc的解决方案似乎不可行.
这是我在项目中执行mvn clean package install
时看到的输出的一小部分:
[INFO] ------------------------------------------------------------------------
[INFO] BUILD FAILURE
[INFO] ------------------------------------------------------------------------
[INFO] Total time: 9.026s
[INFO] Finished at: Mon Apr 08 21:06:17 CEST 2013
[INFO] Final Memory: 27M/437M
[INFO] ------------------------------------------------------------------------
[ERROR] Failed to execute goal org.apache.maven.plugins:maven-javadoc-plugin:2.9:jar (attach-javadocs) on project jpc: MavenReportException: Error while creating archive:
[ERROR] Exit code: 1 - /Users/sergioc/Documents/workspaces/heal/jpc/src/main/java/org/jpc/engine/prolog/PrologDatabase.java:10: error: @param name not found
[ERROR] * @param terms the terms to assert
[ERROR] ^
[ERROR] /Users/sergioc/Documents/workspaces/heal/jpc/src/main/java/org/jpc/engine/prolog/PrologDatabase.java:11: warning: no description for @return
[ERROR] * @return
[ERROR] ^
在我的POM中,Javadoc Maven插件配置如下:
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-javadoc-plugin</artifactId>
<version>2.9</version>
<executions>
<execution>
<id>attach-javadocs</id>
<goals>
<goal>jar</goal>
</goals>
</execution>
</executions>
</plugin>
正如我之前所说的,如果我回到Java7,一切都很好.
UPDATE:个
如果我将Javadoc插件配置更改为<failOnError>false</failOnError>
(谢谢Martin):
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-javadoc-plugin</artifactId>
<version>2.9</version>
<executions>
<execution>
<id>attach-javadocs</id>
<goals>
<goal>jar</goal>
</goals>
</execution>
</executions>
</plugin>
然后将该项目安装到我的本地存储库中.但是,仍然没有生成Javadoc JAR.
我在控制台中看到的这个新配置的输出片段是:
[错误]MavenReportException:创建存档时出错:退出
请参阅中生成的Javadoc文件
在
在使用Java7时,如何一步构建源代码、安装项目和生成Javadoc JAR,有什么变通方法吗?