Custom Maven Assembly Descriptors

External

• Custom assembly descriptor reference http://maven.apache.org/components/plugins/maven-assembly-plugin/assembly.html

Internal

• Maven assembly Plugin

Overview

Aside from pre-defined assembly descriptors, Maven allows creation of custom assembly descriptors. Custom assembly descriptors are conventionally placed under src/assembly of the module that executes the plugin.

Example

This is an example of a custom assembly descriptor, used to build a complex release artifact for a multi-module project:

https://github.com/NovaOrdis/events/blob/master/release/src/assembly/release.xml

Elements

Assembly ID

The assembly ID is specified as the value of the <id> element in the assembly descriptor. The presence of the <id> element in the assembly descriptor is mandatory, if it is not specified, Maven will indicate a parsing error.

The assembly ID will become the assembly artifact classifier, present between the version and the extension. For more details on assembly artifact naming rules, see "The Name of the Assembly Artifact" section.