资源:复制资源

全名

org.apache.maven.plugins:maven-resources-plugin:3.2.0:copy-resources

说明

复制配置的插件属性资源的资源

属性

  • 需要执行一个 Maven 项目。
  • 自版本:2.3

必需参数

姓名 类型 自从 描述
<输出目录> 文件 2.3 要将资源复制到其中的输出目录。
<资源> 列表 2.3 我们要转移的资源列表。有关如何编码资源元素的描述,请参阅 Maven 模型。

可选参数

姓名 类型 自从 描述
<addDefaultExcludes> 布尔值 3.0.0 默认情况下,诸如.gitignore.cvsignore等文件被排除在外,这意味着它们不会被复制。如果您出于特定原因需要它们,您可以通过将其设置为false来做到这一点。这意味着将复制以下所有文件。
  • 其他:**/*~、**/#*#、**/.#*、**/%*%、**/._*
  • CVS:**/CVS,**/CVS/**,**/.cvsignore
  • RCS:**/RCS,**/RCS/**
  • SCCS: **/SCCS, **/SCCS/**
  • VSSercer:**/vssver.scc
  • MKS:**/project.pj
  • SVN:**/.svn,**/.svn/**
  • GNU: **/.arch-ids, **/.arch-ids/**
  • 集市:**/.bzr,**/.bzr/**
  • SurroundSCM: **/.MySCMServerInfo
  • Mac:**/.DS_Store
  • 瑟琳娜维度:**/.metadata, **/.metadata/**
  • Mercurial: **/.hg, **/.hg/**
  • GIT:**/.git,**/.gitignore,**/.gitattributes,**/.git/**
  • Bitkeeper: **/BitKeeper, **/BitKeeper/**, **/ChangeSet, **/ChangeSet/**
  • Darcs:**/_darcs、**/_darcs/**、**/.darcsrepo、**/.darcsrepo/****/-darcs-backup*、**/.darcs-temp-mail

默认值为true
<分隔符> 链接哈希集 2.4

用于在资源中过滤的表达式的分隔符集。这些定界符以beginToken*endToken形式指定 。如果没有给出*,则假定开始和结束的分隔符相同。

因此,默认过滤分隔符可以指定为:

<delimiters>
  <delimiter>${*}</delimiter>
  <delimiter>@</delimiter>
</delimiters>

由于@定界符在两端是相同的,我们不需要指定@*@(尽管我们可以)。


<编码> 细绳 2.3 读取和写入过滤资源时使用的字符编码。
默认值为${project.build.sourceEncoding}
<转义字符串> 细绳 2.3 不会插入以该字符串开头的表达式。此字符串前面的任何其他内容都将不变地传递。例如${foo } 将替换为 ${foo } 但\${foo } 将替换 为 foo 的 \value,如果此参数已设置为反斜杠。
<escapeWindowsPaths> 布尔值 2.4 是否在 windows 风格的路径中转义反斜杠和冒号。
默认值为true
<文件名过滤> 布尔值 3.0.0 支持过滤文件名文件夹等。
默认值为false
<过滤器> 列表 2.3

要使用的额外过滤器属性文件列表,以及在 POM 构建/过滤器部分中指定的系统属性、项目属性和过滤器属性文件,这些文件应该用于当前 mojo 执行期间的过滤。

通常,这些将从插件的执行部分配置,为特定执行提供一组不同的过滤器。例如,从 Maven 2.2.0 开始,您可以选择使用 id 的 default-resourcesdefault-testResources配置执行,以便为两种不同类型的资源提供不同的配置。通过提供extraFilters配置,您可以区分哪些过滤器用于哪种类型的资源。


<includeEmptyDirs> 布尔值 2.3 复制资源中包含的任何空目录。
默认值为false
<mavenFilteringHints> 列表 2.4

实现 MavenResourcesFiltering.filterResources()的丛组件提示列表。它们将在资源复制/过滤后执行。


<nonFilteredFileExtensions> 列表 2.3 不应用过滤的附加文件扩展名(已定义为:jpg、jpeg、gif、bmp、png)
<覆盖> 布尔值 2.3 即使目标文件较新,也要覆盖现有文件。
默认值为false
<属性编码> 细绳 3.2.0 读取和写入过滤属性文件时使用的字符编码。如果未指定,则默认为“encoding”参数的值。
<跳过> 布尔值 3.0.0 如果需要,您可以跳过插件的执行。不推荐使用它,但有时很方便。
默认值为false
用户属性是maven.resources.skip
<supportMultiLineFiltering> 布尔值 2.5 在行尾停止搜索 endToken
默认值为false
<使用构建过滤器> 布尔值 2.4 如果为 false,则在此 mojo 执行中处理资源时不要使用 POM 的 build/filters 部分中指定的过滤器。
默认值为true
<使用默认分隔符> 布尔值 2.4 除了自定义分隔符(如果有)之外,使用默认分隔符。
默认值为true

参数详情

<addDefaultExcludes>

默认情况下,诸如.gitignore.cvsignore等文件被排除在外,这意味着它们不会被复制。如果您出于特定原因需要它们,您可以通过将其设置为false来做到这一点。这意味着将复制以下所有文件。
  • 其他:**/*~、**/#*#、**/.#*、**/%*%、**/._*
  • CVS:**/CVS,**/CVS/**,**/.cvsignore
  • RCS:**/RCS,**/RCS/**
  • SCCS: **/SCCS, **/SCCS/**
  • VSSercer:**/vssver.scc
  • MKS:**/project.pj
  • SVN:**/.svn,**/.svn/**
  • GNU: **/.arch-ids, **/.arch-ids/**
  • 集市:**/.bzr,**/.bzr/**
  • SurroundSCM: **/.MySCMServerInfo
  • Mac:**/.DS_Store
  • 瑟琳娜维度:**/.metadata, **/.metadata/**
  • Mercurial: **/.hg, **/.hg/**
  • GIT:**/.git,**/.gitignore,**/.gitattributes,**/.git/**
  • Bitkeeper: **/BitKeeper, **/BitKeeper/**, **/ChangeSet, **/ChangeSet/**
  • Darcs:**/_darcs、**/_darcs/**、**/.darcsrepo、**/.darcsrepo/****/-darcs-backup*、**/.darcs-temp-mail
  • 类型布尔值
  • 3.0.0
  • 要求
  • 默认值

<分隔符>

用于在资源中过滤的表达式的分隔符集。这些定界符以beginToken*endToken形式指定 。如果没有给出*,则假定开始和结束的分隔符相同。

因此,默认过滤分隔符可以指定为:

<delimiters>
  <delimiter>${*}</delimiter>
  <delimiter>@</delimiter>
</delimiters>

由于@定界符在两端是相同的,我们不需要指定@*@(尽管我们可以)。

  • 类型java.util.LinkedHashSet
  • : 2.4
  • 要求

<编码>

读取和写入过滤资源时使用的字符编码。
  • 类型java.lang.String
  • : 2.3
  • 要求
  • 默认值${project.build.sourceEncoding}

<转义字符串>

不会插入以该字符串开头的表达式。此字符串前面的任何其他内容都将不变地传递。例如${foo } 将替换为 ${foo } 但\${foo } 将替换 为 foo 的 \value,如果此参数已设置为反斜杠。
  • 类型java.lang.String
  • : 2.3
  • 要求

<escapeWindowsPaths>

是否在 windows 风格的路径中转义反斜杠和冒号。
  • 类型布尔值
  • : 2.4
  • 要求
  • 默认值

<文件名过滤>

支持过滤文件名文件夹等。
  • 类型布尔值
  • 3.0.0
  • 要求
  • 默认值

<过滤器>

要使用的额外过滤器属性文件列表,以及在 POM 构建/过滤器部分中指定的系统属性、项目属性和过滤器属性文件,这些文件应该用于当前 mojo 执行期间的过滤。

通常,这些将从插件的执行部分配置,为特定执行提供一组不同的过滤器。例如,从 Maven 2.2.0 开始,您可以选择使用 id 的 default-resourcesdefault-testResources配置执行,以便为两种不同类型的资源提供不同的配置。通过提供extraFilters配置,您可以区分哪些过滤器用于哪种类型的资源。

  • 类型java.util.List
  • : 2.3
  • 要求

<includeEmptyDirs>

复制资源中包含的任何空目录。
  • 类型布尔值
  • : 2.3
  • 要求
  • 默认值

<mavenFilteringHints>

实现 MavenResourcesFiltering.filterResources()的丛组件提示列表。它们将在资源复制/过滤后执行。

  • 类型java.util.List
  • : 2.4
  • 要求

<nonFilteredFileExtensions>

不应用过滤的附加文件扩展名(已定义为:jpg、jpeg、gif、bmp、png)
  • 类型java.util.List
  • : 2.3
  • 要求

<输出目录>

要将资源复制到其中的输出目录。
  • 类型java.io.File
  • : 2.3
  • 要求

<覆盖>

即使目标文件较新,也要覆盖现有文件。
  • 类型布尔值
  • : 2.3
  • 要求
  • 默认值

<属性编码>

读取和写入过滤属性文件时使用的字符编码。如果未指定,则默认为“encoding”参数的值。
  • 类型java.lang.String
  • 3.2.0
  • 要求

<资源>

我们要转移的资源列表。有关如何编码资源元素的描述,请参阅 Maven 模型。
  • 类型java.util.List
  • : 2.3
  • 要求

<跳过>

如果需要,您可以跳过插件的执行。不推荐使用它,但有时很方便。
  • 类型布尔值
  • 3.0.0
  • 要求
  • 用户属性maven.resources.skip
  • 默认值

<supportMultiLineFiltering>

停止在行尾搜索 endToken
  • 类型布尔值
  • : 2.5
  • 要求
  • 默认值

<使用构建过滤器>

如果为 false,则在此 mojo 执行中处理资源时不要使用 POM 的 build/filters 部分中指定的过滤器。
  • 类型布尔值
  • : 2.4
  • 要求
  • 默认值

<使用默认分隔符>

除了自定义分隔符(如果有)之外,使用默认分隔符。
  • 类型布尔值
  • : 2.4
  • 要求
  • 默认值