Sel*_*ena 5 java javadoc maven maven-javadoc-plugin java-8
我试图生成实际链接到我的依赖项的Javadoc的Javadoc.我已经尝试了各种方法来生成Javadoc,它不会为我的依赖项中的类的引用生成完全限定的类名.我想要使用简化的类名链接到Java doc.但是,即使使用Java API类名,我也没有链接并拥有完全限定的类名.我正在使用Java 8.我有以下配置:
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-javadoc-plugin</artifactId>
<version>2.10.2</version>
<configuration>
<reportOutputDirectory>${project.basedir}/target</reportOutputDirectory>
<destDir>javadoc</destDir>
<windowtitle>Epiphany</windowtitle>
<doctitle>Epiphany</doctitle>
<show>private</show>
<detectLinks>false</detectLinks>
<detectOfflineLinks>true</detectOfflineLinks>
<linksource>true</linksource>
<detectJavaApiLink>false</detectJavaApiLink>
<additionalparam>-Xdoclint:none</additionalparam>
<links>
<link>http://docs.oracle.com/javase/8/docs/api</link>
</links>
</configuration>
<executions>
<execution>
<goals>
<goal>javadoc</goal>
<goal>test-javadoc</goal>
</goals>
</execution>
</executions>
</plugin>
Run Code Online (Sandbox Code Playgroud)
我在maven编译器配置中将源设置为Java 8.我尝试使用detectJavaApiLinkset来true省略Java 8 Javadoc的链接,但是Javadoc没有生成Java API类的链接,并且我在Javadoc中对它们的所有引用都是完全限定的类名.
我曾尝试设置detectJavaApiLink到false使用与指定的URL(没有,没有尾随斜线)上面的配置,我也得到相同的结果,与此错误一起:
[WARNING] javadoc: warning - Error fetching URL: http://docs.oracle.com/javase/8/docs/api
Run Code Online (Sandbox Code Playgroud)
我已经尝试检测基于我声明的依赖项的链接,我已经尝试将其设置为false然后提供到Javadoc的链接,我仍然没有链接,并且我的依赖项中的类的所有类名都是完全限定的.我到底做错了什么?包列表文件在指定的URL处可用,因此我不明白为什么Javadoc无法访问它们或位于那里的Javadoc.
更新:
将我的maven javadoc插件版本更改为2.10.3.现在,如果我设置detectJavaApiLink到true并删除链接的Java 8的javadoc,正确生成javadoc的链接到Java API类和使用了简化的名称.
但是,我仍然遇到第三方依赖项问题并链接到他们的Javadoc.如果我设置detectLinks为true,则无法为其中任何一个找到javadoc.如果我将其设置为false并手动配置位置,我仍然会收到一条错误消息,指出它无法获取URL:
[WARNING] javadoc: warning - Error fetching URL: https://selenium.googlecode.com/git/docs/api/java
Run Code Online (Sandbox Code Playgroud)
我更新的maven javadoc插件的pom配置如下:
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-javadoc-plugin</artifactId>
<version>2.10.3</version>
<configuration>
<reportOutputDirectory>${project.basedir}/target</reportOutputDirectory>
<destDir>javadoc</destDir>
<windowtitle>Epiphany</windowtitle>
<doctitle>Epiphany</doctitle>
<show>private</show>
<detectLinks>false</detectLinks>
<detectOfflineLinks>true</detectOfflineLinks>
<linksource>true</linksource>
<additionalparam>-Xdoclint:none</additionalparam>
<detectJavaApiLink>true</detectJavaApiLink>
<links>
<link>https://selenium.googlecode.com/git/docs/api/java</link>
</links>
</configuration>
<executions>
<execution>
<goals>
<goal>javadoc</goal>
<goal>test-javadoc</goal>
</goals>
</execution>
</executions>
</plugin>
Run Code Online (Sandbox Code Playgroud)
更新2:
向MJAVADOC提交的缺陷报告:
| 归档时间: |
|
| 查看次数: |
2120 次 |
| 最近记录: |