PluginMetadata
Plugin descriptor metadata for using with script-based mojos.
<pluginMetadata xmlns="http://maven.apache.org/PLUGIN-METADATA/1.1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/PLUGIN-METADATA/1.1.0 http://maven.apache.org/xsd/plugin-metadata-1.1.0.xsd"> <mojos> <mojo> <goal/> <phase/> <aggregator/> <requiresDependencyResolution/> <requiresProject/> <requiresReports/> <requiresOnline/> <inheritByDefault/> <requiresDirectInvocation/> <execution> <lifecycle/> <phase/> <goal/> </execution> <components> <component> <role/> <hint/> </component> </components> <parameters> <parameter> <name/> <alias/> <property/> <required/> <readonly/> <expression/> <defaultValue/> <type/> <description/> <deprecated/> <since/> </parameter> </parameters> <description/> <deprecated/> <since/> <call/> </mojo> </mojos> </pluginMetadata>
pluginMetadata
Root element of a script-based mojo's plugin metadata bindings.
Element | Type | Since | Description |
---|---|---|---|
mojos/mojo*
|
List<Mojo>
|
(Many) The list of mojos contained in the accompanying script. |
mojo
Mojo descriptor definition.
Element | Type | Since | Description |
---|---|---|---|
goal
|
String
|
The name of the goal used to invoke this mojo. | |
phase
|
String
|
The phase to which this mojo should be bound by default. | |
aggregator
|
boolean
|
Whether this mojo operates as an aggregator when the reactor is run. That is, only runs once.
Default value: |
|
requiresDependencyResolution
|
String
|
The scope of dependencies that this mojo requires to have resolved. | |
requiresProject
|
boolean
|
Whether this mojo requires a project instance in order to execute.
Default value: |
|
requiresReports
|
boolean
|
Whether this mojo requires a reports section in the POM.
Default value: |
|
requiresOnline
|
boolean
|
Whether this mojo requires online mode to operate normally.
Default value: |
|
inheritByDefault
|
boolean
|
Whether this mojo's configuration should propagate down the POM inheritance chain by default.
Default value: |
|
requiresDirectInvocation
|
boolean
|
If true, this mojo can only be directly invoked (eg. specified directly on the command line).
Default value: |
|
execution
|
LifecycleExecution
|
Information about a sub-execution of the Maven lifecycle which should be processed. | |
components/component*
|
List<Component>
|
(Many) List of plexus components required by this mojo. | |
parameters/parameter*
|
List<Parameter>
|
(Many) List of parameters used by this mojo. | |
description
|
String
|
The description for this parameter. | |
deprecated
|
String
|
A deprecation message for this mojo parameter. | |
since
|
String
|
1.1.0 | Version when the mojo was added to the API. |
call
|
String
|
The target/method within the script to call when this mojo executes. |
execution
A sub-process execution of a lifecycle to satisfy the needs of a mojo.
Element | Type | Since | Description |
---|---|---|---|
lifecycle
|
String
|
The name of the overlay to apply to the sub-lifecycle before executing it. If specified, this lifecycle overlay definition will be bundled with the plugin. | |
phase
|
String
|
The phase in the sub-lifecycle. | |
goal
|
String
|
A goal, not attached to a lifecycle phase, which should be executed ahead of this mojo. |
component
A reference to a plexus component, assumed to be available to the plugin container.
Element | Type | Since | Description |
---|---|---|---|
role
|
String
|
The component role to lookup. | |
hint
|
String
|
The role-hint to lookup. |
parameter
A parameter used by a mojo, and configurable from the command line or POM configuration sections.
Element | Type | Since | Description |
---|---|---|---|
name
|
String
|
The parameter name | |
alias
|
String
|
An alternate name for the parameter. | |
property
|
String
|
The JavaBeans property name to use to configure the mojo with this parameter. | |
required
|
boolean
|
Whether this parameter is required.
Default value: |
|
readonly
|
boolean
|
Whether this parameter can be directly edited. If false, this param is either derived from another POM element, or refers to a runtime instance of the build system.
Default value: |
|
expression
|
String
|
The command-line reference to this parameter. | |
defaultValue
|
String
|
An expression in the form ${instance.property} for extracting a value for this parameter, especially from a runtime instance within the build system. (eg. ${project.build.directory} references project.getBuild().getDirectory()) | |
type
|
String
|
The java type for this parameter. | |
description
|
String
|
The description for this parameter. | |
deprecated
|
String
|
A deprecation message for this mojo parameter. | |
since
|
String
|
1.1.0 | Version when the parameter was added. |