Apache Maven Assembly Plugin中文文档

原文地址

Apache Maven Assembly Plugin

介绍

Maven的Assembly插件使开发人员能够将项目输出组合到单个可分发的归档文件中，该归档文件还包含依赖项、模块、站点文档和其他文件。

您的项目可以使用一个预制的组装描述符轻松地构建分发“程序集”。这些描述符处理许多常见操作，例如将项目的工件和生成的文档打包到单个zip归档文件中。或者，您的项目可以提供自己的描述符，并对如何在程序集中打包依赖项、模块、文件集和单个文件进行更高级别的控制。

目前它可以创建以下格式的发行:

• zip
• tar
• tar.gz (或 tgz)
• tar.bz2 (或 tbz2)
• tar.snappy
• tar.xz (或 txz)
  jar
  dir
  war
  以及ArchiveManager已配置的任何其他格式

如果您的项目希望将您的构件打包到一个超级jar中，那么程序集插件只提供基本的支持。要进行更多的控制，请使用Maven阴影插件。

什么是 Assembly？

“程序集”是一组文件、目录和依赖项，它们被组装成存档格式并分发。例如，假设一个Maven项目定义了一个包含控制台应用程序和Swing应用程序的JAR工件。这样的项目可以定义两个“程序集”，将应用程序与一组不同的支持脚本和依赖项集捆绑在一起。一个程序集是控制台应用程序的程序集，另一个程序集可以是与一组稍微不同的依赖项绑定的Swing应用程序。

程序集插件提供了一种描述符格式，允许您定义来自项目的文件和目录的任意程序集。例如，如果您的Maven项目包含目录“src/main/bin”，您可以指示程序集插件将该目录的内容复制到程序集的“bin”目录下，并将“bin”目录下文件的权限改为UNIX模式755。配置此行为的参数通过程序集描述符提供给程序集插件。

目标