Ear

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

归档的基本名称。

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

归档名称的扩展名部分。

构建归档文件的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。

是否生成 deploymentDescriptor？

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

包含模式集。

EAR文件中的库目录名称。默认为"lib"。

此JAR归档文件的清单。

用于编码JAR元数据（如文件名）的字符集。默认为UTF-8。您可以更改此属性，但不建议这样做，因为JVM期望JAR元数据使用UTF-8编码。

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

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

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

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

此任务的源文件。

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

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

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

配置此EAR归档文件的部署描述符。

执行给定的闭包以配置部署描述符。DeploymentDescriptor作为其委托传递给闭包。

配置此EAR归档文件的部署描述符。

执行给定的操作以配置部署描述符。

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

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

添加一个排除规范。此方法可以多次调用以附加新规范。给定的闭包传递一个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
 }

为每个路径匹配指定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映射语法指定过滤器属性。

示例

   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()混淆。

添加要包含在EAR归档文件的“lib”目录中的依赖库。

执行给定的闭包以配置CopySpec。CopySpec作为其委托传递给闭包。

添加要包含在EAR归档文件的“lib”目录中的依赖库。

执行给定的操作以配置CopySpec。

配置此JAR归档文件的清单。

执行给定的闭包以配置清单。Manifest作为其委托传递给闭包。

配置此JAR归档文件的清单。

执行给定的操作以配置清单。

将内容添加到此JAR归档文件的META-INF目录中。

执行给定的闭包以配置CopySpec。CopySpec作为其委托传递给闭包。

将内容添加到此JAR归档文件的META-INF目录中。

执行给定的操作以配置CopySpec。

重命名源文件。闭包将使用单个参数，即文件名。闭包应返回一个带有新目标名称的字符串对象。闭包可以返回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
}