组装：单个

全名：

org.apache.maven.plugins:maven-assembly-plugin:2.2.2:single

说明：

从组装描述符组装应用程序包或分发。此目标适用于绑定到生命周期或直接从命令行调用（前提是在构建开始之前所有必需的文件都可用，或者由命令行上在此之前指定的另一个目标生成）。

属性：

  • 需要执行一个 Maven 项目。
  • 目标是线程安全的并支持并行构建。
  • 在多项目构建中默认不继承。

必需参数

姓名 类型 自从 描述
最终名称 细绳 - 组装的分发文件的文件名。
默认值为：${project.build.finalName}。
输出目录 文件 - 组装分发文件的输出目录。
默认值为：${project.build.directory}。
工作目录 文件 - 如果需要，将 JAR 解压到的目录
默认值为：${project.build.directory}/assembly/work。

可选参数

姓名 类型 自从 描述
appendAssemblyId 布尔值 - 设置为 false 以从程序集最终名称中排除程序集 ID。
默认值为：true。
档案 Maven存档配置 - 这是归档构建器的一组说明，尤其是用于构建 .jar 文件。除了其他选项外，它还允许您为 jar 指定清单文件。
归档基础目录 文件 - 这是创建存档文件的基本目录。此基本目录预先添加到程序集描述符中的任何 <directory>规范中。这是一个可选参数。
归档器配置 丛配置 2.2-β-3 允许特定于特定类型的存档格式的附加配置选项。这旨在捕获 XML 配置，该配置将用于反射性地设置存档器实例上的选项。
例如，要指示具有“ear”格式的程序集使用特定的部署描述符，您应该在插件配置中为 archiverConfig 值指定以下内容：

<appxml>${project.basedir}/somepath/app.xml</appxml>

附 布尔值 2.2-β-1 控制程序集插件是否尝试将生成的程序集附加到项目。
默认值为：true。
分类器 细绳 - 已弃用。请改用大会的 id 作为分类器
描述符 细绳 - 已弃用。请改用描述符
描述符Id 细绳 - 已弃用。请改用descriptorRefs
描述符引用 细绳[] - 插件类路径中可用的程序集描述符的引用列表。默认类路径包括这些内置描述符：bin、jar-with-dependencies、 src和project。您可以通过向插件添加依赖项来添加其他人。
描述符源目录 文件 - 用于扫描描述符文件的目录。注意：这可能不适用于装配组件。
描述符 细绳[] - 要从中生成的描述符文件列表。
干运行 布尔值 - 如果设置了此标志，则调用 Archiver.createArchive() 之前的所有内容都将被执行。
默认值为：false。
编码 细绳 - 过滤资源时要应用的字符编码方案。
默认值为：${project.build.sourceEncoding}。
过滤器 列表 - （没有说明）
格式 列表 - （没有说明）
忽略DirFormatExtensions 布尔值 - 如果设置了此标志，则在使用 assembly/format == 'dir' 和其他以 'dir' 开头的格式时，输出目录名称中的“.dir”后缀将被抑制。
注意：从 2.2-beta-3 开始，默认值为 true，而不是以前的 false。
默认值为：true。
忽略缺失描述符 布尔值 - 设置为 true 以便在缺少描述符时不会失败。
默认值为：false。
忽略权限 布尔值 2.2

设置为true以避免所有 chmod 调用。

注意：这将导致程序集插件 忽略程序集描述符中的所有文件模式/目录模式设置，以及解压依赖项中的所有文件权限！


默认值为：false。
包括站点 布尔值 - 已弃用。请改为在程序集描述符中设置此变量
默认值为：false。
runOnlyAtExecutionRoot 布尔值 2.2-beta-4 这将导致程序集仅在给定模块树的顶部运行。也就是说，在启动 mvn 执行的同一文件夹中包含的项目中运行。
默认值为：false。
跳过组装 布尔值 - 允许将程序集插件的一个或多个执行配置为跳过特定构建的标志。这使得程序集插件更易于从配置文件中控制。
默认值为：false。
tarLongFileMode 细绳 - 在长度超过 100 个字符的文件路径上设置 TarArchiver 行为。有效值为：“warn”（默认）、“fail”、“truncate”、“gnu”或“omit”。
默认值为：警告。
仅更新 布尔值 2.2 这将导致程序集仅更新现有存档（如果存在）。
默认值为：false。
使用JvmChmod 布尔值 2.2

将使用 jvm chmod，这对用户可用，所有级别的组级别将被忽略


默认值为：false。

参数详情

appendAssemblyId：

设置为 false 以从程序集最终名称中排除程序集 ID。
  • 类型：布尔值
  • 要求：否
  • 表达式：${assembly.appendAssemblyId}
  • 默认值：真

存档：

这是归档构建器的一组说明，尤其是用于构建 .jar 文件。除了其他选项外，它还允许您为 jar 指定清单文件。
  • 类型：org.apache.maven.archiver.MavenArchiveConfiguration
  • 要求：否

归档基础目录：

这是创建存档文件的基本目录。此基本目录预先添加到程序集描述符中的任何 <directory>规范中。这是一个可选参数。
  • 类型：java.io.File
  • 要求：否

归档器配置：

允许特定于特定类型的存档格式的附加配置选项。这旨在捕获 XML 配置，该配置将用于反射性地设置存档器实例上的选项。
例如，要指示具有“ear”格式的程序集使用特定的部署描述符，您应该在插件配置中为 archiverConfig 值指定以下内容：

<appxml>${project.basedir}/somepath/app.xml</appxml>
  • 类型：org.codehaus.plexus.configuration.PlexusConfiguration
  • 从: 2.2-beta-3
  • 要求：否

附上：

控制程序集插件是否尝试将生成的程序集附加到项目。
  • 类型：布尔值
  • 自：2.2-beta-1
  • 要求：否
  • 表达式：${assembly.attach}
  • 默认值：真

分类器：

已弃用。请改用大会的 id 作为分类器
这是用于生成的组装工件的工件分类器。通常，您将使用 assembly-id 而不是在此处指定它。
  • 类型：java.lang.String
  • 要求：否
  • 表达式：${分类器}

描述符：

已弃用。请改用描述符
程序集 XML 描述符文件。这必须是自定义描述符文件的路径。
  • 类型：java.lang.String
  • 要求：否
  • 表达式：${descriptor}

描述符标识符：

已弃用。请改用descriptorRefs
预定义的程序集描述符 ID。您可以选择 bin、jar-with-dependencies 或 src。
  • 类型：java.lang.String
  • 要求：否
  • 表达式：${descriptorId}

描述符参考：

插件类路径中可用的程序集描述符的引用列表。默认类路径包括这些内置描述符：bin、jar-with-dependencies、 src和project。您可以通过向插件添加依赖项来添加其他人。
  • 类型：java.lang.String[]
  • 要求：否

描述符源目录：

用于扫描描述符文件的目录。注意：这可能不适用于装配组件。
  • 类型：java.io.File
  • 要求：否

描述符：

要从中生成的描述符文件列表。
  • 类型：java.lang.String[]
  • 要求：否

干运行：

如果设置了此标志，则调用 Archiver.createArchive() 之前的所有内容都将被执行。
  • 类型：布尔值
  • 要求：否
  • 表达式：${assembly.dryRun}
  • 默认值：假

编码：

过滤资源时要应用的字符编码方案。
  • 类型：java.lang.String
  • 要求：否
  • 表达式：${编码}
  • 默认值：${project.build.sourceEncoding}

过滤器：

（没有说明）
  • 类型：java.util.List
  • 要求：否

最终名称：

组装的分发文件的文件名。
  • 类型：java.lang.String
  • 要求：是
  • 默认值：${project.build.finalName}

格式：

（没有说明）
  • 类型：java.util.List
  • 要求：否

忽略目录格式扩展：

如果设置了此标志，则在使用 assembly/format == 'dir' 和其他以 'dir' 开头的格式时，输出目录名称中的“.dir”后缀将被抑制。
注意：从 2.2-beta-3 开始，默认值为 true，而不是以前的 false。
  • 类型：布尔值
  • 要求：否
  • 默认值：真

忽略MissingDescriptor：

设置为 true 以便在缺少描述符时不会失败。
  • 类型：布尔值
  • 要求：否
  • 表达式：${assembly.ignoreMissingDescriptor}
  • 默认值：假

忽略权限：

设置为true以避免所有 chmod 调用。

注意：这将导致程序集插件 忽略程序集描述符中的所有文件模式/目录模式设置，以及解压依赖项中的所有文件权限！

  • 类型：布尔值
  • 从: 2.2
  • 要求：否
  • 表达式：${assembly.ignorePermissions}
  • 默认值：假

包括站点：

已弃用。请改为在程序集描述符中设置此变量
设置为 true 以包含由 site:site 目标生成的站点。
  • 类型：布尔值
  • 要求：否
  • 表达式：${includeSite}
  • 默认值：假

输出目录：

组装分发文件的输出目录。
  • 类型：java.io.File
  • 要求：是
  • 默认值：${project.build.directory}

runOnlyAtExecutionRoot：

这将导致程序集仅在给定模块树的顶部运行。也就是说，在启动 mvn 执行的同一文件夹中包含的项目中运行。
  • 类型：布尔值
  • 自：2.2-beta-4
  • 要求：否
  • 表达式：${assembly.runOnlyAtExecutionRoot}
  • 默认值：假

跳过组装：

允许将程序集插件的一个或多个执行配置为跳过特定构建的标志。这使得程序集插件更易于从配置文件中控制。
  • 类型：布尔值
  • 要求：否
  • 表达式：${assembly.skipAssembly}
  • 默认值：假

tarLongFileMode：

在长度超过 100 个字符的文件路径上设置 TarArchiver 行为。有效值为：“warn”（默认）、“fail”、“truncate”、“gnu”或“omit”。
  • 类型：java.lang.String
  • 要求：否
  • 表达式：${assembly.tarLongFileMode}
  • 默认值：警告

仅更新：

这将导致程序集仅更新现有存档（如果存在）。
  • 类型：布尔值
  • 从: 2.2
  • 要求：否
  • 表达式：${assembly.updatOnly}
  • 默认值：假

使用JvmChmod：

将使用 jvm chmod，这对用户可用，所有级别的组级别将被忽略

  • 类型：布尔值
  • 从: 2.2
  • 要求：否
  • 表达式：${assembly.useJvmChmod}
  • 默认值：假

工作目录：

如果需要，将 JAR 解压到的目录
  • 类型：java.io.File
  • 要求：是
  • 默认值：${project.build.directory}/assembly/work