The Assembly Descriptor
This section is a tour of the assembly descriptor, which contains some guidelines for developing a custom assembly descriptor. The Assembly plugin is one of the largest plugins in the Maven ensemble, and one of the most flexible.
Property References in Assembly Descriptors
Any property discussed in the section Maven Propertiesâ in Chapter 13 can be referenced in an assembly descriptor. Before any assembly descriptor is used by Maven, it is interpolated using information from the POM and the current build environment. All properties supported for interpolation within the POM itself are valid for use in assembly descriptors, including POM properties, POM element values, system properties, user-defined properties, and operating-system environment variables.
The only exceptions to this interpolation step are elements in
various sections of the descriptor
named outputDirectory
,
outputDirectoryMapping
, or outputFileNameMapping
. The reason
these are held back in their raw form is to allow artifact- or
module-specific information to be applied when resolving expressions
in these values, on a per-item basis.
Required Assembly Information
Two essential pieces of information are required for every
assembly: the id
and the list of
archive formats to produce. In practice, at least one other section
of the descriptor is required, since most archive format components
will choke if they donât have at least one file to include. But
without at least one format
and an
id
, there ...
Get Maven: The Definitive Guide now with the O’Reilly learning platform.
O’Reilly members experience books, live events, courses curated by job role, and more from O’Reilly and nearly 200 top publishers.