API 文档 | Groovydoc |
---|
为 Groovy 源码(可选 Java 源码)生成 HTML API 文档。
此任务使用 Groovy 的 Groovydoc 工具生成 API 文档。请注意 Groovydoc 工具目前存在一些限制。使用的 Groovydoc 版本是构建脚本中定义的 Groovy 依赖的版本。
属性 | 描述 |
access | 在 Groovydoc 中包含的最严格的访问级别。 |
classpath | 用于查找文档化源码引用的类的 classpath。 |
destinationDir | 生成文档的目标目录。 |
docTitle | 包索引(首页)的标题。如果没有文档标题,则设置为 |
excludes | 排除模式集。 |
footer | 每页的 HTML 页脚。如果没有页脚,则设置为 |
groovyClasspath | 包含要使用的 Groovy 库的 classpath。 |
header | 每页的 HTML 页眉。如果没有页眉,则设置为 |
includeAuthor | 是否包含作者段落。 |
includeMainForScripts | 是否包含脚本的 main 方法。 |
includes | 包含模式集。 |
links | 指向给定 URL 处 groovydoc/javadoc 输出的链接。 |
noTimestamp | 生成的 HTML 隐藏注释中是否包含时间戳(Groovy >= 2.4.6)。 |
noVersionStamp | 生成的 HTML 隐藏注释中是否包含版本戳(Groovy >= 2.4.6)。 |
overviewText | 返回用于概览文档的 HTML 文本。如果没有概览文本,则设置为 |
processScripts | 是否处理脚本。 |
source | 应用包含和排除模式后,此任务的源码。忽略不存在的源码文件。 |
use | 是否创建类和包使用情况页面。 |
windowTitle | 文档的浏览器窗口标题。如果没有窗口标题,则设置为 |
方法 | 描述 |
exclude(excludeSpec) | 添加排除规范。此方法可以多次调用以追加新的规范。给定闭包会接收一个 |
exclude(excludes) | 添加 ANT 风格的排除模式。此方法可以多次调用以追加新的模式,也可以在一次调用中指定多个模式。如果没有提供排除模式,则不会排除任何文件。如果提供了排除模式,则文件必须不匹配任何排除模式才能被处理。 |
exclude(excludes) | 添加 ANT 风格的排除模式。此方法可以多次调用以追加新的模式,也可以在一次调用中指定多个模式。如果没有提供排除模式,则不会排除任何文件。如果提供了排除模式,则文件必须不匹配任何排除模式才能被处理。 |
exclude(excludeSpec) | 添加排除规范。此方法可以多次调用以追加新的规范。如果没有提供排除项,则不会排除任何文件。如果提供了排除项,则文件必须不匹配任何排除模式才能被处理。 |
include(includeSpec) | 添加包含规范。此方法可以多次调用以追加新的规范。给定闭包会接收一个 |
include(includes) | 添加 ANT 风格的包含模式。此方法可以多次调用以追加新的模式,也可以在一次调用中指定多个模式。如果没有提供包含模式,则此容器中的所有文件都将被包含。如果提供了包含模式,则文件必须至少匹配一个包含模式才能被处理。 |
include(includes) | 添加 ANT 风格的包含模式。此方法可以多次调用以追加新的模式,也可以在一次调用中指定多个模式。如果没有提供包含模式,则此容器中的所有文件都将被包含。如果提供了包含模式,则文件必须至少匹配一个包含模式才能被处理。 |
include(includeSpec) | 添加包含规范。此方法可以多次调用以追加新的规范。如果没有提供包含项,则此容器中的所有文件都将被包含。如果提供了包含项,则文件必须至少匹配一个包含模式或规范才能被包含。 |
link(url, packages) | 添加指向给定 URL 处 groovydoc/javadoc 输出的链接。 |
source(sources) | 向此任务添加一些源码。给定的源码对象将按照 |
Property
<GroovydocAccess
>
access
Property
<GroovydocAccess
>在 Groovydoc 中包含的最严格的访问级别。
例如,要包含具有 package、protected 和 public 访问权限的类和成员,请使用 GroovydocAccess.PACKAGE
。
groovy
插件的默认值GroovydocAccess.PROTECTED
FileCollection
classpath
用于查找文档化源码引用的类的 classpath。
groovy
插件的默认值sourceSets.main.output + sourceSets.main.compileClasspath
FileTree
source
(只读)
应用包含和排除模式后,此任务的源码。忽略不存在的源码文件。
源码的 PathSensitivity
被配置为 PathSensitivity.ABSOLUTE
。如果您的源码不太严格,请在子类中覆盖此方法并进行相应修改。
groovy
插件的默认值sourceSets.main.groovy
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)
Iterable
<String
>添加 ANT 风格的排除模式。此方法可以多次调用以追加新的模式,也可以在一次调用中指定多个模式。如果没有提供排除模式,则不会排除任何文件。如果提供了排除模式,则文件必须不匹配任何排除模式才能被处理。
SourceTask
exclude
(String
...
excludes)
String
...添加 ANT 风格的排除模式。此方法可以多次调用以追加新的模式,也可以在一次调用中指定多个模式。如果没有提供排除模式,则不会排除任何文件。如果提供了排除模式,则文件必须不匹配任何排除模式才能被处理。
SourceTask
exclude
(Spec
<FileTreeElement
>
excludeSpec)
Spec
<FileTreeElement
>添加排除规范。此方法可以多次调用以追加新的规范。如果没有提供排除项,则不会排除任何文件。如果提供了排除项,则文件必须不匹配任何排除模式才能被处理。
SourceTask
include
(Closure
includeSpec)
添加包含规范。此方法可以多次调用以追加新的规范。给定闭包会接收一个 FileTreeElement
作为参数。如果没有提供包含项,则此容器中的所有文件都将被包含。如果提供了包含项,则文件必须至少匹配一个包含模式或规范才能被包含。
SourceTask
include
(Iterable
<String
>
includes)
Iterable
<String
>添加 ANT 风格的包含模式。此方法可以多次调用以追加新的模式,也可以在一次调用中指定多个模式。如果没有提供包含模式,则此容器中的所有文件都将被包含。如果提供了包含模式,则文件必须至少匹配一个包含模式才能被处理。
SourceTask
include
(String
...
includes)
String
...添加 ANT 风格的包含模式。此方法可以多次调用以追加新的模式,也可以在一次调用中指定多个模式。如果没有提供包含模式,则此容器中的所有文件都将被包含。如果提供了包含模式,则文件必须至少匹配一个包含模式才能被处理。
SourceTask
include
(Spec
<FileTreeElement
>
includeSpec)
Spec
<FileTreeElement
>添加包含规范。此方法可以多次调用以追加新的规范。如果没有提供包含项,则此容器中的所有文件都将被包含。如果提供了包含项,则文件必须至少匹配一个包含模式或规范才能被包含。
SourceTask
source
(Object
...
sources)
Object
...向此任务添加一些源码。给定的源码对象将按照 Project.files(java.lang.Object[])
进行评估。