Spring Roo Wrapping
Spring Roo wrapping repository
This Git repository contains various script files that enable easy production of OSGi-compliant bundles using a technique known as "wrapping". These are generally used by Spring Roo and its add-ons.
The goals of the JAR wrappers are:
Turn a non-OSGi JAR into an OSGi-enabled JAR.
Patch libraries by replacing or adding artifacts inside the JAR.
The output JAR is then usable in Roo or other OSGi containers
In order to complete these instructions, you must have rights to deploy files to http://repo.spring.io/spring-roo/.
All wrapped JARs are deployed under the following directory:
To perform wrapping you need:
A proper installation of Java 6 or above
Maven 3.0.1+ properly installed and working with your Java 5+
Internet access so that Maven can download required dependencies
Upload privileges to the above location
GPG setup (see main Spring Roo readme.txt for instructions)
If you want to host an OSGi-compliant JAR that
does not need wrapping at http://repo.spring.io/spring-roo/,
be sure to create an .ASC file of the JAR and pom.xml using
gpg --ab <filename> and upload the ASC files as well.
The same Git policies apply to this repository as the normal Roo repository.
artifactId and the
the "input" non-OSGi JAR, the wrappings must follow the naming conventions
groupIdmust be org.springframework.roo.wrapping
The wrapping repository is separated from the normal Roo repository at Maven Central so that each project in the wrapping repository can be released as part of its own release cycle. The wrapping projects are NOT released during the normal Roo release cycle and the Roo CI server does NOT perform any wrapping module releases.
As such, it is expected that developers wishing to make wrapped JAR available will manually produce/edit the relevant subdirectory of the wrapping JAR and then connect to https://repo.spring.io/ to deploy the JAR manually.
|Before releasing, ensure you increment the final three-digit suffix for the version number displayed in the pom.xml. This ensures everyone is on the latest release you have made.|
If you have general questions on Roo’s wrapping approach, please use the Stackoverflow. You can access it at http://stackoverflow.com/questions/tagged/spring-roo. Thanks for your interest in Spring Roo!