Stuart McCulloch | d16db97 | 2011-07-05 11:48:22 +0000 | [diff] [blame] | 1 | <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> |
Stuart McCulloch | ab58cba | 2012-02-11 19:16:11 +0000 | [diff] [blame] | 2 | <!-- Generated by Apache Maven Doxia at Feb 11, 2012 --> |
Stuart McCulloch | d16db97 | 2011-07-05 11:48:22 +0000 | [diff] [blame] | 3 | <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en"> |
Stuart McCulloch | d16db97 | 2011-07-05 11:48:22 +0000 | [diff] [blame] | 4 | <head> |
Stuart McCulloch | d16db97 | 2011-07-05 11:48:22 +0000 | [diff] [blame] | 5 | <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /> |
Stuart McCulloch | d16db97 | 2011-07-05 11:48:22 +0000 | [diff] [blame] | 6 | <title>Maven Bundle Plugin - Plugin Documentation</title> |
Stuart McCulloch | d16db97 | 2011-07-05 11:48:22 +0000 | [diff] [blame] | 7 | <style type="text/css" media="all"> |
Stuart McCulloch | d16db97 | 2011-07-05 11:48:22 +0000 | [diff] [blame] | 8 | @import url("./css/maven-base.css"); |
Stuart McCulloch | d16db97 | 2011-07-05 11:48:22 +0000 | [diff] [blame] | 9 | @import url("./css/maven-theme.css"); |
Stuart McCulloch | d16db97 | 2011-07-05 11:48:22 +0000 | [diff] [blame] | 10 | @import url("./css/site.css"); |
Stuart McCulloch | d16db97 | 2011-07-05 11:48:22 +0000 | [diff] [blame] | 11 | </style> |
Stuart McCulloch | d16db97 | 2011-07-05 11:48:22 +0000 | [diff] [blame] | 12 | <link rel="stylesheet" href="./css/print.css" type="text/css" media="print" /> |
Stuart McCulloch | ab58cba | 2012-02-11 19:16:11 +0000 | [diff] [blame] | 13 | <meta name="Date-Revision-yyyymmdd" content="20120211" /> |
Stuart McCulloch | d16db97 | 2011-07-05 11:48:22 +0000 | [diff] [blame] | 14 | <meta http-equiv="Content-Language" content="en" /> |
Stuart McCulloch | d16db97 | 2011-07-05 11:48:22 +0000 | [diff] [blame] | 15 | |
Stuart McCulloch | d16db97 | 2011-07-05 11:48:22 +0000 | [diff] [blame] | 16 | </head> |
Stuart McCulloch | d16db97 | 2011-07-05 11:48:22 +0000 | [diff] [blame] | 17 | <body class="composite"> |
Stuart McCulloch | d16db97 | 2011-07-05 11:48:22 +0000 | [diff] [blame] | 18 | <div id="banner"> |
Stuart McCulloch | d16db97 | 2011-07-05 11:48:22 +0000 | [diff] [blame] | 19 | <div id="bannerLeft"> |
Stuart McCulloch | d16db97 | 2011-07-05 11:48:22 +0000 | [diff] [blame] | 20 | Maven Bundle Plugin |
Stuart McCulloch | d16db97 | 2011-07-05 11:48:22 +0000 | [diff] [blame] | 21 | </div> |
Stuart McCulloch | d16db97 | 2011-07-05 11:48:22 +0000 | [diff] [blame] | 22 | <div class="clear"> |
Stuart McCulloch | d16db97 | 2011-07-05 11:48:22 +0000 | [diff] [blame] | 23 | <hr/> |
Stuart McCulloch | d16db97 | 2011-07-05 11:48:22 +0000 | [diff] [blame] | 24 | </div> |
Stuart McCulloch | d16db97 | 2011-07-05 11:48:22 +0000 | [diff] [blame] | 25 | </div> |
Stuart McCulloch | d16db97 | 2011-07-05 11:48:22 +0000 | [diff] [blame] | 26 | <div id="breadcrumbs"> |
Stuart McCulloch | d16db97 | 2011-07-05 11:48:22 +0000 | [diff] [blame] | 27 | |
Stuart McCulloch | d16db97 | 2011-07-05 11:48:22 +0000 | [diff] [blame] | 28 | |
Stuart McCulloch | d16db97 | 2011-07-05 11:48:22 +0000 | [diff] [blame] | 29 | <div class="xleft"> |
Stuart McCulloch | ab58cba | 2012-02-11 19:16:11 +0000 | [diff] [blame] | 30 | <span id="publishDate">Last Published: 2012-02-11</span> |
Stuart McCulloch | 148b7bf | 2011-11-28 16:39:12 +0000 | [diff] [blame] | 31 | | <span id="projectVersion">Version: 2.4.0-SNAPSHOT</span> |
Stuart McCulloch | d16db97 | 2011-07-05 11:48:22 +0000 | [diff] [blame] | 32 | </div> |
Stuart McCulloch | d16db97 | 2011-07-05 11:48:22 +0000 | [diff] [blame] | 33 | <div class="xright"> |
Stuart McCulloch | d16db97 | 2011-07-05 11:48:22 +0000 | [diff] [blame] | 34 | |
Stuart McCulloch | d16db97 | 2011-07-05 11:48:22 +0000 | [diff] [blame] | 35 | </div> |
Stuart McCulloch | d16db97 | 2011-07-05 11:48:22 +0000 | [diff] [blame] | 36 | <div class="clear"> |
Stuart McCulloch | d16db97 | 2011-07-05 11:48:22 +0000 | [diff] [blame] | 37 | <hr/> |
Stuart McCulloch | d16db97 | 2011-07-05 11:48:22 +0000 | [diff] [blame] | 38 | </div> |
Stuart McCulloch | d16db97 | 2011-07-05 11:48:22 +0000 | [diff] [blame] | 39 | </div> |
Stuart McCulloch | d16db97 | 2011-07-05 11:48:22 +0000 | [diff] [blame] | 40 | <div id="leftColumn"> |
Stuart McCulloch | d16db97 | 2011-07-05 11:48:22 +0000 | [diff] [blame] | 41 | <div id="navcolumn"> |
Stuart McCulloch | d16db97 | 2011-07-05 11:48:22 +0000 | [diff] [blame] | 42 | |
Stuart McCulloch | d16db97 | 2011-07-05 11:48:22 +0000 | [diff] [blame] | 43 | |
Stuart McCulloch | d16db97 | 2011-07-05 11:48:22 +0000 | [diff] [blame] | 44 | <h5>Overview</h5> |
Stuart McCulloch | d16db97 | 2011-07-05 11:48:22 +0000 | [diff] [blame] | 45 | <ul> |
Stuart McCulloch | d16db97 | 2011-07-05 11:48:22 +0000 | [diff] [blame] | 46 | <li class="none"> |
Stuart McCulloch | d16db97 | 2011-07-05 11:48:22 +0000 | [diff] [blame] | 47 | <a href="index.html" title="Introduction">Introduction</a> |
Stuart McCulloch | d16db97 | 2011-07-05 11:48:22 +0000 | [diff] [blame] | 48 | </li> |
Stuart McCulloch | d16db97 | 2011-07-05 11:48:22 +0000 | [diff] [blame] | 49 | <li class="none"> |
Stuart McCulloch | d16db97 | 2011-07-05 11:48:22 +0000 | [diff] [blame] | 50 | <strong>Goals</strong> |
Stuart McCulloch | d16db97 | 2011-07-05 11:48:22 +0000 | [diff] [blame] | 51 | </li> |
Stuart McCulloch | d16db97 | 2011-07-05 11:48:22 +0000 | [diff] [blame] | 52 | <li class="none"> |
Stuart McCulloch | d16db97 | 2011-07-05 11:48:22 +0000 | [diff] [blame] | 53 | <a href="https://cwiki.apache.org/confluence/display/FELIX/Apache+Felix+Maven+Bundle+Plugin+%28BND%29" class="externalLink" title="Wiki">Wiki</a> |
Stuart McCulloch | d16db97 | 2011-07-05 11:48:22 +0000 | [diff] [blame] | 54 | </li> |
Stuart McCulloch | d16db97 | 2011-07-05 11:48:22 +0000 | [diff] [blame] | 55 | <li class="none"> |
Stuart McCulloch | d16db97 | 2011-07-05 11:48:22 +0000 | [diff] [blame] | 56 | <a href="https://cwiki.apache.org/confluence/display/FELIX/Apache+Felix+Bundle+Plugin+FAQ" class="externalLink" title="FAQ">FAQ</a> |
Stuart McCulloch | d16db97 | 2011-07-05 11:48:22 +0000 | [diff] [blame] | 57 | </li> |
Stuart McCulloch | d16db97 | 2011-07-05 11:48:22 +0000 | [diff] [blame] | 58 | <li class="none"> |
Stuart McCulloch | d16db97 | 2011-07-05 11:48:22 +0000 | [diff] [blame] | 59 | <a href="jira-report.html" title="Release Notes">Release Notes</a> |
Stuart McCulloch | d16db97 | 2011-07-05 11:48:22 +0000 | [diff] [blame] | 60 | </li> |
Stuart McCulloch | d16db97 | 2011-07-05 11:48:22 +0000 | [diff] [blame] | 61 | </ul> |
Stuart McCulloch | d16db97 | 2011-07-05 11:48:22 +0000 | [diff] [blame] | 62 | <h5>Project Documentation</h5> |
Stuart McCulloch | d16db97 | 2011-07-05 11:48:22 +0000 | [diff] [blame] | 63 | <ul> |
Stuart McCulloch | d16db97 | 2011-07-05 11:48:22 +0000 | [diff] [blame] | 64 | <li class="collapsed"> |
Stuart McCulloch | d16db97 | 2011-07-05 11:48:22 +0000 | [diff] [blame] | 65 | <a href="project-info.html" title="Project Information">Project Information</a> |
Stuart McCulloch | d16db97 | 2011-07-05 11:48:22 +0000 | [diff] [blame] | 66 | </li> |
Stuart McCulloch | d16db97 | 2011-07-05 11:48:22 +0000 | [diff] [blame] | 67 | <li class="expanded"> |
Stuart McCulloch | d16db97 | 2011-07-05 11:48:22 +0000 | [diff] [blame] | 68 | <a href="project-reports.html" title="Project Reports">Project Reports</a> |
Stuart McCulloch | d16db97 | 2011-07-05 11:48:22 +0000 | [diff] [blame] | 69 | <ul> |
Stuart McCulloch | d16db97 | 2011-07-05 11:48:22 +0000 | [diff] [blame] | 70 | <li class="none"> |
Stuart McCulloch | d16db97 | 2011-07-05 11:48:22 +0000 | [diff] [blame] | 71 | <a href="jira-report.html" title="JIRA Report">JIRA Report</a> |
Stuart McCulloch | d16db97 | 2011-07-05 11:48:22 +0000 | [diff] [blame] | 72 | </li> |
Stuart McCulloch | d16db97 | 2011-07-05 11:48:22 +0000 | [diff] [blame] | 73 | <li class="none"> |
Stuart McCulloch | d16db97 | 2011-07-05 11:48:22 +0000 | [diff] [blame] | 74 | <strong>Plugin Documentation</strong> |
Stuart McCulloch | d16db97 | 2011-07-05 11:48:22 +0000 | [diff] [blame] | 75 | </li> |
Stuart McCulloch | d16db97 | 2011-07-05 11:48:22 +0000 | [diff] [blame] | 76 | <li class="none"> |
Stuart McCulloch | d16db97 | 2011-07-05 11:48:22 +0000 | [diff] [blame] | 77 | <a href="xref/index.html" title="Source Xref">Source Xref</a> |
Stuart McCulloch | d16db97 | 2011-07-05 11:48:22 +0000 | [diff] [blame] | 78 | </li> |
Stuart McCulloch | d16db97 | 2011-07-05 11:48:22 +0000 | [diff] [blame] | 79 | <li class="none"> |
Stuart McCulloch | d16db97 | 2011-07-05 11:48:22 +0000 | [diff] [blame] | 80 | <a href="surefire-report.html" title="Surefire Report">Surefire Report</a> |
Stuart McCulloch | d16db97 | 2011-07-05 11:48:22 +0000 | [diff] [blame] | 81 | </li> |
Stuart McCulloch | d16db97 | 2011-07-05 11:48:22 +0000 | [diff] [blame] | 82 | <li class="none"> |
Stuart McCulloch | d16db97 | 2011-07-05 11:48:22 +0000 | [diff] [blame] | 83 | <a href="xref-test/index.html" title="Test Source Xref">Test Source Xref</a> |
Stuart McCulloch | d16db97 | 2011-07-05 11:48:22 +0000 | [diff] [blame] | 84 | </li> |
Stuart McCulloch | d16db97 | 2011-07-05 11:48:22 +0000 | [diff] [blame] | 85 | </ul> |
Stuart McCulloch | d16db97 | 2011-07-05 11:48:22 +0000 | [diff] [blame] | 86 | </li> |
Stuart McCulloch | d16db97 | 2011-07-05 11:48:22 +0000 | [diff] [blame] | 87 | </ul> |
Stuart McCulloch | d16db97 | 2011-07-05 11:48:22 +0000 | [diff] [blame] | 88 | <a href="http://maven.apache.org/" title="Built by Maven" class="poweredBy"> |
Stuart McCulloch | d16db97 | 2011-07-05 11:48:22 +0000 | [diff] [blame] | 89 | <img class="poweredBy" alt="Built by Maven" src="./images/logos/maven-feather.png" /> |
Stuart McCulloch | d16db97 | 2011-07-05 11:48:22 +0000 | [diff] [blame] | 90 | </a> |
Stuart McCulloch | d16db97 | 2011-07-05 11:48:22 +0000 | [diff] [blame] | 91 | |
Stuart McCulloch | d16db97 | 2011-07-05 11:48:22 +0000 | [diff] [blame] | 92 | |
Stuart McCulloch | d16db97 | 2011-07-05 11:48:22 +0000 | [diff] [blame] | 93 | </div> |
Stuart McCulloch | d16db97 | 2011-07-05 11:48:22 +0000 | [diff] [blame] | 94 | </div> |
Stuart McCulloch | d16db97 | 2011-07-05 11:48:22 +0000 | [diff] [blame] | 95 | <div id="bodyColumn"> |
Stuart McCulloch | d16db97 | 2011-07-05 11:48:22 +0000 | [diff] [blame] | 96 | <div id="contentBox"> |
Stuart McCulloch | d16db97 | 2011-07-05 11:48:22 +0000 | [diff] [blame] | 97 | <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 |
| 98 | first).</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 |
| 99 | future 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 |
| 100 | goal)</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 |
| 101 | goal)</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 |
| 102 | goal)</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 |
| 103 | and 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 |
| 104 | release</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><project> |
| 105 | ... |
| 106 | <build> |
| 107 | <!-- To define the plugin version in your parent POM --> |
| 108 | <pluginManagement> |
| 109 | <plugins> |
| 110 | <plugin> |
| 111 | <groupId>org.apache.felix</groupId> |
| 112 | <artifactId>maven-bundle-plugin</artifactId> |
Stuart McCulloch | 148b7bf | 2011-11-28 16:39:12 +0000 | [diff] [blame] | 113 | <version>2.4.0-SNAPSHOT</version> |
Stuart McCulloch | d16db97 | 2011-07-05 11:48:22 +0000 | [diff] [blame] | 114 | </plugin> |
| 115 | ... |
| 116 | </plugins> |
| 117 | </pluginManagement> |
| 118 | <!-- To use the plugin goals in your POM or parent POM --> |
| 119 | <plugins> |
| 120 | <plugin> |
| 121 | <groupId>org.apache.felix</groupId> |
| 122 | <artifactId>maven-bundle-plugin</artifactId> |
Stuart McCulloch | 148b7bf | 2011-11-28 16:39:12 +0000 | [diff] [blame] | 123 | <version>2.4.0-SNAPSHOT</version> |
Stuart McCulloch | d16db97 | 2011-07-05 11:48:22 +0000 | [diff] [blame] | 124 | </plugin> |
| 125 | ... |
| 126 | </plugins> |
| 127 | </build> |
| 128 | ... |
| 129 | </project> |
| 130 | </pre></div><p>For more information, see <a class="externalLink" href="http://maven.apache.org/guides/mini/guide-configuring-plugins.html">"Guide to Configuring Plug-ins"</a></p></div></div> |
Stuart McCulloch | d16db97 | 2011-07-05 11:48:22 +0000 | [diff] [blame] | 131 | </div> |
Stuart McCulloch | d16db97 | 2011-07-05 11:48:22 +0000 | [diff] [blame] | 132 | </div> |
Stuart McCulloch | d16db97 | 2011-07-05 11:48:22 +0000 | [diff] [blame] | 133 | <div class="clear"> |
Stuart McCulloch | d16db97 | 2011-07-05 11:48:22 +0000 | [diff] [blame] | 134 | <hr/> |
Stuart McCulloch | d16db97 | 2011-07-05 11:48:22 +0000 | [diff] [blame] | 135 | </div> |
Stuart McCulloch | d16db97 | 2011-07-05 11:48:22 +0000 | [diff] [blame] | 136 | <div id="footer"> |
Stuart McCulloch | ab58cba | 2012-02-11 19:16:11 +0000 | [diff] [blame] | 137 | <div class="xright">Copyright © 2006-2012 |
Stuart McCulloch | d16db97 | 2011-07-05 11:48:22 +0000 | [diff] [blame] | 138 | <a href="http://www.apache.org/">The Apache Software Foundation</a>. |
Stuart McCulloch | d16db97 | 2011-07-05 11:48:22 +0000 | [diff] [blame] | 139 | All Rights Reserved. |
Stuart McCulloch | d16db97 | 2011-07-05 11:48:22 +0000 | [diff] [blame] | 140 | |
Stuart McCulloch | d16db97 | 2011-07-05 11:48:22 +0000 | [diff] [blame] | 141 | </div> |
Stuart McCulloch | d16db97 | 2011-07-05 11:48:22 +0000 | [diff] [blame] | 142 | <div class="clear"> |
Stuart McCulloch | d16db97 | 2011-07-05 11:48:22 +0000 | [diff] [blame] | 143 | <hr/> |
Stuart McCulloch | d16db97 | 2011-07-05 11:48:22 +0000 | [diff] [blame] | 144 | </div> |
Stuart McCulloch | d16db97 | 2011-07-05 11:48:22 +0000 | [diff] [blame] | 145 | </div> |
Stuart McCulloch | d16db97 | 2011-07-05 11:48:22 +0000 | [diff] [blame] | 146 | </body> |
Stuart McCulloch | d16db97 | 2011-07-05 11:48:22 +0000 | [diff] [blame] | 147 | </html> |