grails - Grails 3.3.6不为命令gradle文档触发DocStart和DocEnd事件

Question

我创建了一个新的Grails 3.3.6应用程序。

遵循此文档为我的项目创建文档:Grails Docs

上面的文档说要使用带有以下参数的gradle docs或grails doc。

Arguments:

--init - Create a template project documentation project (optional)

--pdf - Create PDF output for project documentation (optional)

Fired Events:

DocStart - Before documentation generation begins

DocEnd - After documentation generation completes

我创建了一个脚本文件夹，并添加了具有以下内容的_Events.groovy文件。

//document-service/scripts/_Events.groovy

eventDocStart = { kind ->
    println "**************************** doc start"
}

eventDocEnd = {
    println "**************************** doc end"
}

当我运行 gradle docs时。 Java Docs和groovy docs正在运行，但事件并未触发。而且 --pdf参数不起作用。

当我运行 grails doc时。我得到 Command not found doc
我究竟做错了什么？

Answer 1

该文档是错误的，并且在Grails 3中不再有效。我通过拦截gradle docs命令解决了我的问题。

task generateDocs (type: GenerateDocsTask) {}

tasks.groovydoc.dependsOn(generateDocs)

class GenerateDocsTask extends DefaultTask {

    @TaskAction
    def docGenerate() {
        List urls = project.sourceSets.main.runtimeClasspath.files.collect { it.toURI().toURL() }
        URLClassLoader classLoader = new URLClassLoader(urls as URL[], (ClassLoader) null)
        def gdocGenerator = classLoader.loadClass("com.rax.DocGenerator").newInstance()
        gdocGenerator.generateGdoc(classLoader)
    }
}