| <!DOCTYPE HTML PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> |
| <html><head><title>Apache Felix - Maven Obr Plugin</title> |
| |
| |
| |
| |
| <link rel="stylesheet" href="maven-obr-plugin_files/site.css" type="text/css" media="all"> |
| <meta http-equiv="Content-Type" content="text/html;charset=UTF-8"></head><body> |
| <div class="title"><div class="logo"><a href="http://felix.apache.org/site/index.html"><img alt="Apache Felix" src="maven-obr-plugin_files/logo.png" border="0"></a></div><div class="header"><a href="http://www.apache.org/"><img alt="Apache" src="maven-obr-plugin_files/apache.png" border="0"></a></div></div> |
| <div class="menu"> |
| <ul> |
| <li><a href="http://felix.apache.org/site/index.html" title="Index">home</a></li> |
| <li><a href="http://felix.apache.org/site/news.html" title="news">news</a></li> |
| <li><a href="http://felix.apache.org/site/status.html" title="status">status</a></li> |
| <li><a href="http://felix.apache.org/site/license.html" title="license">license</a></li> |
| <li><span class="nobr"><a href="http://felix.apache.org/site/downloads.cgi" title="Visit page outside Confluence" rel="nofollow">downloads<sup><img class="rendericon" src="maven-obr-plugin_files/linkext7.gif" alt="" align="absmiddle" border="0" height="7" width="7"></sup></a></span></li> |
| <li><a href="http://felix.apache.org/site/documentation.html" title="documentation">documentation</a></li> |
| <li><a href="http://felix.apache.org/site/mailinglists.html" title="mailinglists">mailing lists</a></li> |
| <li><span class="nobr"><a href="http://cwiki.apache.org/confluence/x/O-" title="Visit page outside Confluence" rel="nofollow">wiki<sup><img class="rendericon" src="maven-obr-plugin_files/linkext7.gif" alt="" align="absmiddle" border="0" height="7" width="7"></sup></a></span></li> |
| <li><a href="http://felix.apache.org/site/committers.html" title="committers">committers</a></li> |
| <li><a href="http://felix.apache.org/site/faq.html" title="faq">faq</a></li> |
| <li><a href="http://felix.apache.org/site/roadmap.html" title="roadmap">roadmap</a></li> |
| <li><a href="http://felix.apache.org/site/sourcecode.html" title="sourcecode">source code</a></li> |
| <li><a href="http://felix.apache.org/site/codingstandards.html" title="codingstandards">coding standards</a></li> |
| <li><a href="http://felix.apache.org/site/issuetracking.html" title="issuetracking">issue tracking</a></li> |
| <li><a href="http://felix.apache.org/site/dependencies.html" title="dependencies">dependencies</a></li> |
| <li><span class="nobr"><a href="http://www.apache.org/" title="Visit page outside Confluence" rel="nofollow">apache software foundation<sup><img class="rendericon" src="maven-obr-plugin_files/linkext7.gif" alt="" align="absmiddle" border="0" height="7" width="7"></sup></a></span></li> |
| <li><span class="nobr"><a href="http://www.apache.org/foundation/sponsorship.html" title="Visit page outside Confluence" rel="nofollow">sponsorship<sup><img class="rendericon" src="maven-obr-plugin_files/linkext7.gif" alt="" align="absmiddle" border="0" height="7" width="7"></sup></a></span></li> |
| <li><span class="nobr"><a href="http://www.apache.org/foundation/thanks.html" title="Visit page outside Confluence" rel="nofollow">sponsors<sup><img class="rendericon" src="maven-obr-plugin_files/linkext7.gif" alt="" align="absmiddle" border="0" height="7" width="7"></sup></a></span></li> |
| </ul> </div> |
| <div class="main"> |
| <p>This Maven plug-in aims to automate OBR (<span class="nobr"><a href="http://www2.osgi.org/Repository/HomePage" title="Visit page outside Confluence" rel="nofollow">OSGi Bundle Repository<sup><img class="rendericon" src="maven-obr-plugin_files/linkext7.gif" alt="" align="absmiddle" border="0" height="7" width="7"></sup></a></span>) |
| management. It creates a local OBR repository and can create a remote |
| OBR to distribute bundles. This plug-in allows you to install your |
| bundles inside an OBR repository at the same time you install it in |
| your Maven repository. It can also deploy your bundle in a remote Maven |
| repository when you deploy your Maven artefact. The plug-in computes |
| capabilities and requirements and edits the repository description file |
| to add (or update) the bundle description.</p> |
| |
| <h2><a name="MavenObrPlugin-Features:"></a>Features:</h2> |
| |
| <p>The plug-in allows:</p> |
| <ul> |
| <li>Installing Maven artefact inside an OBR repository, |
| automatically or manually (for legacy bundles). This OBR could be |
| remote or local.</li> |
| <li>Discovering bundle capabilities and requirements</li> |
| <li>Customizing bundle descriptions</li> |
| </ul> |
| |
| |
| <h2><a name="MavenObrPlugin-Howtousetheplugin?"></a>How to use the plug-in?</h2> |
| |
| <p>The plug-in offers five Maven goals:</p> |
| <ul> |
| <li>A: The standard 'install' goal: it will install your bundle |
| in the repository at the same time it install it in your Maven |
| repository.</li> |
| <li>B: An 'install-file' goal which takes a jar file, |
| and installs it in the local Maven repository and update the |
| remote repository descriptor file.</li> |
| <li>C: A 'deploy' goal which upload a bundle on a remote repository and update the remote repository descriptor file.</li> |
| <li>D: A 'deploy-file' goal which upload jar file on a remote repository and update the remote repository descriptor file. </li> |
| <li>E : A 'clean' goal cleaning the local obr repository. </li> |
| </ul> |
| |
| |
| <h3><a name="MavenObrPlugin-A:InstallingbundlesinalocalOBRrepository"></a>A: Installing bundles in a local OBR repository</h3> |
| |
| <p>The plug-in can create a local OBR repository at the root of the |
| local Maven repository. At each time the artefact is installed in the |
| local maven repository (by using the 'mvn install' command), a local |
| OBR repository is updated to contain the description of the artefact. |
| This feature is automated inside the <span class="nobr"><a href="http://felix.apache.org/site/maven-bundle-plugin-bnd.html" title="Visit page outside Confluence" rel="nofollow">maven-bundle-plugin<sup><img class="rendericon" src="maven-obr-plugin_files/linkext7.gif" alt="" align="absmiddle" border="0" height="7" width="7"></sup></a></span>.</p> |
| |
| <h3><a name="MavenObrPlugin-B:InstallinganexistingMavenartefactinalocalOBRrepository"></a>B: Installing an existing Maven artefact in a local OBR repository</h3> |
| |
| <p>This second way, to use the plug-in is to add an already existing bundle in the OBR. The bundle <b>must</b> |
| be already in the Maven local repository (you can use the Maven |
| install:install-file plug-in to install an external bundle in your |
| Maven repository).<br> |
| To use this goal, the user must provide information in command line:</p> |
| <table class="confluenceTable"><tbody> |
| <tr> |
| <td class="confluenceTd"> Variable name (prefixed by --D) </td> |
| <td class="confluenceTd"> status </td> |
| <td class="confluenceTd"> description </td> |
| </tr> |
| <tr> |
| <td class="confluenceTd"> file </td> |
| <td class="confluenceTd"> require </td> |
| <td class="confluenceTd"> Path to the jar file (used to install bundle only) </td> |
| </tr> |
| <tr> |
| <td class="confluenceTd"> artefactId </td> |
| <td class="confluenceTd"> require </td> |
| <td class="confluenceTd"> artefactId of the bundle Use to determine |
| path to the jar file in local maven Repository use as symbolic name if |
| it isn't define in manifest </td> |
| </tr> |
| <tr> |
| <td class="confluenceTd"> groupId </td> |
| <td class="confluenceTd"> require </td> |
| <td class="confluenceTd"> groupId of the bundle Use to determine path to the jar file on local maven repository </td> |
| </tr> |
| <tr> |
| <td class="confluenceTd"> version </td> |
| <td class="confluenceTd"> require </td> |
| <td class="confluenceTd"> Version of the bundle Use to determine path to the jar file on local maven repository </td> |
| </tr> |
| <tr> |
| <td class="confluenceTd"> packaging </td> |
| <td class="confluenceTd"> require </td> |
| <td class="confluenceTd"> File type Use by maven to install the file (used to install bundle only) </td> |
| </tr> |
| <tr> |
| <td class="confluenceTd"> repository-path </td> |
| <td class="confluenceTd"> optional </td> |
| <td class="confluenceTd"> Path to the repository descriptor file (if not define: default path is : MavenRepo\repository.xml </td> |
| </tr> |
| <tr> |
| <td class="confluenceTd"> obr-file </td> |
| <td class="confluenceTd"> optional </td> |
| <td class="confluenceTd"> Path to the obr.xml, file which describe |
| capabilities requirement and category given manually by user. (if not |
| define: nothing is added to the resource description). </td> |
| </tr> |
| </tbody></table> |
| |
| <h4><a name="MavenObrPlugin-Exampleofcommandline:"></a>Example of command line:</h4> |
| |
| <p>mvn homega.tools:obrPlugin:install-file \<br> |
| -Drepository-path=<span class="nobr"><a href="file:///c:repository.xml" title="Visit page outside Confluence" rel="nofollow">file:/c:\repository.xml<sup><img class="rendericon" src="maven-obr-plugin_files/linkext7.gif" alt="" align="absmiddle" border="0" height="7" width="7"></sup></a></span> \<br> |
| -obr-file=<span class="nobr"><a href="file:///c:projecthomegaobr.xml" title="Visit page outside Confluence" rel="nofollow">file:/c:\project\homega\obr.xml<sup><img class="rendericon" src="maven-obr-plugin_files/linkext7.gif" alt="" align="absmiddle" border="0" height="7" width="7"></sup></a></span> \<br> |
| -DartifactId=multicast.discovery \<br> |
| -DgroupId=<font color="black">homega.utils</font> <font color="black">{color}</font><br> |
| <font color="black">-Dversion=1.0.0</font></p> |
| |
| <p>By using this command, the plug-in will look at the artefact |
| MavenRepo\homega\utils\multicast.discovery\1.0.0\multicast.discovery-1.0.0.jar |
| <br clear="all"></p> |
| |
| <p>Then it will compute bundle description by using <span class="nobr"><a href="http://www2.osgi.org/Repository/BIndex" title="Visit page outside Confluence" rel="nofollow">bindex <sup><img class="rendericon" src="maven-obr-plugin_files/linkext7.gif" alt="" align="absmiddle" border="0" height="7" width="7"></sup></a></span>and information from the command line (artifactId, groupId, version, and obr file (if set)).</p> |
| |
| <h4><a name="MavenObrPlugin-"></a><font color="black">Note:</font></h4> |
| |
| <p><font color="black">As said previously, the plug-in does not install |
| the file in the Maven repository but target an already install |
| artefact. However, it is possible to install the bundle in the |
| repository and to add it in the OBR repository file in one command:</font><br> |
| <font color="black"> mvn install:install-file homega.tools:obrPlugin:install-file {color}</font><br> |
| <font color="black">-Dfile=</font><font color="black"><span class="nobr"><a href="file:///c:projethomegamulticast.discovery-1.0.0.jar" title="Visit page outside Confluence" rel="nofollow">file:/c:\projet\homega\multicast.discovery-1.0.0.jar<sup><img class="rendericon" src="maven-obr-plugin_files/linkext7.gif" alt="" align="absmiddle" border="0" height="7" width="7"></sup></a></span></font> <font color="black">{color}</font><br> |
| <font color="black">-Drepository-path=</font><font color="black"><span class="nobr"><a href="file:///c:repository.xml" title="Visit page outside Confluence" rel="nofollow">file:/c:\repository.xml<sup><img class="rendericon" src="maven-obr-plugin_files/linkext7.gif" alt="" align="absmiddle" border="0" height="7" width="7"></sup></a></span></font> <font color="black">{color}</font><br> |
| <font color="black">-Dobr-file=</font><font color="black"><span class="nobr"><a href="file:///c:projecthomegaobr.xml" title="Visit page outside Confluence" rel="nofollow">file:/c:\project\homega\obr.xml<sup><img class="rendericon" src="maven-obr-plugin_files/linkext7.gif" alt="" align="absmiddle" border="0" height="7" width="7"></sup></a></span></font> <font color="black">{color}</font><br> |
| <font color="black">-DartifactId=multicast.discovery {color}</font><br> |
| <font color="black">-DgroupId=</font><font color="black">homega.utils</font> <font color="black">{color}</font><br> |
| <font color="black">-Dversion=1.0.0 {color}</font><br> |
| <font color="black">-Dpackaging=jar</font></p> |
| |
| <h3><a name="MavenObrPlugin-"></a><font color="black">C: Deploying a bundle on a remote OBR</font></h3> |
| |
| <p><font color="black">To use the deploy goal, you must change your pom.xml:</font></p> |
| <ul> |
| <li><font color="black">Add the "</font><font color="black">deployment"</font> <font color="black">goal</font></li> |
| </ul> |
| |
| |
| <ul> |
| <li> |
| <ul> |
| <li><font color="black">Indicate the repository-name |
| property. This is the name of the repository descriptor file (this |
| property is optional; default value is "repository.xml"). This file is |
| located on url provided by user.</font><br> |
| <font color="teal"><</font><font color="#3f7f7f">plugin</font><font color="teal">></font><br> |
| <font color="teal"> <</font><font color="#3f7f7f">groupId</font><font color="teal">></font><font color="black">org.apache.felix</font><font color="teal"></</font><font color="#3f7f7f">groupId</font><font color="teal">></font><br> |
| <font color="teal"><</font><font color="#3f7f7f">artifactId</font><font color="teal">></font><font color="black">maven-obr-plugin</font><font color="teal"></</font><font color="#3f7f7f">artifactId</font><font color="teal">></font><br> |
| <font color="teal"><</font><font color="#3f7f7f">configuration</font><font color="teal">></font><br> |
| <font color="black"> </font> <font color="teal"><</font><font color="#3f7f7f">repository-name</font><font color="teal">></font><font color="black">repository.xml</font><font color="teal"></</font><font color="#3f7f7f">repository-name</font><font color="teal">></font><br> |
| <font color="teal"></</font><font color="#3f7f7f">configuration</font><font color="teal">></font><br> |
| <font color="teal"><</font><font color="#3f7f7f">executions</font><font color="teal">></font><br> |
| <font color="teal"><</font><font color="#3f7f7f">execution</font><font color="teal">></font><br> |
| <font color="teal"><</font><font color="#3f7f7f">goals</font><font color="teal">></font><br> |
| <font color="teal"><</font><font color="#3f7f7f">goal</font><font color="teal">></font><font color="black">deployment</font><font color="teal"></</font><font color="#3f7f7f">goal</font><font color="teal">></font><br> |
| <font color="teal"></</font><font color="#3f7f7f">goals</font><font color="teal">></font><br> |
| <font color="teal"></</font><font color="#3f7f7f">execution</font><font color="teal">></font><br> |
| <font color="teal"></</font><font color="#3f7f7f">executions</font><font color="teal">></font><br> |
| <font color="teal"></</font><font color="#3f7f7f">plugin</font><font color="teal">></font></li> |
| <li>You must also configure where the plugin will upload bundles and repository descriptor file. You could do it in maven as this:<br> |
| <font color="teal"><</font><font color="#3f7f7f">distributionManagement</font><font color="teal">></font><br> |
| <font color="teal"> <</font><font color="#3f7f7f">repository</font><font color="teal">></font><br> |
| <font color="teal"> <</font><font color="#3f7f7f">id</font><font color="teal">></font><font color="black">ftp-repository</font><font color="teal"></</font><font color="#3f7f7f">id</font><font color="teal">></font><br> |
| <font color="teal"><</font><font color="#3f7f7f">name</font><font color="teal">></font><font color="black">RepoName</font><font color="teal"></</font><font color="#3f7f7f">name</font><font color="teal">></font><br> |
| <font color="teal"><</font><font color="#3f7f7f">url</font><font color="teal">></font><font color="black"><span class="nobr"><a href="ftp://ftp.youraddress.com/obr" title="Visit page outside Confluence" rel="nofollow">ftp://ftp.youraddress.com/obr<sup><img class="rendericon" src="maven-obr-plugin_files/linkext7.gif" alt="" align="absmiddle" border="0" height="7" width="7"></sup></a></span></font><font color="teal"></</font><font color="#3f7f7f">url</font><font color="teal">></font><br> |
| <font color="teal"></</font><font color="#3f7f7f">repository</font><font color="teal">></font><br> |
| <font color="teal"></</font><font color="#3f7f7f">distributionManagement</font><font color="teal">></font></li> |
| <li>Now maven will upload your bundle on this ftp site.</li> |
| </ul> |
| </li> |
| <li>Launch the 'mvn deploy' command</li> |
| </ul> |
| |
| |
| <p>In fact, all protocols are not supported by maven. For example ftp |
| protocol as describe above require wagon plugin to run correctly. So |
| you could add this part in your pom.xml to use wagon in ftp protocol:</p> |
| |
| <p><font color="teal"><</font><font color="#3f7f7f">build</font><font color="teal">></font><br> |
| <font color="teal"> <</font><font color="#3f7f7f">extensions</font><font color="teal">></font><br> |
| <font color="teal"><</font><font color="#3f7f7f">extension</font><font color="teal">></font><br> |
| <font color="teal"><</font><font color="#3f7f7f">groupId</font><font color="teal">></font><font color="black">org.apache.maven.wagon</font><font color="teal"></</font><font color="#3f7f7f">groupId</font><font color="teal">></font><br> |
| <font color="teal"><</font><font color="#3f7f7f">artifactId</font><font color="teal">></font><font color="black">wagon-ftp</font><font color="teal"></</font><font color="#3f7f7f">artifactId</font><font color="teal">></font><br> |
| <font color="teal"><</font><font color="#3f7f7f">version</font><font color="teal">></font><font color="black">1.0-alpha-6</font><font color="teal"></</font><font color="#3f7f7f">version</font><font color="teal">></font><br> |
| <font color="teal"></</font><font color="#3f7f7f">extension</font><font color="teal">></font><br> |
| <font color="teal"></</font><font color="#3f7f7f">extensions</font><font color="teal">></font></p> |
| |
| <p>By this way, the deploy goal supports all protocols supported by wagon.</p> |
| |
| <h3><a name="MavenObrPlugin-D:DeploynonmavenbundleonaremoteOBRrepository"></a>D: Deploy non maven bundle on a remote OBR repository</h3> |
| |
| <p>This goal is useful if you want add a non-maven project on your |
| remote repository, for example a legacy bundles.The command line is |
| compozed by :</p> |
| <table class="confluenceTable"><tbody> |
| <tr> |
| <td class="confluenceTd"> Variable name (preceded by --D) </td> |
| <td class="confluenceTd"> status </td> |
| <td class="confluenceTd"> description </td> |
| </tr> |
| <tr> |
| <td class="confluenceTd"> file </td> |
| <td class="confluenceTd"> require </td> |
| <td class="confluenceTd"> Path to the jar file </td> |
| </tr> |
| <tr> |
| <td class="confluenceTd"> artefactId </td> |
| <td class="confluenceTd"> require </td> |
| <td class="confluenceTd"> artefactId of the bundle Use to determine |
| path to the jar file in local maven Repository use as symbolic name if |
| it isn't define in manifest </td> |
| </tr> |
| <tr> |
| <td class="confluenceTd"> groupId </td> |
| <td class="confluenceTd"> require </td> |
| <td class="confluenceTd"> groupId of the bundle Use to determine path to the jar file on local maven repository </td> |
| </tr> |
| <tr> |
| <td class="confluenceTd"> version </td> |
| <td class="confluenceTd"> require </td> |
| <td class="confluenceTd"> Version of the bundle Use to determine path to the jar file on local maven repository </td> |
| </tr> |
| <tr> |
| <td class="confluenceTd"> packaging </td> |
| <td class="confluenceTd"> require </td> |
| <td class="confluenceTd"> File type Use by maven to install the file (used to install bundle only) </td> |
| </tr> |
| <tr> |
| <td class="confluenceTd"> url </td> |
| <td class="confluenceTd"> require </td> |
| <td class="confluenceTd"> url to the remote server </td> |
| </tr> |
| <tr> |
| <td class="confluenceTd"> uniqueVersion </td> |
| <td class="confluenceTd"> optional </td> |
| <td class="confluenceTd"> Set it to false to avoid unique filename when you upload </td> |
| </tr> |
| <tr> |
| <td class="confluenceTd"> repositoryId </td> |
| <td class="confluenceTd"> optional </td> |
| <td class="confluenceTd"> Name of the repository use to upload file </td> |
| </tr> |
| <tr> |
| <td class="confluenceTd"> obr-file </td> |
| <td class="confluenceTd"> optional </td> |
| <td class="confluenceTd"> Path to the obr.xml, file which describe |
| capabilities requirement and category given manually by user. (if not |
| define: nothing is added to the resource description). </td> |
| </tr> |
| </tbody></table> |
| |
| <h4><a name="MavenObrPlugin-Exampleofcompletecommandline:"></a>Example of complete command line:</h4> |
| |
| <p>mvn deploy:deploy-file homega.tools:obrPlugin:deploy-file \<br> |
| -DartifactId=echo2<br> |
| -DgroupId=tools<br> |
| -Dversion=2.0.0<br> |
| -Dpackaging=jar<br> |
| -DrepositoryId=ftp-repository<br> |
| -DuniqueVersion=false<br> |
| -Durl=<span class="nobr"><a href="ftp://ftp.plop-plop.net/obr" title="Visit page outside Confluence" rel="nofollow">ftp://ftp.plop-plop.net/obr<sup><img class="rendericon" src="maven-obr-plugin_files/linkext7.gif" alt="" align="absmiddle" border="0" height="7" width="7"></sup></a></span><br> |
| -Dobr-file=c:\obr.xml<br> |
| -Dfile=echo2.jar</p> |
| |
| <p>To upload your file, you must create a small pom file declaring a |
| repositoryManagement to indicates which remote server you use and the |
| component to use for the protocol transfer. This file must contain also |
| groupId, artifactId version and packaging information (in fact those |
| data are redundant with the command line, so you could omit them in |
| command line).<br> |
| <em>Example of additional pom.xml:</em><br> |
| <font color="teal"><</font><font color="#3f7f7f">project</font><font color="teal">></font><br> |
| <font color="teal"><</font><font color="#3f7f7f">modelVersion</font><font color="teal">></font><font color="black">4.0.0</font><font color="teal"></</font><font color="#3f7f7f">modelVersion</font><font color="teal">></font><br> |
| <font color="teal"><</font><font color="#3f7f7f">packaging</font><font color="teal">></font><font color="black">jar</font><font color="teal"></</font><font color="#3f7f7f">packaging</font><font color="teal">></font><br> |
| <font color="teal"><</font><font color="#3f7f7f">groupId</font><font color="teal">></font><font color="black">tools</font><font color="teal"></</font><font color="#3f7f7f">groupId</font><font color="teal">></font><br> |
| <font color="teal"><</font><font color="#3f7f7f">artifactId</font><font color="teal">></font><font color="black">echo2</font><font color="teal"></</font><font color="#3f7f7f">artifactId</font><font color="teal">></font><br> |
| <font color="teal"><</font><font color="#3f7f7f">version</font><font color="teal">></font><font color="black">2.0.0</font><font color="teal"></</font><font color="#3f7f7f">version</font><font color="teal">></font><br> |
| <font color="teal"><</font><font color="#3f7f7f">distributionManagement</font><font color="teal">></font><br> |
| <font color="teal"><</font><font color="#3f7f7f">repository</font><font color="teal">></font><br> |
| <font color="teal"><</font><font color="#3f7f7f">id</font><font color="teal">></font><font color="black">ftp-repository</font><font color="teal"></</font><font color="#3f7f7f">id</font><font color="teal">></font><br> |
| <font color="teal"><</font><font color="#3f7f7f">name</font><font color="teal">></font><font color="black">RepoName</font><font color="teal"></</font><font color="#3f7f7f">name</font><font color="teal">></font><br> |
| <font color="teal"><</font><font color="#3f7f7f">url</font><font color="teal">></font><font color="black"><span class="nobr"><a href="ftp://ftp.plop-plop.net/obr" title="Visit page outside Confluence" rel="nofollow">ftp://ftp.plop-plop.net/obr<sup><img class="rendericon" src="maven-obr-plugin_files/linkext7.gif" alt="" align="absmiddle" border="0" height="7" width="7"></sup></a></span></font><font color="teal"></</font><font color="#3f7f7f">url</font><font color="teal">></font><br> |
| <font color="teal"></</font><font color="#3f7f7f">repository</font><font color="teal">></font><br> |
| <font color="teal"></</font><font color="#3f7f7f">distributionManagement</font><font color="teal">></font><br> |
| <font color="teal"><</font><font color="#3f7f7f">build</font><font color="teal">></font><br> |
| <font color="teal"><</font><font color="#3f7f7f">extensions</font><font color="teal">></font><br> |
| <font color="teal"><</font><font color="#3f7f7f">extension</font><font color="teal">></font><br> |
| <font color="teal"><</font><font color="#3f7f7f">groupId</font><font color="teal">></font><font color="black">org.apache.maven.wagon</font><font color="teal"></</font><font color="#3f7f7f">groupId</font><font color="teal">></font><br> |
| <font color="teal"><</font><font color="#3f7f7f">artifactId</font><font color="teal">></font><font color="black">wagon-ftp</font><font color="teal"></</font><font color="#3f7f7f">artifactId</font><font color="teal">></font><br> |
| <font color="teal"><</font><font color="#3f7f7f">version</font><font color="teal">></font><font color="black">1.0-alpha-6</font><font color="teal"></</font><font color="#3f7f7f">version</font><font color="teal">></font><br> |
| <font color="teal"></</font><font color="#3f7f7f">extension</font><font color="teal">></font><br> |
| <font color="teal"></</font><font color="#3f7f7f">extensions</font><font color="teal">></font><br> |
| <font color="teal"></</font><font color="#3f7f7f">build</font><font color="teal">></font><br> |
| <font color="teal"></</font><font color="#3f7f7f">project</font><font color="teal">></font></p> |
| |
| <h4><a name="MavenObrPlugin-Concurrentupdates&nbsp;"></a>Concurrent updates </h4> |
| |
| <p>As the obr file is remote, several uploads can occur at the same |
| time. However, the obr repository is centralized in one file, so |
| concurrent modification need to be avoided. To achieve this, the |
| plug-in implement a locking systems. At each time the plug-in try |
| to modify the file, it set a lock on it. If it can't take the lock, it |
| will wait and retry. After 3 tries, the upload process failed.</p> |
| |
| <h3><a name="MavenObrPlugin-E:Cleaningthelocalobrrepository&nbsp;"></a>E: Cleaning the local obr repository </h3> |
| |
| <p>Sometimes, you would like to clean your obr repository because it |
| contains no more existing bundles. This case often occurs when |
| artifacts were deleted manually from the maven repository. The plug-in |
| provides a simple goal to look for missing bundle and to remove them |
| from the obr repository.</p> |
| |
| <p>To launch this feature, launch the following command from a folder |
| of one of your bundle 'mvn org.apache.felix:maven-obr-plugin:clean'.</p> |
| |
| <h2><a name="MavenObrPlugin-Howtheplugincomputethedescriptionofthebundle"></a>How the plug-in compute the description of the bundle</h2> |
| |
| <p>The description of the bundle comes from three different sources:</p> |
| <ul> |
| <li>Bindex : Bindex is a tool analyzing a bundle manifest to generate OBR description</li> |
| <li>The Pom file : by analyzing the pom file, some information are collected (symbolic name ...)</li> |
| <li>The obr.xml file : this file contains customized description of the bundle</li> |
| </ul> |
| |
| |
| <p>In order to create the bundle description, the plug-in gets |
| information from bindex, the pom.xml and the obr.xml file. Information |
| can be overridden:<br> |
| Bindex<br> |
| | (overrides)<br> |
| Pom.xml<br> |
| | (overrides)<br> |
| Obr.xml</p> |
| |
| <p>A warning message is displayed each time already existing |
| information is overridden. In case of install-file goal, the |
| information given by user (i.e.: artefactId, groupId, version) is |
| considered as pom.xml properties.</p> |
| |
| <h2><a name="MavenObrPlugin-Knownissues&limitations:"></a>Known issues & limitations:</h2> |
| |
| <p>1. Do not support relative paths when you specify the repository descriptor in command line use.<br> |
| 2. obr.xml (file given by the user to describe some |
| properties not found by Bindex) must be correct, because the plug-in |
| does not check the syntax.</p> |
| </div> |
| |
| </body></html> |
