Groovydoc

API 文档Groovydoc

为 Groovy 源码(可选 Java 源码)生成 HTML API 文档。

此任务使用 Groovy 的 Groovydoc 工具生成 API 文档。请注意 Groovydoc 工具目前存在一些限制。使用的 Groovydoc 版本是构建脚本中定义的 Groovy 依赖的版本。

属性

属性描述
access

在 Groovydoc 中包含的最严格的访问级别。

classpath

用于查找文档化源码引用的类的 classpath。

destinationDir

生成文档的目标目录。

docTitle

包索引(首页)的标题。如果没有文档标题,则设置为 null

excludes

排除模式集。

footer

每页的 HTML 页脚。如果没有页脚,则设置为 null

groovyClasspath

包含要使用的 Groovy 库的 classpath。

header

每页的 HTML 页眉。如果没有页眉,则设置为 null

includeAuthor

是否包含作者段落。

includeMainForScripts

是否包含脚本的 main 方法。

includes

包含模式集。

links

指向给定 URL 处 groovydoc/javadoc 输出的链接。

noTimestamp

生成的 HTML 隐藏注释中是否包含时间戳(Groovy >= 2.4.6)。

noVersionStamp

生成的 HTML 隐藏注释中是否包含版本戳(Groovy >= 2.4.6)。

overviewText

返回用于概览文档的 HTML 文本。如果没有概览文本,则设置为 null

processScripts

是否处理脚本。

source

应用包含和排除模式后,此任务的源码。忽略不存在的源码文件。

use

是否创建类和包使用情况页面。

windowTitle

文档的浏览器窗口标题。如果没有窗口标题,则设置为 null

方法

方法描述
exclude(excludeSpec)

添加排除规范。此方法可以多次调用以追加新的规范。给定闭包会接收一个 FileTreeElement 作为参数。闭包应返回 true 或 false。示例

exclude(excludes)

添加 ANT 风格的排除模式。此方法可以多次调用以追加新的模式,也可以在一次调用中指定多个模式。如果没有提供排除模式,则不会排除任何文件。如果提供了排除模式,则文件必须不匹配任何排除模式才能被处理。

exclude(excludes)

添加 ANT 风格的排除模式。此方法可以多次调用以追加新的模式,也可以在一次调用中指定多个模式。如果没有提供排除模式,则不会排除任何文件。如果提供了排除模式,则文件必须不匹配任何排除模式才能被处理。

exclude(excludeSpec)

添加排除规范。此方法可以多次调用以追加新的规范。如果没有提供排除项,则不会排除任何文件。如果提供了排除项,则文件必须不匹配任何排除模式才能被处理。

include(includeSpec)

添加包含规范。此方法可以多次调用以追加新的规范。给定闭包会接收一个 FileTreeElement 作为参数。如果没有提供包含项,则此容器中的所有文件都将被包含。如果提供了包含项,则文件必须至少匹配一个包含模式或规范才能被包含。

include(includes)

添加 ANT 风格的包含模式。此方法可以多次调用以追加新的模式,也可以在一次调用中指定多个模式。如果没有提供包含模式,则此容器中的所有文件都将被包含。如果提供了包含模式,则文件必须至少匹配一个包含模式才能被处理。

include(includes)

添加 ANT 风格的包含模式。此方法可以多次调用以追加新的模式,也可以在一次调用中指定多个模式。如果没有提供包含模式,则此容器中的所有文件都将被包含。如果提供了包含模式,则文件必须至少匹配一个包含模式才能被处理。

include(includeSpec)

添加包含规范。此方法可以多次调用以追加新的规范。如果没有提供包含项,则此容器中的所有文件都将被包含。如果提供了包含项,则文件必须至少匹配一个包含模式或规范才能被包含。

link(url, packages)

添加指向给定 URL 处 groovydoc/javadoc 输出的链接。

source(sources)

向此任务添加一些源码。给定的源码对象将按照 Project.files(java.lang.Object[]) 进行评估。

脚本块

无脚本块

属性详情

在 Groovydoc 中包含的最严格的访问级别。

例如,要包含具有 package、protected 和 public 访问权限的类和成员,请使用 GroovydocAccess.PACKAGE

groovy 插件的默认值
GroovydocAccess.PROTECTED

FileCollection classpath

用于查找文档化源码引用的类的 classpath。

groovy 插件的默认值
sourceSets.main.output + sourceSets.main.compileClasspath

File destinationDir

生成文档的目标目录。

groovy 插件的默认值
${project.docsDir}/groovydoc

String docTitle

包索引(首页)的标题。如果没有文档标题,则设置为 null

groovy 插件的默认值
project.reporting.apiDocTitle

Set<String> excludes

排除模式集。

String footer

每页的 HTML 页脚。如果没有页脚,则设置为 null

groovy 插件的默认值
null

FileCollection groovyClasspath

包含要使用的 Groovy 库的 classpath。

groovy 插件的默认值
project.configurations.groovy

String header

每页的 HTML 页眉。如果没有页眉,则设置为 null

groovy 插件的默认值
null

Property<Boolean> includeAuthor

是否包含作者段落。

groovy 插件的默认值
false

Property<Boolean> includeMainForScripts

是否包含脚本的 main 方法。

groovy 插件的默认值
true

Set<String> includes

包含模式集。

Set<Link> links

指向给定 URL 处 groovydoc/javadoc 输出的链接。

groovy 插件的默认值
[]

boolean noTimestamp

生成的 HTML 隐藏注释中是否包含时间戳(Groovy >= 2.4.6)。

groovy 插件的默认值
false

boolean noVersionStamp

生成的 HTML 隐藏注释中是否包含版本戳(Groovy >= 2.4.6)。

groovy 插件的默认值
false

TextResource overviewText

返回用于概览文档的 HTML 文本。如果没有概览文本,则设置为 null

groovy 插件的默认值
null

Property<Boolean> processScripts

是否处理脚本。

groovy 插件的默认值
true

FileTree source (只读)

应用包含和排除模式后,此任务的源码。忽略不存在的源码文件。

源码的 PathSensitivity 被配置为 PathSensitivity.ABSOLUTE。如果您的源码不太严格,请在子类中覆盖此方法并进行相应修改。

groovy 插件的默认值
sourceSets.main.groovy

boolean use

是否创建类和包使用情况页面。

groovy 插件的默认值
false

String windowTitle

文档的浏览器窗口标题。如果没有窗口标题,则设置为 null

groovy 插件的默认值
project.reporting.apiDocTitle

方法详情

SourceTask exclude(Closure excludeSpec)

添加排除规范。此方法可以多次调用以追加新的规范。给定闭包会接收一个 FileTreeElement 作为参数。闭包应返回 true 或 false。示例

copySpec {
  from 'source'
  into 'destination'
  //an example of excluding files from certain configuration:
  exclude { it.file in configurations.someConf.files }
}

如果没有提供排除项,则不会排除任何文件。如果提供了排除项,则文件必须不匹配任何排除模式才能被处理。

SourceTask exclude(Iterable<String> excludes)

添加 ANT 风格的排除模式。此方法可以多次调用以追加新的模式,也可以在一次调用中指定多个模式。如果没有提供排除模式,则不会排除任何文件。如果提供了排除模式,则文件必须不匹配任何排除模式才能被处理。

SourceTask exclude(String... excludes)

添加 ANT 风格的排除模式。此方法可以多次调用以追加新的模式,也可以在一次调用中指定多个模式。如果没有提供排除模式,则不会排除任何文件。如果提供了排除模式,则文件必须不匹配任何排除模式才能被处理。

SourceTask exclude(Spec<FileTreeElement> excludeSpec)

添加排除规范。此方法可以多次调用以追加新的规范。如果没有提供排除项,则不会排除任何文件。如果提供了排除项,则文件必须不匹配任何排除模式才能被处理。

SourceTask include(Closure includeSpec)

添加包含规范。此方法可以多次调用以追加新的规范。给定闭包会接收一个 FileTreeElement 作为参数。如果没有提供包含项,则此容器中的所有文件都将被包含。如果提供了包含项,则文件必须至少匹配一个包含模式或规范才能被包含。

SourceTask include(Iterable<String> includes)

添加 ANT 风格的包含模式。此方法可以多次调用以追加新的模式,也可以在一次调用中指定多个模式。如果没有提供包含模式,则此容器中的所有文件都将被包含。如果提供了包含模式,则文件必须至少匹配一个包含模式才能被处理。

SourceTask include(String... includes)

添加 ANT 风格的包含模式。此方法可以多次调用以追加新的模式,也可以在一次调用中指定多个模式。如果没有提供包含模式,则此容器中的所有文件都将被包含。如果提供了包含模式,则文件必须至少匹配一个包含模式才能被处理。

SourceTask include(Spec<FileTreeElement> includeSpec)

添加包含规范。此方法可以多次调用以追加新的规范。如果没有提供包含项,则此容器中的所有文件都将被包含。如果提供了包含项,则文件必须至少匹配一个包含模式或规范才能被包含。

void link(String url, String... packages)

添加指向给定 URL 处 groovydoc/javadoc 输出的链接。

SourceTask source(Object... sources)

向此任务添加一些源码。给定的源码对象将按照 Project.files(java.lang.Object[]) 进行评估。