KARAF-2200 Improve documentation with example that m2e to create pde plugins
git-svn-id: https://svn.apache.org/repos/asf/karaf/eik/trunk@1452038 13f79535-47bb-0310-9956-ffa450edef68 Project: http://git-wip-us.apache.org/repos/asf/karaf-eik/repo Commit: http://git-wip-us.apache.org/repos/asf/karaf-eik/commit/006fa10f Tree: http://git-wip-us.apache.org/repos/asf/karaf-eik/tree/006fa10f Diff: http://git-wip-us.apache.org/repos/asf/karaf-eik/diff/006fa10f Branch: refs/heads/master Commit: 006fa10f1cd0096fb6b4285c4bbcedd4cda23ac7 Parents: 563c706 Author: fbalicchia <fbalicchia@13f79535-47bb-0310-9956-ffa450edef68> Authored: Sun Mar 3 13:33:55 2013 +0000 Committer: fbalicchia <fbalicchia@13f79535-47bb-0310-9956-ffa450edef68> Committed: Sun Mar 3 13:33:55 2013 +0000 ---------------------------------------------------------------------- .../webapp/images/devcomponentwithm2e_1.png | Bin 0 -> 185150 bytes .../webapp/images/devcomponentwithm2e_2.png | Bin 0 -> 70709 bytes .../webapp/user-guide/devcomponentwithm2e.conf | 72 +++++++++++++++++++ manual/src/main/webapp/user-guide/index.conf | 1 + 4 files changed, 73 insertions(+) ---------------------------------------------------------------------- http://git-wip-us.apache.org/repos/asf/karaf-eik/blob/006fa10f/manual/src/main/webapp/images/devcomponentwithm2e_1.png ---------------------------------------------------------------------- diff --git a/manual/src/main/webapp/images/devcomponentwithm2e_1.png b/manual/src/main/webapp/images/devcomponentwithm2e_1.png new file mode 100644 index 0000000..d8ee605 Binary files /dev/null and b/manual/src/main/webapp/images/devcomponentwithm2e_1.png differ http://git-wip-us.apache.org/repos/asf/karaf-eik/blob/006fa10f/manual/src/main/webapp/images/devcomponentwithm2e_2.png ---------------------------------------------------------------------- diff --git a/manual/src/main/webapp/images/devcomponentwithm2e_2.png b/manual/src/main/webapp/images/devcomponentwithm2e_2.png new file mode 100644 index 0000000..190df3f Binary files /dev/null and b/manual/src/main/webapp/images/devcomponentwithm2e_2.png differ http://git-wip-us.apache.org/repos/asf/karaf-eik/blob/006fa10f/manual/src/main/webapp/user-guide/devcomponentwithm2e.conf ---------------------------------------------------------------------- diff --git a/manual/src/main/webapp/user-guide/devcomponentwithm2e.conf b/manual/src/main/webapp/user-guide/devcomponentwithm2e.conf new file mode 100644 index 0000000..3b317bb --- /dev/null +++ b/manual/src/main/webapp/user-guide/devcomponentwithm2e.conf @@ -0,0 +1,72 @@ +h1. Developing OSGi components with m2e and EIK + +Most of the examples and archetype present on the web use maven-bundle-plugins to create bundle. +EIK is able to use these archetype through the help of M2E. + +If m2e is not installed yet please download it from [m2e|http://download.eclipse.org/technology/m2e/releases]. + +Using Karaf-bundle-archetype a simple projects called simpleBundle. + +We need to instruct maven-bundle-plugin configuration like this: + +* manifestLocation to META-INF +* unpackBundle to true + +{noformat} +<plugin> + <groupId>org.apache.felix</groupId> + <artifactId>maven-bundle-plugin</artifactId> + <version>2.3.7</version> + <extensions>true</extensions> + <configuration> + <manifestLocation>META-INF</manifestLocation> + <unpackBundle>true</unpackBundle> + <instructions> + <Bundle-SymbolicName>${project.artifactId}</Bundle-SymbolicName> + <Bundle-Version>${project.version}</Bundle-Version> + <Bundle-Activator>org.apache.karaf.eik.manual.simpleBundle.Activator</Bundle-Activator> + <Export-Package> + org.apache.karaf.eik.manual.simpleBundle*;version=${project.version} + </Export-Package> + <Import-Package> + * + </Import-Package> + </instructions> + </configuration> +</plugin> +{noformat} + + +* Right click on project -> Maven -> Update Project... +* Right click on project -> RunAs -> Maven install + + +from Debug Configurations is possible to see simpleBundle + +!/images/devcomponentwithm2e_1.png! + +Run Eik and to verify the installed bundle were started type osgi:list + +!/images/devcomponentwithm2e_2.png! + + + + + + + + + + + + + + + + + + + + + + http://git-wip-us.apache.org/repos/asf/karaf-eik/blob/006fa10f/manual/src/main/webapp/user-guide/index.conf ---------------------------------------------------------------------- diff --git a/manual/src/main/webapp/user-guide/index.conf b/manual/src/main/webapp/user-guide/index.conf index 7d1ddb8..a794a20 100644 --- a/manual/src/main/webapp/user-guide/index.conf +++ b/manual/src/main/webapp/user-guide/index.conf @@ -8,3 +8,4 @@ h1. Eclipse Integration Karaf User Guide * [View loaded bundle |/user-guide/loadbundle] * [Uninstalling |/user-guide/uninstall] * [Developing OSGi components|/user-guide/devcomponent] +* [Developing OSGi components with m2e|/user-guide/devcomponentwithm2e]
