assembly:directory-inline

Full name:

org.apache.maven.plugins:maven-assembly-plugin:2.2-beta-4:directory-inline

This plugin goal has been deprecated:

Use goal: 'directory' (from the command line) or 'directory-single' (from a lifecycle binding) instead.

Description:

Like the assembly:attached goal, assemble an application bundle or distribution from an assembly descriptor, WITHOUT first forcing Maven to build all POMs to the package phase (as is required by the assembly:assembly goal). This goal differs from assembly:attached in that it ignores the <formats/> section of the assembly descriptor, and forces the assembly to be created as a directory in the project's build-output directory (usually ./target).
This goal is also functionally equivalent to using the assembly:attached goal in conjunction with the dir assembly format.
NOTE: This goal should ONLY be run from the command line, and if building a multimodule project it should be used from the root POM. Use the assembly:directory-single goal for binding your assembly to the lifecycle.

Attributes:

  • Requires a Maven 2.0 project to be executed.
  • Executes as an aggregator plugin.

Required Parameters

Name Type Since Description
finalName String - The filename of the assembled distribution file.
Default value is: ${project.build.finalName}.
outputDirectory File - The output directory of the assembled distribution file.
Default value is: ${project.build.directory}.
workDirectory File - Directory to unpack JARs into if needed
Default value is: ${project.build.directory}/assembly/work.

Optional Parameters

Name Type Since Description
appendAssemblyId boolean - Set to false to exclude the assembly id from the assembly final name.
Default value is: true.
archive MavenArchiveConfiguration - This is a set of instructions to the archive builder, especially for building .jar files. It enables you to specify a Manifest file for the jar, in addition to other options.
archiveBaseDirectory File - This is the base directory from which archive files are created. This base directory pre-pended to any <directory> specifications in the assembly descriptor. This is an optional parameter.
archiverConfig PlexusConfiguration 2.2-beta-3 Allows additional configuration options that are specific to a particular type of archive format. This is intended to capture an XML configuration that will be used to reflectively setup the options on the archiver instance.
For instance, to direct an assembly with the "ear" format to use a particular appXml file, you should specify the following for the archiverConfig value in your plugin configuration: 
<appXml>${project.basedir}/somepath/app.xml</appXml>

attach boolean 2.2-beta-1 Controls whether the assembly plugin tries to attach the resulting assembly to the project.
Default value is: true.
classifier String - Deprecated. {0}. Please use the Assembly's id for classifier instead
descriptor String - Deprecated. {0}. Please use descriptors instead
descriptorId String - Deprecated. {0}. Please use descriptorRefs instead
descriptorRefs String[] - A list of built-in descriptor references to generate from. You can select from bin, jar-with-dependencies, or src.
descriptorSourceDirectory File - Directory to scan for descriptor files in.
descriptors String[] - A list of descriptor files to generate from.
dryRun boolean - If this flag is set, everything up to the call to Archiver.createArchive() will be executed.
Default value is: false.
filters List - (no description)
ignoreDirFormatExtensions boolean - If this flag is set, the ".dir" suffix will be suppressed in the output directory name when using assembly/format == 'dir' and other formats that begin with 'dir'.
NOTE: Since 2.2-beta-3, the default-value for this is true, NOT false as it used to be.
Default value is: true.
ignoreMissingDescriptor boolean - Set to true in order to not fail when a descriptor is missing.
Default value is: false.
includeSite boolean - Deprecated. {0}. Please set this variable in the assembly descriptor instead
Default value is: false.
runOnlyAtExecutionRoot boolean 2.2-beta-4 This will cause the assembly to run only at the top of a given module tree. That is, run in the project contained in the same folder where the mvn execution was launched.
Default value is: false.
skipAssembly boolean - Flag allowing one or more executions of the assembly plugin to be configured as skipped for a particular build. This makes the assembly plugin more controllable from profiles.
Default value is: false.
tarLongFileMode String - Sets the TarArchiver behavior on file paths with more than 100 characters length. Valid values are: "warn" (default), "fail", "truncate", "gnu", or "omit".
Default value is: warn.

Parameter Details

appendAssemblyId:

Set to false to exclude the assembly id from the assembly final name.
  • Type: boolean
  • Required: No
  • Expression: ${appendAssemblyId}
  • Default: true

archive:

This is a set of instructions to the archive builder, especially for building .jar files. It enables you to specify a Manifest file for the jar, in addition to other options.
  • Type: org.apache.maven.archiver.MavenArchiveConfiguration
  • Required: No

archiveBaseDirectory:

This is the base directory from which archive files are created. This base directory pre-pended to any <directory> specifications in the assembly descriptor. This is an optional parameter.
  • Type: java.io.File
  • Required: No

archiverConfig:

Allows additional configuration options that are specific to a particular type of archive format. This is intended to capture an XML configuration that will be used to reflectively setup the options on the archiver instance.
For instance, to direct an assembly with the "ear" format to use a particular appXml file, you should specify the following for the archiverConfig value in your plugin configuration: 
<appXml>${project.basedir}/somepath/app.xml</appXml>
  • Type: org.codehaus.plexus.configuration.PlexusConfiguration
  • Since: 2.2-beta-3
  • Required: No

attach:

Controls whether the assembly plugin tries to attach the resulting assembly to the project.
  • Type: boolean
  • Since: 2.2-beta-1
  • Required: No
  • Expression: ${attach}
  • Default: true

classifier:

Deprecated. Please use the Assembly's id for classifier instead
This is the artifact classifier to be used for the resultant assembly artifact. Normally, you would use the assembly-id instead of specifying this here.
  • Type: java.lang.String
  • Required: No
  • Expression: ${classifier}

descriptor:

Deprecated. Please use descriptors instead
Assembly XML Descriptor file. This must be the path to your customized descriptor file.
  • Type: java.lang.String
  • Required: No
  • Expression: ${descriptor}

descriptorId:

Deprecated. Please use descriptorRefs instead
Predefined Assembly Descriptor Id's. You can select bin, jar-with-dependencies, or src.
  • Type: java.lang.String
  • Required: No
  • Expression: ${descriptorId}

descriptorRefs:

A list of built-in descriptor references to generate from. You can select from bin, jar-with-dependencies, or src.
  • Type: java.lang.String[]
  • Required: No

descriptorSourceDirectory:

Directory to scan for descriptor files in.
  • Type: java.io.File
  • Required: No

descriptors:

A list of descriptor files to generate from.
  • Type: java.lang.String[]
  • Required: No

dryRun:

If this flag is set, everything up to the call to Archiver.createArchive() will be executed.
  • Type: boolean
  • Required: No
  • Expression: ${assembly.dryRun}
  • Default: false

filters:

(no description)
  • Type: java.util.List
  • Required: No

finalName:

The filename of the assembled distribution file.
  • Type: java.lang.String
  • Required: Yes
  • Default: ${project.build.finalName}

ignoreDirFormatExtensions:

If this flag is set, the ".dir" suffix will be suppressed in the output directory name when using assembly/format == 'dir' and other formats that begin with 'dir'.
NOTE: Since 2.2-beta-3, the default-value for this is true, NOT false as it used to be.
  • Type: boolean
  • Required: No
  • Default: true

ignoreMissingDescriptor:

Set to true in order to not fail when a descriptor is missing.
  • Type: boolean
  • Required: No
  • Expression: ${ignoreMissingDescriptor}
  • Default: false

includeSite:

Deprecated. Please set this variable in the assembly descriptor instead
Set to true to include the site generated by site:site goal.
  • Type: boolean
  • Required: No
  • Expression: ${includeSite}
  • Default: false

outputDirectory:

The output directory of the assembled distribution file.
  • Type: java.io.File
  • Required: Yes
  • Default: ${project.build.directory}

runOnlyAtExecutionRoot:

This will cause the assembly to run only at the top of a given module tree. That is, run in the project contained in the same folder where the mvn execution was launched.
  • Type: boolean
  • Since: 2.2-beta-4
  • Required: No
  • Expression: ${runOnlyAtExecutionRoot}
  • Default: false

skipAssembly:

Flag allowing one or more executions of the assembly plugin to be configured as skipped for a particular build. This makes the assembly plugin more controllable from profiles.
  • Type: boolean
  • Required: No
  • Expression: ${skipAssembly}
  • Default: false

tarLongFileMode:

Sets the TarArchiver behavior on file paths with more than 100 characters length. Valid values are: "warn" (default), "fail", "truncate", "gnu", or "omit".
  • Type: java.lang.String
  • Required: No
  • Expression: ${tarLongFileMode}
  • Default: warn

workDirectory:

Directory to unpack JARs into if needed
  • Type: java.io.File
  • Required: Yes
  • Default: ${project.build.directory}/assembly/work