android - 如何使用 Intellij IDEA 中的 UMLGraph 创建 javadoc

Question

我正在使用 UMLGraph 在 Intellij IDEA 中为我的项目中的每个类创建类图。我的代码 /app/build.gradle是:

allprojects {
    configurations {
        umljavadoc
    }

    dependencies {
        umljavadoc 'org.umlgraph:umlgraph:5.6'
    }

    //
    // While javadoc is not typically dependent on compilation, the compile steps
    // sometimes generate some sources that we wish to have in the Javadoc.
    //
    task javadoc(overwrite: true, dependsOn: build) {
        setDescription('Generates Javadoc API documentation with UMLGraph diagrams')
        setGroup(JavaBasePlugin.DOCUMENTATION_GROUP)

        doLast {
            def javaFilePath = file('src/main/java')
            if (javaFilePath.exists())
            {
                ant.javadoc(classpath: "{path_to android jar}",
                        sourcepath: file('src/main/java'),
                        packagenames: '*',
                        destdir: "{path_to_doc_dir}",
                        private: 'true',
                        docletpath: configurations.umljavadoc.asPath,
                        charset: 'UTF-8',
                        encoding: 'UTF-8',
                        docencoding: 'UTF-8') {
                    doclet(name: 'org.umlgraph.doclet.UmlGraphDoc')
                            {
                                param(name: '-inferrel')
                                param(name: '-inferdep')
                                param(name: '-qualify')
                                param(name: '-postfixpackage')
                                param(name: '-hide', value: 'java.*')
                                param(name: '-collpackages', value: 'java.util.*')
                                param(name: '-nodefontsize', value: '9')
                                param(name: '-nodefontpackagesize', value: '7')
                                param(name: '-link', value: 'http://java.sun.com/j2se/1.5.0/docs/guide/javadoc/doclet/spec')
                                param(name: '-link', value: 'http://java.sun.com/j2se/1.5/docs/api')
                            }
                }
            }
            else
            {
                print("!!! Cannot find source path !!!");
            }
        }
    }
}

如果我开始 gradlew javadoc从控制台一切都很好，它创建并插入所有图表。但是，如果我尝试使用 IDE ( Tools - Generate Javadoc...) 生成文档，则不会创建图表。

如果我尝试运行任务 javadoc来自 Gradle view ，它插入文本占位符而不是实际图表。

问题是:如何使用对话框 Tools - Generate Javadoc... 生成带有 UMLGraph 图表的 javadoc ?

Answer 1

在“生成 JavaDoc”对话框的“其他命令行参数”下，您可以添加指向 doclet 类的 -docletpath 和 -doclet 参数，然后添加特定于 doclet 的参数。