Zip

归档名称的附加部分（如果存在）。

归档文件的基本名称。

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

归档名称的扩展部分。

归档文件构建成的 RegularFile。其路径简单来说就是 destinationDirectory 加上 archiveFileName。

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

归档名称的版本部分。

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

归档文件将被放置的目录。

用于查询和配置目录访问权限的属性。如果未设置属性值，则表示保留现有权限。这些权限是否实际应用取决于复制操作的实现。详情请参见 ConfigurableFilePermissions。

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

该值可以通过枚举值的忽略大小写的字符串来设置（例如，对于 DuplicatesStrategy.EXCLUDE 设置为 'exclude'）。

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

归档条目的压缩级别。如果设置为 ZipEntryCompression.DEFLATED（默认值），每个条目使用 DEFLATE 算法压缩。如果设置为 ZipEntryCompression.STORED，归档条目则不进行压缩。

排除模式集合。

用于查询和配置文件访问权限的属性。如果未设置属性值，则表示保留现有权限。这些权限是否实际应用取决于复制操作的实现。详情请参见 ConfigurableFilePermissions。

指示是否将空目标目录包含在复制中。

包含模式集合。

用于编码 ZIP 元数据（如文件名）的字符集。默认为平台的默认字符集。

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

如果设置为 false，这将确保不同机器、Java 版本和操作系统之间构建的归档条目具有相同的时间戳。

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

Gradle 将以一种与文件系统和操作系统无关的可重现顺序遍历作为此归档一部分的磁盘目录。这有助于 Gradle 可靠地生成字节完全一致的可重现归档文件。

此任务的源文件。

指示 zip 是否可以包含超过 65535 个文件以及/或者支持大于 4GB 的文件。

标准 zip 格式对文件大小和数量有硬性限制。Zip64 格式扩展 实际上取消了这些限制，因此对于构建大型 zip 文件是必需的。

然而，并非所有 Zip 读取器都支持 Zip64 扩展。值得注意的是，Java 7 之前的 JDK ZipInputStream 类不支持 Zip64。这意味着如果您正在构建用于 Java 6 及更早版本运行时的 JAR 文件，则不应启用此属性。

添加一个操作，该操作将在每个文件即将复制到其目标位置时应用。给定的闭包以 FileCopyDetails 作为参数调用。操作按照添加的顺序执行，并从父规范继承。

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

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

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

如果未提供 excludes，则不会排除任何文件。如果提供了 excludes，则文件必须与任何排除模式都不匹配才能进行处理。

添加一个 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
 }

为路径匹配任何指定 Ant 风格模式的每个文件配置 FileCopyDetails。这等同于使用 eachFile() 并根据文件路径选择性地应用配置。

为路径匹配指定 Ant 风格模式的每个文件配置 FileCopyDetails。这等同于使用 eachFile() 并根据文件路径选择性地应用配置。

为路径不匹配任何指定 Ant 风格模式的每个文件配置 FileCopyDetails。这等同于使用 eachFile() 并根据文件路径选择性地应用配置。

为路径不匹配指定 Ant 风格模式的每个文件配置 FileCopyDetails。这等同于使用 eachFile() 并根据文件路径选择性地应用配置。

基于提供的闭包添加内容过滤器。闭包将以每一行（已去除行尾）作为参数调用，并应返回一个字符串替换该行，或者返回 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 过滤器。

可以使用 Groovy Map 语法指定过滤属性。

示例

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

基于提供的转换器添加内容过滤器。闭包将以每一行（已去除行尾）作为参数调用，并应返回一个字符串替换该行，或者返回 null 以移除该行。如果移除所有行，结果将是一个空文件，而不是一个不存在的文件。

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

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

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

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

添加一个 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
}