柏油

存档名称的附录部分（如果有）。

存档的基本名称。

存档名称的分类器部分（如果有）。

存档名称的扩展部分。

RegularFile构建档案的位置。路径就是简单的destinationDirectory加号archiveFileName。

档案名称。如果未显式设置名称，则名称的模式为： [archiveBaseName]-[archiveAppendix]-[archiveVersion]-[archiveClassifier].[archiveExtension]

存档名称的版本部分。

指定是否应使用区分大小写的模式匹配。

用于此存档的压缩。

将放置存档的目录。

用于配置目录访问权限的属性。详细信息请参见ConfigurableFilePermissions。

尝试将多个文件复制到同一目标时使用的策略。

该值可以使用枚举值的不区分大小写的字符串来设置（例如'exclude'for DuplicatesStrategy.EXCLUDE）。

CopySpec.eachFile(org.gradle.api.Action)可以使用或 为单个文件覆盖此策略CopySpec.filesMatching(java.lang.String, org.gradle.api.Action)。

排除模式集。

用于配置文件访问权限的属性。详细信息请参见ConfigurableFilePermissions。

告知空目标目录是否将包含在副本中。

包含模式集。

指定是否应在存档中保留文件时间戳。

如果false这可以确保归档条目在不同机器、Java 版本和操作系统之间的构建具有相同的时间。

指定从目录读取文件时是否强制执行可重现的文件顺序。

然后，Gradle 将以独立于文件系统和操作系统的可重现顺序遍历磁盘上的目录，这些目录是此存档的一部分。这有助于 Gradle 可靠地生成逐字节可重现的存档。

此任务的源文件。

添加一个要在每个文件将被复制到其目标时应用的操作。给定的闭包以 aFileCopyDetails作为参数来调用。操作按照添加的顺序执行，并且继承自父规范。

添加要在每个文件即将复制到其目标时应用于该文件的操作。该操作可以更改文件的目标路径、过滤文件的内容或从结果中完全排除文件。操作按照添加的顺序执行，并且继承自父规范。

添加排除规范。可以多次调用此方法来附加新规范。给定的闭包将 FileTreeElement作为其参数传递。闭包应该返回 true 或 false。例子：

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

如果未提供排除，则不会排除任何文件。如果提供了排除，则文件不得与要处理的任何排除模式匹配。

添加 ANT 样式排除模式。可以多次调用此方法以附加新模式，并且可以在一次调用中指定多个模式。如果未提供排除，则不会排除任何文件。如果提供了排除，则文件不得与要处理的任何排除模式匹配。

添加 ANT 样式排除模式。可以多次调用此方法以附加新模式，并且可以在一次调用中指定多个模式。如果未提供排除，则不会排除任何文件。如果提供了排除，则文件不得与要处理的任何排除模式匹配。

添加排除规范。可以多次调用此方法来附加新规范。如果未提供排除，则不会排除任何文件。如果提供了排除，则文件不得与要处理的任何排除模式匹配。

在复制每个文件时扩展其属性引用。更具体地说，每个文件都使用 Groovy 的SimpleTemplateEngine.这意味着您可以使用简单的属性引用，例如 文件中的$property或。${property}您还可以在文件中包含任意 Groovy 代码，例如${version ?: 'unknown'}或${classpath*.name.join(' ')}

请注意，所有转义序列（\n、\t、\\等）都会转换为它们表示的符号，例如，\n变成换行符。如果这是不希望的，那么ContentFilterable.expand(java.util.Map, org.gradle.api.Action) 应该用来禁用此行为。

在复制每个文件时扩展其属性引用。更具体地说，每个文件都使用 Groovy 的SimpleTemplateEngine.这意味着您可以使用简单的属性引用，例如 文件中的$property或。${property}您还可以在文件中包含任意 Groovy 代码，例如${version ?: 'unknown'}或${classpath*.name.join(' ')}。可以使用提供的操作来配置模板引擎。

请注意，默认情况下，所有转义序列（\n、\t、\\等）都会转换为它们表示的符号，例如，\n变成换行符。此行为受属性控制 ExpandDetails.getEscapeBackslash()。应将其设置为true禁用转义序列转换：

expand(one: '1', two: 2) {
    escapeBackslash = true
}

FileCopyDetails为其路径与任何指定 Ant 样式模式匹配的每个文件配置。这相当于使用eachFile()并根据文件的路径有选择地应用配置。

FileCopyDetails为每个路径与指定 Ant 样式模式匹配的文件配置。这相当于使用eachFile()并根据文件的路径有选择地应用配置。

FileCopyDetails为每个其路径与任何指定 Ant 样式模式不匹配的文件配置。这相当于使用eachFile()并根据文件的路径有选择地应用配置。

FileCopyDetails为每个路径与指定 Ant 样式模式不匹配的文件配置。这相当于使用eachFile()并根据文件的路径有选择地应用配置。

根据提供的闭包添加内容过滤器。闭包将在每一行中被调用（go除行结尾），并且应该返回一个字符串来替换该行或null删除该行。如果删除每一行，结果将是一个空文件，而不是缺失的文件。

添加要在复制过程中使用的内容过滤器。多次调用filter，将额外的过滤器添加到过滤器链中。每个过滤器都应该实现java.io.FilterReader.包括org.apache.tools.ant.filters.*用于访问所有标准 Ant 过滤器。

例子：

filter(StripJavaComments)
filter(com.mycompany.project.CustomFilter)

添加要在复制过程中使用的内容过滤器。多次调用filter，将额外的过滤器添加到过滤器链中。每个过滤器都应该实现java.io.FilterReader.包括org.apache.tools.ant.filters.*用于访问所有标准 Ant 过滤器。

过滤器属性可以使用常规映射语法来指定。

例子：

filter(HeadFilter, lines:25, skip:2)
filter(ReplaceTokens, tokens:[copyright:'2009', version:'2.3.1'])

基于提供的转换器添加内容过滤器。闭包将在每一行中被调用（go除行结尾），并且应该返回一个字符串来替换该行或null删除该行。如果删除每一行，结果将是一个空文件，而不是缺失的文件。

指定副本的源文件或目录并创建子副本CopySourceSpec。给定的源路径按照 进行评估Project.files(java.lang.Object[])。

指定副本的源文件或目录并创建子副本CopySpec。给定的源路径按照 进行评估Project.files(java.lang.Object[])。

指定副本的源文件或目录。给定的路径按照 进行评估Project.files(java.lang.Object[])。

添加包含规范。可以多次调用此方法来附加新规范。给定的闭包将 aFileTreeElement作为其参数传递 。如果未提供包含，则将包含此容器中的所有文件。如果提供了包含，则文件必须至少匹配要包含的包含模式或规范之一。

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

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

添加包含规范。可以多次调用此方法来附加新规范。如果未提供包含，则将包含此容器中的所有文件。如果提供了包含，则文件必须至少匹配要包含的包含模式或规范之一。

指定文件存档*内部*的目标目录。目的地按照 进行评估Project.file(java.lang.Object)。不要将它与AbstractArchiveTask.getDestinationDirectory()指定存档的输出目录混淆。

创建并配置一个子级CopySpec，其目标目录*位于*文件的存档中。目的地按照 进行评估Project.file(java.lang.Object)。不要将它与AbstractArchiveTask.getDestinationDirectory()指定存档的输出目录混淆。

创建并配置一个子级CopySpec，其目标目录*位于*文件的存档中。目的地按照 进行评估Project.file(java.lang.Object)。不要将它与AbstractArchiveTask.getDestinationDirectory()指定存档的输出目录混淆。

重命名源文件。将使用单个参数（文件名）调用闭包。闭包应该返回一个带有新目标名称的 String 对象。闭包可能返回 null，在这种情况下将使用原始名称。

根据正则表达式重命名文件。使用 java.util.regex 类型的正则表达式。请注意，替换字符串应使用“$1”语法来引用源正则表达式中的捕获组。与源正则表达式不匹配的文件将使用原始名称进行复制。

例子：

rename '(.*)_OEM_BLUE_(.*)', '$1$2'

会将文件“style_OEM_BLUE_.css”映射到“style.css”

根据正则表达式重命名文件。看CopyProcessingSpec.rename(java.lang.String, java.lang.String)。

重命名源文件。该函数将使用单个参数（文件名）进行调用。该函数应返回一个新的目标名称。该函数可能返回 null，在这种情况下将使用原始名称。

将给定规格添加为该规格的子项。

def contentSpec = copySpec {
  from("content") {
    include "**/*.txt"
  }
}

task copy(type: Copy) {
  into "$buildDir/copy"
  with contentSpec
}