Groovydoc

API 文档Groovydoc

为 Groovy 源代码和可选的 Java 源代码生成 HTML API 文档。

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

属性

属性描述
访问级别

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

类路径

用于定位文档化源代码所引用类的类路径。

目标目录

生成文档的目录。

文档标题

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

排除项

排除模式集。

页脚

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

groovy类路径

包含要使用的 Groovy 库的类路径。

页眉

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

包含作者

是否包含作者段落。

脚本包含主方法

是否为脚本包含 main 方法。

包含项

包含模式集。

链接

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

无时间戳

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

无版本戳

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

概述文本

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

处理脚本

是否处理脚本。

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

使用

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

窗口标题

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

方法

方法描述
排除(excludeSpec)

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

排除(excludes)

添加 ANT 样式排除模式。此方法可以多次调用以附加新模式,并且可以在单个调用中指定多个模式。如果未提供排除项,则不会排除任何文件。如果提供了排除项,则文件必须不匹配任何排除模式才能进行处理。

排除(excludes)

添加 ANT 样式排除模式。此方法可以多次调用以附加新模式,并且可以在单个调用中指定多个模式。如果未提供排除项,则不会排除任何文件。如果提供了排除项,则文件必须不匹配任何排除模式才能进行处理。

排除(excludeSpec)

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

包含(includeSpec)

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

包含(includes)

添加 ANT 样式包含模式。此方法可以多次调用以附加新模式,并且可以在单个调用中指定多个模式。如果未提供包含项,则此容器中的所有文件都将包含在内。如果提供了包含项,则文件必须匹配至少一个包含模式才能进行处理。

包含(includes)

添加 ANT 样式包含模式。此方法可以多次调用以附加新模式,并且可以在单个调用中指定多个模式。如果未提供包含项,则此容器中的所有文件都将包含在内。如果提供了包含项,则文件必须匹配至少一个包含模式才能进行处理。

包含(includeSpec)

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

链接(url, packages)

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

(sources)

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

脚本块

无脚本块

属性详细信息

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

例如,要包含具有包、受保护和公共访问的类和成员,请使用 GroovydocAccess.PACKAGE

默认使用 groovy 插件
GroovydocAccess.PROTECTED

FileCollection 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 库的类路径。

默认使用 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[]) 进行评估。