| ------ |
| Usage |
| ------ |
| Dennis Lundberg |
| ------ |
| 2008-06-17 |
| ------ |
| |
| ~~ Licensed to the Apache Software Foundation (ASF) under one |
| ~~ or more contributor license agreements. See the NOTICE file |
| ~~ distributed with this work for additional information |
| ~~ regarding copyright ownership. The ASF licenses this file |
| ~~ to you under the Apache License, Version 2.0 (the |
| ~~ "License"); you may not use this file except in compliance |
| ~~ with the License. You may obtain a copy of the License at |
| ~~ |
| ~~ http://www.apache.org/licenses/LICENSE-2.0 |
| ~~ |
| ~~ Unless required by applicable law or agreed to in writing, |
| ~~ software distributed under the License is distributed on an |
| ~~ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY |
| ~~ KIND, either express or implied. See the License for the |
| ~~ specific language governing permissions and limitations |
| ~~ under the License. |
| |
| ~~ NOTE: For help with the syntax of this file, see: |
| ~~ http://maven.apache.org/doxia/references/apt-format.html |
| |
| |
| Usage |
| |
| This plugin helps you to create upload bundles for the central repository. A |
| bundle that will be uploaded to the central repository has to follow certain |
| requirements when it comes to the POM. Therefor all goals in this plugin will |
| check that the POM includes at least the following required elements: |
| |
| * modelVersion |
| |
| * groupId |
| |
| * artifactId |
| |
| * packaging |
| |
| * name |
| |
| * version |
| |
| * description |
| |
| * url |
| |
| * licenses |
| |
| * scm (url and connection at a minimum) |
| |
| [] |
| |
| |
| * Create an upload bundle for a Maven project |
| |
| You can use the <<<repository:bundle-create>>> goal to create an upload bundle |
| for a Maven project: |
| |
| +----+ |
| mvn repository:bundle-create |
| |
| +----+ |
| |
| The bundle will be created in your <<<target>>> directory with the name: |
| <<<$\{project.artifactId\}-$\{project.version\}-bundle.jar>>> |
| |
| If you want to include a jar with java sources in your upload (recommended, unless your license doesn't |
| allow sources to be redistributed) the command to run is: |
| |
| +----+ |
| mvn source:jar javadoc:jar repository:bundle-create |
| |
| +----+ |
| |
| <<Note:>> There was a bug that required you to manually add the javadoc jar to |
| the bundle jar in version 2.0 of the plugin. This has been fixed in the 2.1 |
| version of the plugin. |
| |
| |
| * Create a bundle for a non-Maven project |
| |
| The <<<repository:bundle-pack>>> goal is useful if you have artifacts available |
| in your local repository that you want to create a bundle from, for an upload |
| request. It requires that the artifact has a POM in the local repository. It |
| will check for required elements, asking interactively for any missing values. |
| |
| <<Note:>> This goal was introduced in version 2.1 of this plugin. |
| |
| Simply run this command and follow the instructions on the command line. The |
| bundle will be created in the current directory, unless you specify different |
| values for the {{{bundle-pack-mojo.html}goal parameters}}. |
| |
| +----+ |
| mvn repository:bundle-pack |
| +----+ |