| --- |
| Using Repositories |
| --- |
| Edwin Punzalan |
| --- |
| 26-July-2006 |
| --- |
| |
| ~~ Copyright 2006 The Apache Software Foundation. |
| ~~ |
| ~~ Licensed 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/guides/mini/guide-apt-format.html |
| |
| Using Repositories |
| |
| * Introduction |
| |
| The Assembly Plugin allows the inclusion of needed artifacts from your local |
| repository to the generated archive. They are copied into the assembly in a |
| directory similar to what's in your remote repository, complete with metadata |
| and the checksums. |
| |
| This example demonstrates the creation of repository artifacts in an assembly |
| so that the archive can easily be used to update an internal repository with |
| the artifacts used by your project. |
| |
| * The Assembly Descriptor |
| |
| A functional repository archive for your project can be created with: |
| |
| +----- |
| <assembly> |
| <id>repository</id> |
| <formats> |
| <format>jar</format> |
| </formats> |
| <repositories> |
| <repository> |
| <includeMetadata>true</includeMetadata> |
| <outputDirectory>maven2</outputDirectory> |
| </repository> |
| </repositories> |
| </assembly> |
| +----- |
| |
| The above descriptor tells the Assembly Plugin to create a repository-like |
| directory structure inside the <<<maven2>>> directory from within the |
| generated archive. Setting <<<includeMetadata>>> to <<<true>>> will make the |
| plugin to also copy metadata information into the generated archive. |
| |
| * The POM |
| |
| The pom.xml for your project is very similar to how you configure the Assembly |
| Plugin for other distribution types. |
| |
| +----- |
| <project> |
| [...] |
| <build> |
| [...] |
| <plugins> |
| [...] |
| <plugin> |
| <artifactId>maven-assembly-plugin</artifactId> |
| <configuration> |
| <descriptors> |
| <descriptor>src/assemble/repository.xml</descriptor> |
| </descriptors> |
| </configuration> |
| </plugin> |
| [...] |
| </project> |
| +----- |
| |
| * Generating The Assembly Archive |
| |
| The assembly archive is then created using: |
| |
| +----- |
| mvn assembly:assembly |
| +----- |
| |
| The generated archive can be extracted to an internal repository so users of |
| your project can download the dependencies from it. |
| |
| * Examining the Output |
| |
| When the Maven execution completes, the archive contents should be similar to: |
| |
| +----- |
| target/artifactId-version-repository.jar |
| `-- maven2 |
| |-- groupId |
| | |-- maven-metadata.xml |
| | |-- maven-metadata.xml.md5 |
| | |-- maven-metadata.xml.sha1 |
| | `-- artifactId |
| | |-- maven-metadata.xml |
| | |-- maven-metadata.xml.md5 |
| | |-- maven-metadata.xml.sha1 |
| | `-- version |
| | |-- artifactId-version.jar |
| | |-- artifactId-version.jar.md5 |
| | |-- artifactId-version.jar.sha1 |
| | |-- artifactId-version.pom |
| | |-- artifactId-version.pom.md5 |
| | |-- artifactId-version.pom.sha1 |
| | |-- maven-metadata.xml |
| | |-- maven-metadata.xml.md5 |
| | `-- maven-metadata.xml.sha1 |
| `-- groupId2 |
| `-- [...] |
| +----- |