You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@felix.apache.org by mc...@apache.org on 2009/02/27 07:38:33 UTC
svn commit: r748410 -
/felix/trunk/bundleplugin/doc/apache-felix-maven-bundle-plugin-bnd.html
Author: mcculls
Date: Fri Feb 27 06:38:33 2009
New Revision: 748410
URL: http://svn.apache.org/viewvc?rev=748410&view=rev
Log:
Update doc wrt version 2 changes
Modified:
felix/trunk/bundleplugin/doc/apache-felix-maven-bundle-plugin-bnd.html
Modified: felix/trunk/bundleplugin/doc/apache-felix-maven-bundle-plugin-bnd.html
URL: http://svn.apache.org/viewvc/felix/trunk/bundleplugin/doc/apache-felix-maven-bundle-plugin-bnd.html?rev=748410&r1=748409&r2=748410&view=diff
==============================================================================
--- felix/trunk/bundleplugin/doc/apache-felix-maven-bundle-plugin-bnd.html (original)
+++ felix/trunk/bundleplugin/doc/apache-felix-maven-bundle-plugin-bnd.html Fri Feb 27 06:38:33 2009
@@ -36,7 +36,7 @@
project structure and to provide it with reasonable default behavior
for Maven 2 projects.</p>
-<p><em>NOTE: only compile, runtime and system scoped dependencies are passed to BND. Provided and test dependencies are <b>not</b> included in the classpath seen by BND.</em></p>
+<p><em>NOTE: test scoped dependencies are <b>not</b> included in the classpath seen by BND.</em></p>
<p>Since the 1.4.0 release, this plugin also aims to automate OBR (OSGi
Bundle Repository) management. It helps manage a local OBR for your
@@ -209,12 +209,19 @@
<li>if artifactId is equal to last section of groupId then groupId is returned. eg. org.apache.maven:maven -> org.apache.maven</li>
<li>if
artifactId starts with last section of groupId that portion is removed.
-eg. org.apache.maven:maven-core -> org.apache.maven.core</li>
+eg. org.apache.maven:maven-core -> org.apache.maven.core<br>
+The computed symbolic name is also stored in the <tt>$(maven-symbolicname)</tt> property in case you want to add attributes or directives to it.</li>
</ul>
</li>
- <li><tt><Export-Package></tt> is assumed to be "<tt><Bundle-SymbolicName>.*</tt>", unless <tt><Private-Package></tt> is specified, then <tt><Export-Package></tt> is assumed to be empty.</li>
- <li><tt><Private-Package></tt> is assumed to be empty by default.</li>
- <li><tt><Import-Package></tt> is assumed to be "<tt>*</tt>", which imports everything referred to by the bundle content, but not contained in the bundle.</li>
+ <li><tt><Export-Package></tt>
+is now assumed to be the set of packages in your local Java sources,
+excluding the default package '.' and any packages containing 'impl' or
+'internal'.<br>
+<em>(before version 2 of the bundleplugin it was based on the symbolic name)</em></li>
+ <li><tt><Private-Package></tt> is now assumed to be the set of packages in your local Java sources (note that any packages in both <tt><Export-Package></tt> and <tt><Private-Package></tt> will be exported).<br>
+<em>(before version 2 of the bundleplugin it was assumed to be empty by default)</em></li>
+ <li><tt><Import-Package></tt> is assumed to be "<tt>*</tt>", which imports everything referred to by the bundle content, but not contained in the bundle.<br>
+<em>Any exported packages are also imported by default, to ensure a consistent class space.</em></li>
<li><tt><Include-Resource></tt> is generated from the project's Maven resources, typically "<tt>src/main/resources/</tt>",
which will copy the specified project directory hierarchy into the
resulting bundle JAR file, mirroring standard Maven behavior.</li>
@@ -270,7 +277,6 @@
<plugin> <!-- (2) START -->
<groupId>org.apache.felix</groupId>
<artifactId>maven-bundle-plugin</artifactId>
-
<extensions>true</extensions>
<configuration>
<instructions>
@@ -518,7 +524,8 @@
<ul>
<li><em><tt>manifestLocation</tt></em> defaults to ${project.build.outputDirectory}/META-INF</li>
<li><em><tt>unpackBundle</tt></em> unpack bundle contents to output directory, defaults to false</li>
- <li><em><tt>excludeDependencies</tt></em> comma-separated list of dependency artifactIds to exclude from the classpath passed to Bnd (use "true" to exclude everything)</li>
+ <li><em><tt>excludeDependencies</tt></em> comma-separated list of dependency artifactIds to exclude from the classpath passed to Bnd, use "true" to exclude everything.<br>
+Version 2 of the bundleplugin now supports the same style of filter clauses in <tt>excludeDependencies</tt> as <tt>Embed-Dependency</tt>.</li>
<li><em><tt>classifier</tt></em> attach bundle to the project using the given classifier</li>
<li><em><tt>supportedProjectTypes</tt></em> defaults to "jar","bundle"</li>
</ul>
@@ -653,7 +660,6 @@
</ul>
-
<ul>
<li><b><tt>remote-clean</tt></b> - cleans a remote OBR, removing missing bundles<br>
configuration options:
@@ -1071,6 +1077,7 @@
</ul>
+
<p>Example:</p>
<div class="preformatted"><div class="preformattedContent">
<pre>mvn org.apache.felix:maven-bundle-plugin:1.4.0:deploy-file \