blob: 8548d958b0c503f6dd07a9f5e721f2e9c5fef9b9 [file] [log] [blame]
Stuart McCullochd16db972011-07-05 11:48:22 +00001<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
Stuart McCulloch148b7bf2011-11-28 16:39:12 +00002<!-- Generated by Apache Maven Doxia at Nov 28, 2011 -->
Stuart McCullochd16db972011-07-05 11:48:22 +00003<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
Stuart McCullochd16db972011-07-05 11:48:22 +00004 <head>
Stuart McCullochd16db972011-07-05 11:48:22 +00005 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
Stuart McCullochd16db972011-07-05 11:48:22 +00006 <title>Maven Bundle Plugin - Plugin Documentation</title>
Stuart McCullochd16db972011-07-05 11:48:22 +00007 <style type="text/css" media="all">
Stuart McCullochd16db972011-07-05 11:48:22 +00008 @import url("./css/maven-base.css");
Stuart McCullochd16db972011-07-05 11:48:22 +00009 @import url("./css/maven-theme.css");
Stuart McCullochd16db972011-07-05 11:48:22 +000010 @import url("./css/site.css");
Stuart McCullochd16db972011-07-05 11:48:22 +000011 </style>
Stuart McCullochd16db972011-07-05 11:48:22 +000012 <link rel="stylesheet" href="./css/print.css" type="text/css" media="print" />
Stuart McCulloch148b7bf2011-11-28 16:39:12 +000013 <meta name="Date-Revision-yyyymmdd" content="20111128" />
Stuart McCullochd16db972011-07-05 11:48:22 +000014 <meta http-equiv="Content-Language" content="en" />
Stuart McCullochd16db972011-07-05 11:48:22 +000015
Stuart McCullochd16db972011-07-05 11:48:22 +000016 </head>
Stuart McCullochd16db972011-07-05 11:48:22 +000017 <body class="composite">
Stuart McCullochd16db972011-07-05 11:48:22 +000018 <div id="banner">
Stuart McCullochd16db972011-07-05 11:48:22 +000019 <div id="bannerLeft">
Stuart McCullochd16db972011-07-05 11:48:22 +000020 Maven Bundle Plugin
Stuart McCullochd16db972011-07-05 11:48:22 +000021 </div>
Stuart McCullochd16db972011-07-05 11:48:22 +000022 <div class="clear">
Stuart McCullochd16db972011-07-05 11:48:22 +000023 <hr/>
Stuart McCullochd16db972011-07-05 11:48:22 +000024 </div>
Stuart McCullochd16db972011-07-05 11:48:22 +000025 </div>
Stuart McCullochd16db972011-07-05 11:48:22 +000026 <div id="breadcrumbs">
Stuart McCullochd16db972011-07-05 11:48:22 +000027
Stuart McCullochd16db972011-07-05 11:48:22 +000028
Stuart McCullochd16db972011-07-05 11:48:22 +000029 <div class="xleft">
Stuart McCulloch148b7bf2011-11-28 16:39:12 +000030 <span id="publishDate">Last Published: 2011-11-28</span>
31 &nbsp;| <span id="projectVersion">Version: 2.4.0-SNAPSHOT</span>
Stuart McCullochd16db972011-07-05 11:48:22 +000032 </div>
Stuart McCullochd16db972011-07-05 11:48:22 +000033 <div class="xright">
Stuart McCullochd16db972011-07-05 11:48:22 +000034
Stuart McCullochd16db972011-07-05 11:48:22 +000035 </div>
Stuart McCullochd16db972011-07-05 11:48:22 +000036 <div class="clear">
Stuart McCullochd16db972011-07-05 11:48:22 +000037 <hr/>
Stuart McCullochd16db972011-07-05 11:48:22 +000038 </div>
Stuart McCullochd16db972011-07-05 11:48:22 +000039 </div>
Stuart McCullochd16db972011-07-05 11:48:22 +000040 <div id="leftColumn">
Stuart McCullochd16db972011-07-05 11:48:22 +000041 <div id="navcolumn">
Stuart McCullochd16db972011-07-05 11:48:22 +000042
Stuart McCullochd16db972011-07-05 11:48:22 +000043
Stuart McCullochd16db972011-07-05 11:48:22 +000044 <h5>Overview</h5>
Stuart McCullochd16db972011-07-05 11:48:22 +000045 <ul>
Stuart McCullochd16db972011-07-05 11:48:22 +000046 <li class="none">
Stuart McCullochd16db972011-07-05 11:48:22 +000047 <a href="index.html" title="Introduction">Introduction</a>
Stuart McCullochd16db972011-07-05 11:48:22 +000048 </li>
Stuart McCullochd16db972011-07-05 11:48:22 +000049 <li class="none">
Stuart McCullochd16db972011-07-05 11:48:22 +000050 <strong>Goals</strong>
Stuart McCullochd16db972011-07-05 11:48:22 +000051 </li>
Stuart McCullochd16db972011-07-05 11:48:22 +000052 <li class="none">
Stuart McCullochd16db972011-07-05 11:48:22 +000053 <a href="https://cwiki.apache.org/confluence/display/FELIX/Apache+Felix+Maven+Bundle+Plugin+%28BND%29" class="externalLink" title="Wiki">Wiki</a>
Stuart McCullochd16db972011-07-05 11:48:22 +000054 </li>
Stuart McCullochd16db972011-07-05 11:48:22 +000055 <li class="none">
Stuart McCullochd16db972011-07-05 11:48:22 +000056 <a href="https://cwiki.apache.org/confluence/display/FELIX/Apache+Felix+Bundle+Plugin+FAQ" class="externalLink" title="FAQ">FAQ</a>
Stuart McCullochd16db972011-07-05 11:48:22 +000057 </li>
Stuart McCullochd16db972011-07-05 11:48:22 +000058 <li class="none">
Stuart McCullochd16db972011-07-05 11:48:22 +000059 <a href="jira-report.html" title="Release Notes">Release Notes</a>
Stuart McCullochd16db972011-07-05 11:48:22 +000060 </li>
Stuart McCullochd16db972011-07-05 11:48:22 +000061 </ul>
Stuart McCullochd16db972011-07-05 11:48:22 +000062 <h5>Project Documentation</h5>
Stuart McCullochd16db972011-07-05 11:48:22 +000063 <ul>
Stuart McCullochd16db972011-07-05 11:48:22 +000064 <li class="collapsed">
Stuart McCullochd16db972011-07-05 11:48:22 +000065 <a href="project-info.html" title="Project Information">Project Information</a>
Stuart McCullochd16db972011-07-05 11:48:22 +000066 </li>
Stuart McCullochd16db972011-07-05 11:48:22 +000067 <li class="expanded">
Stuart McCullochd16db972011-07-05 11:48:22 +000068 <a href="project-reports.html" title="Project Reports">Project Reports</a>
Stuart McCullochd16db972011-07-05 11:48:22 +000069 <ul>
Stuart McCullochd16db972011-07-05 11:48:22 +000070 <li class="none">
Stuart McCullochd16db972011-07-05 11:48:22 +000071 <a href="jira-report.html" title="JIRA Report">JIRA Report</a>
Stuart McCullochd16db972011-07-05 11:48:22 +000072 </li>
Stuart McCullochd16db972011-07-05 11:48:22 +000073 <li class="none">
Stuart McCullochd16db972011-07-05 11:48:22 +000074 <strong>Plugin Documentation</strong>
Stuart McCullochd16db972011-07-05 11:48:22 +000075 </li>
Stuart McCullochd16db972011-07-05 11:48:22 +000076 <li class="none">
Stuart McCullochd16db972011-07-05 11:48:22 +000077 <a href="xref/index.html" title="Source Xref">Source Xref</a>
Stuart McCullochd16db972011-07-05 11:48:22 +000078 </li>
Stuart McCullochd16db972011-07-05 11:48:22 +000079 <li class="none">
Stuart McCullochd16db972011-07-05 11:48:22 +000080 <a href="surefire-report.html" title="Surefire Report">Surefire Report</a>
Stuart McCullochd16db972011-07-05 11:48:22 +000081 </li>
Stuart McCullochd16db972011-07-05 11:48:22 +000082 <li class="none">
Stuart McCullochd16db972011-07-05 11:48:22 +000083 <a href="xref-test/index.html" title="Test Source Xref">Test Source Xref</a>
Stuart McCullochd16db972011-07-05 11:48:22 +000084 </li>
Stuart McCullochd16db972011-07-05 11:48:22 +000085 </ul>
Stuart McCullochd16db972011-07-05 11:48:22 +000086 </li>
Stuart McCullochd16db972011-07-05 11:48:22 +000087 </ul>
Stuart McCullochd16db972011-07-05 11:48:22 +000088 <a href="http://maven.apache.org/" title="Built by Maven" class="poweredBy">
Stuart McCullochd16db972011-07-05 11:48:22 +000089 <img class="poweredBy" alt="Built by Maven" src="./images/logos/maven-feather.png" />
Stuart McCullochd16db972011-07-05 11:48:22 +000090 </a>
Stuart McCullochd16db972011-07-05 11:48:22 +000091
Stuart McCullochd16db972011-07-05 11:48:22 +000092
Stuart McCullochd16db972011-07-05 11:48:22 +000093 </div>
Stuart McCullochd16db972011-07-05 11:48:22 +000094 </div>
Stuart McCullochd16db972011-07-05 11:48:22 +000095 <div id="bodyColumn">
Stuart McCullochd16db972011-07-05 11:48:22 +000096 <div id="contentBox">
Stuart McCullochd16db972011-07-05 11:48:22 +000097 <a name="Plugin_Documentation"></a><div class="section"><h2>Plugin Documentation<a name="Plugin_Documentation"></a></h2><p>Goals available for this plugin:</p><table border="0" class="bodyTable"><tr class="a"><th>Goal</th><th>Description</th></tr><tr class="b"><td><a href="ant-mojo.html">bundle:ant</a></td><td>Generate Ant script to create the bundle (you should run ant:ant
98first).</td></tr><tr class="a"><td><a href="bundle-mojo.html">bundle:bundle</a></td><td>Create an OSGi bundle from Maven project</td></tr><tr class="b"><td><a href="bundleall-mojo.html">bundle:bundleall</a></td><td><strong>Deprecated.</strong> The bundleall goal is no longer supported and may be removed in a
99future release</td></tr><tr class="a"><td><a href="clean-mojo.html">bundle:clean</a></td><td>Clean an OBR repository by finding and removing missing resources.</td></tr><tr class="b"><td><a href="cleanVersions-mojo.html">bundle:cleanVersions</a></td><td>No description.</td></tr><tr class="a"><td><a href="deploy-mojo.html">bundle:deploy</a></td><td>Deploys bundle details to a remote OBR repository (life-cycle goal)</td></tr><tr class="b"><td><a href="deploy-file-mojo.html">bundle:deploy-file</a></td><td>Deploys bundle details to a remote OBR repository (command-line
100goal)</td></tr><tr class="a"><td><a href="index-mojo.html">bundle:index</a></td><td>Index the content of a maven repository using OBR</td></tr><tr class="b"><td><a href="install-mojo.html">bundle:install</a></td><td>Installs bundle details in the local OBR repository (life-cycle
101goal)</td></tr><tr class="a"><td><a href="install-file-mojo.html">bundle:install-file</a></td><td>Installs bundle details in the local OBR repository (command-line
102goal)</td></tr><tr class="b"><td><a href="instructions-mojo.html">bundle:instructions</a></td><td>Generate BND instructions for this project</td></tr><tr class="a"><td><a href="manifest-mojo.html">bundle:manifest</a></td><td>Generate an OSGi manifest for this project</td></tr><tr class="b"><td><a href="remote-clean-mojo.html">bundle:remote-clean</a></td><td>Clean a remote repository file. It just looks for every resources
103and check that pointed file exists.</td></tr><tr class="a"><td><a href="wrap-mojo.html">bundle:wrap</a></td><td><strong>Deprecated.</strong> The wrap goal is no longer supported and may be removed in a future
104release</td></tr></table><a name="System_Requirements"></a><div class="section"><h3>System Requirements<a name="System_Requirements"></a></h3><p>The following specifies the minimum requirements to run this Maven plugin:</p><table border="0" class="bodyTable"><tr class="b"><td>Maven</td><td>2.0</td></tr><tr class="a"><td>JDK</td><td>1.5</td></tr><tr class="b"><td>Memory</td><td>No minimum requirement.</td></tr><tr class="a"><td>Disk Space</td><td>No minimum requirement.</td></tr></table></div><a name="Usage"></a><div class="section"><h3>Usage<a name="Usage"></a></h3><p>You should specify the version in your project's plugin configuration:</p><div class="source"><pre>&lt;project&gt;
105 ...
106 &lt;build&gt;
107 &lt;!-- To define the plugin version in your parent POM --&gt;
108 &lt;pluginManagement&gt;
109 &lt;plugins&gt;
110 &lt;plugin&gt;
111 &lt;groupId&gt;org.apache.felix&lt;/groupId&gt;
112 &lt;artifactId&gt;maven-bundle-plugin&lt;/artifactId&gt;
Stuart McCulloch148b7bf2011-11-28 16:39:12 +0000113 &lt;version&gt;2.4.0-SNAPSHOT&lt;/version&gt;
Stuart McCullochd16db972011-07-05 11:48:22 +0000114 &lt;/plugin&gt;
115 ...
116 &lt;/plugins&gt;
117 &lt;/pluginManagement&gt;
118 &lt;!-- To use the plugin goals in your POM or parent POM --&gt;
119 &lt;plugins&gt;
120 &lt;plugin&gt;
121 &lt;groupId&gt;org.apache.felix&lt;/groupId&gt;
122 &lt;artifactId&gt;maven-bundle-plugin&lt;/artifactId&gt;
Stuart McCulloch148b7bf2011-11-28 16:39:12 +0000123 &lt;version&gt;2.4.0-SNAPSHOT&lt;/version&gt;
Stuart McCullochd16db972011-07-05 11:48:22 +0000124 &lt;/plugin&gt;
125 ...
126 &lt;/plugins&gt;
127 &lt;/build&gt;
128 ...
129&lt;/project&gt;
130</pre></div><p>For more information, see <a class="externalLink" href="http://maven.apache.org/guides/mini/guide-configuring-plugins.html">&quot;Guide to Configuring Plug-ins&quot;</a></p></div></div>
Stuart McCullochd16db972011-07-05 11:48:22 +0000131 </div>
Stuart McCullochd16db972011-07-05 11:48:22 +0000132 </div>
Stuart McCullochd16db972011-07-05 11:48:22 +0000133 <div class="clear">
Stuart McCullochd16db972011-07-05 11:48:22 +0000134 <hr/>
Stuart McCullochd16db972011-07-05 11:48:22 +0000135 </div>
Stuart McCullochd16db972011-07-05 11:48:22 +0000136 <div id="footer">
Stuart McCullochd16db972011-07-05 11:48:22 +0000137 <div class="xright">Copyright &#169; 2006-2011
Stuart McCullochd16db972011-07-05 11:48:22 +0000138 <a href="http://www.apache.org/">The Apache Software Foundation</a>.
Stuart McCullochd16db972011-07-05 11:48:22 +0000139 All Rights Reserved.
Stuart McCullochd16db972011-07-05 11:48:22 +0000140
Stuart McCullochd16db972011-07-05 11:48:22 +0000141 </div>
Stuart McCullochd16db972011-07-05 11:48:22 +0000142 <div class="clear">
Stuart McCullochd16db972011-07-05 11:48:22 +0000143 <hr/>
Stuart McCullochd16db972011-07-05 11:48:22 +0000144 </div>
Stuart McCullochd16db972011-07-05 11:48:22 +0000145 </div>
Stuart McCullochd16db972011-07-05 11:48:22 +0000146 </body>
Stuart McCullochd16db972011-07-05 11:48:22 +0000147</html>