appassembler:assemble

Full name:

org.codehaus.mojo:appassembler-maven-plugin:1.2:assemble

Description:

Assembles the artifacts and generates bin scripts for the configured applications

Attributes:

  • Requires a Maven project to be executed.
  • Requires dependency resolution of artifacts in scope: runtime.
  • Binds by default to the lifecycle phase: package.

Required Parameters

Name Type Since Description
assembleDirectory File - The directory that will be used to assemble the artifacts in and place the bin scripts.
Default value is: ${project.build.directory}/appassembler.
programs Set - The set of Programs that bin files will be generated for.

Optional Parameters

Name Type Since Description
binFileExtensions Map 1.1 The file extensions to use for bin files. The file extensions are stored in a Map that uses the platform name as key. To change the file extension for Unix bin files to ".sh" use this configuration: 
         <binFileExtensions>
           <unix>.sh</unix>
         </binFileExtensions>

binFolder String - Define the name of binary folder.
Default value is: bin.
configurationDirectory String - The name of the target directory for configuration files.
Default value is: etc.
configurationSourceDirectory File 1.1 The name of the source directory for configuration files.
Default value is: src/main/config.
copyConfigurationDirectory boolean 1.1 If the source configuration directory should be copied to the configured configurationDirectory.
Default value is: false.
environmentSetupFileName String - Setup file in $BASEDIR/bin to be called prior to execution.
extraJvmArguments String - Extra arguments that will be given to the JVM verbatim. If you define JvmSettings on the Program.setJvmSettings() level this part will be overwritten by the given parameters on program level. Otherwise if Program.setJvmSettings() is not given these settings will be used instead. This can be used to define some default values whereas by using the Program.setJvmSettings() to overwrite the default settings. This is only valid for the extraJvmArguments not for the rest of the JvmSettings. Since 1.2 it's possible to use place holder @BASEDIR@ and @REPO@ which will be expanded based on the platform for which the appropriate script will generated.
generateRepository boolean - Set to false to skip repository generation.
Default value is: true.
includeConfigurationDirectoryInClasspath boolean - If the configurationDirectory (etc by default) should be included in the beginning of the classpath in the generated bin files.
Default value is: true.
licenseHeaderFile File - You can define a license header file which will be used instead the default header in the generated scripts.
platforms Set - The default platforms the plugin will generate bin files for. Configure with string values - "all"(default/empty) | "windows" | "unix".
repositoryLayout String - The layout of the generated Maven repository. Supported types - "default" (Maven2) | "legacy" (Maven1) | "flat" (flat lib/ style). The style "legacy" is only supported if you are running under Maven 2.2.1 and before.
Default value is: default.
repositoryName String - Path (relative to assembleDirectory) of the desired output repository.
Default value is: repo.
showConsoleWindow boolean - Show console window when execute this application.
Default value is: true.

Parameter Details

assembleDirectory:

The directory that will be used to assemble the artifacts in and place the bin scripts.
  • Type: java.io.File
  • Required: Yes
  • Expression: ${assembleDirectory}
  • Default: ${project.build.directory}/appassembler

binFileExtensions:

The file extensions to use for bin files. The file extensions are stored in a Map that uses the platform name as key. To change the file extension for Unix bin files to ".sh" use this configuration: 
         <binFileExtensions>
           <unix>.sh</unix>
         </binFileExtensions>
  • Type: java.util.Map
  • Since: 1.1
  • Required: No

binFolder:

Define the name of binary folder.
  • Type: java.lang.String
  • Required: No
  • Default: bin

configurationDirectory:

The name of the target directory for configuration files.
  • Type: java.lang.String
  • Required: No
  • Default: etc

configurationSourceDirectory:

The name of the source directory for configuration files.
  • Type: java.io.File
  • Since: 1.1
  • Required: No
  • Default: src/main/config

copyConfigurationDirectory:

If the source configuration directory should be copied to the configured configurationDirectory.
  • Type: boolean
  • Since: 1.1
  • Required: No
  • Default: false

environmentSetupFileName:

Setup file in $BASEDIR/bin to be called prior to execution.
  • Type: java.lang.String
  • Required: No

extraJvmArguments:

Extra arguments that will be given to the JVM verbatim. If you define JvmSettings on the Program.setJvmSettings() level this part will be overwritten by the given parameters on program level. Otherwise if Program.setJvmSettings() is not given these settings will be used instead. This can be used to define some default values whereas by using the Program.setJvmSettings() to overwrite the default settings. This is only valid for the extraJvmArguments not for the rest of the JvmSettings. Since 1.2 it's possible to use place holder @BASEDIR@ and @REPO@ which will be expanded based on the platform for which the appropriate script will generated.
  • Type: java.lang.String
  • Required: No

generateRepository:

Set to false to skip repository generation.
  • Type: boolean
  • Required: No
  • Default: true

includeConfigurationDirectoryInClasspath:

If the configurationDirectory (etc by default) should be included in the beginning of the classpath in the generated bin files.
  • Type: boolean
  • Required: No
  • Default: true

licenseHeaderFile:

You can define a license header file which will be used instead the default header in the generated scripts.
  • Type: java.io.File
  • Required: No

platforms:

The default platforms the plugin will generate bin files for. Configure with string values - "all"(default/empty) | "windows" | "unix".
  • Type: java.util.Set
  • Required: No

programs:

The set of Programs that bin files will be generated for.
  • Type: java.util.Set
  • Required: Yes

repositoryLayout:

The layout of the generated Maven repository. Supported types - "default" (Maven2) | "legacy" (Maven1) | "flat" (flat lib/ style). The style "legacy" is only supported if you are running under Maven 2.2.1 and before.
  • Type: java.lang.String
  • Required: No
  • Default: default

repositoryName:

Path (relative to assembleDirectory) of the desired output repository.
  • Type: java.lang.String
  • Required: No
  • Default: repo

showConsoleWindow:

Show console window when execute this application.
  • Type: boolean
  • Required: No
  • Default: true