Apache Software Foundation Parent POM
This project consists of a POM that contains settings that are likely to be useful to any Apache project that is building and releasing code with Maven 3 (Maven 2.x is not supported any more since version 17). By using this project as a parent, a project gets these settings.
Most project will want to override some of these settings.
The following is a list of the items configured in this POM:
- Top-level project properties:
- pluginManagement: The plugin management section specifies versions of a list of plugins. See the Plugin Management report for the complete list with versions.
- The compiler plugin is set to default to Java 1.4 and UTF-8 source.
- the jar plugin is set to add default specification and implementation entries.
- the resources plugin is set for UTF-8.
- the release plugin: the release plugin is set, via the <arguments> configuration element, to enable the apache-release profile for all executions and to disable <useReleaseProfiles>. You can remove this with an empty <arguments/> element in the configuration of the release plugin.
- plugins: The plugins section configures one execution:
The apache-release Profile
As noted above, this pom configures the release plugin to enable the apache-release profile for all executions of the release plugin. The profile includes the following plugins:
- maven-assembly-plugin: org.apache.apache.resources:apache-source-release-assembly-descriptor:1.0.5 is in the dependencies, and an execution is configured. The plugin is configured to take a descriptorRef name from the sourceReleaseAssemblyDescriptor property, which by default is set to source-release.
- maven-deploy-plugin
- maven-source-plugin: configured to build and attach a source jar.
- maven-javadoc-plugin: configured to build and attach a javadoc jar.
- maven-gpg-plugin: configured to sign everything. It expects to find a passphrase in ${gpg.passphrase}, presumably in your settings.xml.
Settings Configuration
You can have a look at the page in Apache website Publishing Maven Artifacts.
You can test your environment setup using -Papache-release with the command line.
