我正在使用maven和带有umlgraph-doclet的maven-javadoc-plugin为我的项目创建javadoc。我的pom部分:

<build>
  <plugins>
    <plugin>
      <groupId>org.apache.maven.plugins</groupId>
      <artifactId>maven-site-plugin</artifactId>
      <inherited>false</inherited>
      <configuration>
        <reportPlugins>
          <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-javadoc-plugin</artifactId>
            <version>2.8</version>
            <configuration>
              <show>public</show>
              <quiet>true</quiet>

              <doclet>org.umlgraph.doclet.UmlGraphDoc</doclet>
              <docletArtifact>
                <groupId>org.umlgraph</groupId>
                <artifactId>doclet</artifactId>
                <version>5.1</version>
              </docletArtifact>

              <useStandardDocletOptions>true</useStandardDocletOptions>
              <additionalparam>
                -inferrel -inferdep -quiet -hide java.* -hide org.eclipse.* -collpackages java.util.* -postfixpackage
                -nodefontsize 9 -nodefontpackagesize 7 -attributes -types -visibility -operations -constructors
                -enumerations -enumconstants -views
              </additionalparam>
            </configuration>
            <reportSets>
              <reportSet>
                <reports>
                  <report>aggregate</report>
                </reports>
              </reportSet>
            </reportSets>
          </plugin>
        </reportPlugins>
      </configuration>
    </plugin>
  </plugins>
</build>

使用jdk1.6构建Javadoc时,生成的图像看起来不错,它们会自动集成到所有javadoc页面中。但是,当使用jdk1.7进行构建时,图像仍会被创建,但是不在javadoc页面内。即使在官方网站上使用v5.4时,javadoc还是没有图像的。而且,maven的调试输出也没有提供任何线索。最重要的是,无法通过邮件联系一位UmlGraph开发人员。

谁能在这里给我一些建议,或者有一些解决办法?

最佳答案

我检查了可能性,情况如下:

UmlGraph中的

  • 相关错误已得到修复:https://github.com/dspinellis/UMLGraph/pull/8
  • 问题是,尚未发布稳定版本的UmlGraph,其中包括修复

  • 但是,好消息是,存在包含修复程序的快照存储库:https://oss.sonatype.org/content/repositories/snapshots/org/umlgraph/umlgraph/5.5.8-SNAPSHOT/

    因此,您需要将jar文件获取到本地存储库(取决于您的基础结构设置):
  • ,方法是将引用的存储库添加到您的环境中
  • 或通过导入到本地仓库(http://maven.apache.org/guides/mini/guide-3rd-party-jars-local.html)

  • 之后更新:
    <doclet>org.umlgraph.doclet.UmlGraphDoc</doclet>
    <docletArtifact>
                <groupId>org.umlgraph</groupId>
                <artifactId>doclet</artifactId>
                <version>5.1</version>
    </docletArtifact>
    

    更改为以下名称(命名约定已更改):
    <doclet>org.umlgraph.doclet.UmlGraphDoc</doclet>
    <docletArtifact>
        <groupId>org.umlgraph</groupId>
        <artifactId>umlgraph</artifactId>
        <version>5.5.8-SNAPSHOT</version>
    </docletArtifact>
    

    08-27 13:47