集会
程序集的定义。此描述符指定要创建的程序集存档的类型、程序集的内容以及依赖项与程序集捆绑的方式。
程序集定义了通常以归档格式(如 zip、tar 或 tar.gz)分发的文件集合,这些文件由项目生成。例如,一个项目可以生成一个 ZIP 程序集,该程序集在根目录中包含项目的 JAR 工件、在 lib/ 目录中的运行时依赖项以及用于启动独立应用程序的 shell 脚本。
<assembly>
<id/>
<formats/>
<includeBaseDirectory/>
<includeSiteDirectory/>
<moduleSets>
<moduleSet>
<includes/>
<excludes/>
<sources>
<outputDirectory/>
<includes/>
<excludes/>
<fileMode/>
<directoryMode/>
</sources>
<binaries>
<includeDependencies/>
<unpack/>
<outputFileNameMapping/>
<outputDirectory/>
<includes/>
<excludes/>
<fileMode/>
<directoryMode/>
</binaries>
</moduleSet>
</moduleSets>
<fileSets>
<fileSet>
<directory/>
<lineEnding/>
<outputDirectory/>
<includes/>
<excludes/>
<fileMode/>
<directoryMode/>
</fileSet>
</fileSets>
<files>
<file>
<source/>
<outputDirectory/>
<destName/>
<fileMode/>
<lineEnding/>
<filtered/>
</file>
</files>
<dependencySets>
<dependencySet>
<outputFileNameMapping/>
<unpack/>
<scope/>
<outputDirectory/>
<includes/>
<excludes/>
<fileMode/>
<directoryMode/>
</dependencySet>
</dependencySets>
<repositories>
<repository>
<includeMetadata/>
<groupVersionAlignments>
<groupVersionAlignment>
<id/>
<version/>
<excludes/>
</groupVersionAlignment>
</groupVersionAlignments>
<outputDirectory/>
<includes/>
<excludes/>
<fileMode/>
<directoryMode/>
</repository>
</repositories>
<componentDescriptors/>
</assembly>
集会
描述装配布局和包装。
元素 |
描述 |
id
|
此程序集的 ID。这是来自该项目的特定文件程序集的符号名称。
|
formats
|
指定程序集的格式。通过在 <format> 子元素中提供以下值之一来指定格式:
- "zip" - 创建 ZIP 文件格式
- "gz" - 创建 GZIP 格式
- "tar" - 创建一个 TAR 格式
- "tar.gz" - 创建一个 gzip'd TAR 格式
- “tar.bz2 - 创建一个 bzip'd TAR 格式
|
includeBaseDirectory
|
在最终存档中包含一个基本目录。例如,如果您正在创建一个名为“your-app”的程序集,将 includeBaseDirectory 设置为 true 将创建一个包含此基本目录的存档。如果此选项设置为 false,则创建的存档会将其内容解压缩到当前目录。默认值为true 。 |
includeSiteDirectory
|
没有说明。默认值为false 。 |
moduleSets
|
指定要包含在程序集中的模块源文件
|
fileSets
|
为文件组指定装配参数。
|
files
|
为单个文件指定装配参数。
|
dependencySets
|
为依赖项集指定装配行为。
|
repositories
|
指定存储库集的组装行为。
|
componentDescriptors
|
相对于包含组件的 basedir 的文件。
|
模块集
没有说明。
元素 |
描述 |
includes
|
这是 <include> 元素的列表,每个元素都包含一个 groupId:artifactId 类型的模块引用。与这些元素匹配的模块将包含在此集合中。
|
excludes
|
这是 <exclude> 元素的列表,每个元素都包含一个 groupId:artifactId 类型的模块引用。与这些元素匹配的模块将从该集合中排除。
|
sources
|
配置完成后,插件将根据配置在生成的程序集中包含来自该集合的包含模块的源文件。
|
binaries
|
配置后,插件将根据配置在生成的程序集中包含来自该集合的包含模块的二进制文件。
|
来源
用于在程序集中包含模块的源文件的配置。
元素 |
描述 |
outputDirectory
|
指定相对于程序集根目录的根的输出目录。例如,“log”会将指定的文件放在日志目录中。
|
includes
|
当 <include> 子元素存在时,它们定义了一组要包含的文件和目录。
|
excludes
|
当 <exclude> 子元素存在时,它们定义了一组要排除的文件和目录。
|
fileMode
|
类似于 UNIX 权限。格式:(User)(Group)(Other) 其中每个分量是 Read = 4、Write = 2 和 Execute = 1 的总和。例如,默认值 0644 转换为 User read-write、Group 和 Other read -只要。
(更多关于 unix 风格的权限)
默认值为0644 . |
directoryMode
|
类似于 UNIX 权限。格式:(User)(Group)(Other) 其中每个分量是 Read = 4、Write = 2 和 Execute = 1 的总和。例如,默认值 0644 转换为 User read-write、Group 和 Other read -只要。
(更多关于 unix 风格的权限)
默认值为0755 . |
二进制文件
用于在程序集中包含模块的二进制文件的配置。
元素 |
描述 |
includeDependencies
|
如果设置为 true,插件将包含此处包含的项目模块的直接和传递依赖项。否则,它将仅包含模块包。默认值为假。默认值为false 。 |
unpack
|
如果设置为 true,此属性会将所有模块包解压到指定的输出目录中。当设置为 false 时,模块包将作为档案(jar)包含在内。默认值为真。默认值为true 。 |
outputFileNameMapping
|
指定此程序集中包含的所有依赖项的映射模式。默认为 ${artifactId}-${version}.${extension}。默认值为${artifactId}-${version}.${extension} 。 |
outputDirectory
|
指定相对于程序集根目录的根的输出目录。例如,“log”会将指定的文件放在日志目录中。
|
includes
|
当 <include> 子元素存在时,它们定义了一组要包含的文件和目录。
|
excludes
|
当 <exclude> 子元素存在时,它们定义了一组要排除的文件和目录。
|
fileMode
|
类似于 UNIX 权限。格式:(User)(Group)(Other) 其中每个分量是 Read = 4、Write = 2 和 Execute = 1 的总和。例如,默认值 0644 转换为 User read-write、Group 和 Other read -只要。
(更多关于 unix 风格的权限)
默认值为0644 . |
directoryMode
|
类似于 UNIX 权限。格式:(User)(Group)(Other) 其中每个分量是 Read = 4、Write = 2 和 Execute = 1 的总和。例如,默认值 0644 转换为 User read-write、Group 和 Other read -只要。
(更多关于 unix 风格的权限)
默认值为0755 . |
文件集
没有说明。
元素 |
描述 |
directory
|
模块目录中的绝对或相对。例如,“src/main/bin”将选择定义此依赖项的项目的此子目录。
|
lineEnding
|
控制此文件集中文件的行尾。有效值:
- "keep" - 保留所有行尾
- "unix" - 使用 Unix 风格的行尾
- "lf" - 使用单个换行符结束
- "dos" - 使用 DOS 风格的行尾
- "crlf" - 使用 Carraige-return, line-feed 行尾
|
outputDirectory
|
指定相对于程序集根目录的根的输出目录。例如,“log”会将指定的文件放在日志目录中。
|
includes
|
当 <include> 子元素存在时,它们定义了一组要包含的文件和目录。
|
excludes
|
当 <exclude> 子元素存在时,它们定义了一组要排除的文件和目录。
|
fileMode
|
类似于 UNIX 权限。格式:(User)(Group)(Other) 其中每个分量是 Read = 4、Write = 2 和 Execute = 1 的总和。例如,默认值 0644 转换为 User read-write、Group 和 Other read -只要。
(更多关于 unix 风格的权限)
默认值为0644 . |
directoryMode
|
类似于 UNIX 权限。格式:(User)(Group)(Other) 其中每个分量是 Read = 4、Write = 2 和 Execute = 1 的总和。例如,默认值 0644 转换为 User read-write、Group 和 Other read -只要。
(更多关于 unix 风格的权限)
默认值为0755 . |
文件
允许单个文件复制,并带有更改 fileSet 不支持的目标文件名的选项
元素 |
描述 |
source
|
模块目录中的绝对或相对。
|
outputDirectory
|
指定相对于程序集根目录的根的输出目录。例如,“log”会将指定的文件放在日志目录中。
|
destName
|
outputDirectory 中的目标文件名。默认值与源文件的名称相同。
|
fileMode
|
类似于 UNIX 权限。格式:(User)(Group)(Other) 其中每个分量是 Read = 4、Write = 2 和 Execute = 1 的总和。例如,默认值 0644 转换为 User read-write、Group 和 Other read -只要。
(更多关于 unix 风格的权限)
默认值为0644 . |
lineEnding
|
控制此文件集中文件的行尾。有效值为:
- "keep" - 保留所有行尾
- "unix" - 使用 Unix 风格的行尾
- "lf" - 使用单个换行符结束
- "dos" - 使用 DOS 风格的行尾
- "crlf" - 使用 Carraige-return, line-feed 行尾
|
filtered
|
用于确定文件是否被过滤的标志。默认值为false 。 |
依赖集
定义一个依赖集
元素 |
描述 |
outputFileNameMapping
|
指定此程序集中包含的所有依赖项的映射模式。默认为 ${artifactId}-${version}.${extension}。默认值为${artifactId}-${version}.${extension} 。 |
unpack
|
如果设置为 true,此属性会将所有依赖项解压缩到指定的输出目录中。当设置为 false 时,依赖项将被包含为档案(jar)。默认值为假。默认值为false 。 |
scope
|
指定此dependencySet 的依赖范围。默认范围值为“运行时”。默认值为runtime 。 |
outputDirectory
|
指定相对于程序集根目录的根的输出目录。例如,“log”会将指定的文件放在日志目录中。
|
includes
|
当 <include> 子元素存在时,它们定义了一组要包含的文件和目录。
|
excludes
|
当 <exclude> 子元素存在时,它们定义了一组要排除的文件和目录。
|
fileMode
|
类似于 UNIX 权限。格式:(User)(Group)(Other) 其中每个分量是 Read = 4、Write = 2 和 Execute = 1 的总和。例如,默认值 0644 转换为 User read-write、Group 和 Other read -只要。
(更多关于 unix 风格的权限)
默认值为0644 . |
directoryMode
|
类似于 UNIX 权限。格式:(User)(Group)(Other) 其中每个分量是 Read = 4、Write = 2 和 Execute = 1 的总和。例如,默认值 0644 转换为 User read-write、Group 和 Other read -只要。
(更多关于 unix 风格的权限)
默认值为0755 . |
存储库
定义要包含在程序集中的 Maven 存储库。
元素 |
描述 |
includeMetadata
|
如果设置为 true,此属性将触发存储库元数据的创建,这将允许存储库用作功能性远程存储库。默认值为false 。 |
groupVersionAlignments
|
将组与版本或单个工件对齐。 |
outputDirectory
|
指定相对于程序集根目录的根的输出目录。例如,“log”会将指定的文件放在日志目录中。
|
includes
|
当 <include> 子元素存在时,它们定义了一组要包含的文件和目录。
|
excludes
|
当 <exclude> 子元素存在时,它们定义了一组要排除的文件和目录。
|
fileMode
|
类似于 UNIX 权限。格式:(User)(Group)(Other) 其中每个分量是 Read = 4、Write = 2 和 Execute = 1 的总和。例如,默认值 0644 转换为 User read-write、Group 和 Other read -只要。
(更多关于 unix 风格的权限)
默认值为0644 . |
directoryMode
|
类似于 UNIX 权限。格式:(User)(Group)(Other) 其中每个分量是 Read = 4、Write = 2 和 Execute = 1 的总和。例如,默认值 0644 转换为 User read-write、Group 和 Other read -只要。
(更多关于 unix 风格的权限)
默认值为0755 . |
groupVersionAlignment
定义要包含在程序集中的 Maven 存储库。
元素 |
描述 |
id
|
要对齐版本的 groupId。 |
version
|
您要将此组对齐到的版本。 |
excludes
|
您希望从版本对齐中排除的工件的工件 ID。 |