Export Your OSGi Bundle

From CDOT Wiki
Jump to: navigation, search

Export Your OSGi Bundle

In this example, you'll export an OSGi bundle (as a JAR file) into a directory on your local file system. This bundle could then be installed and run in any OSGi-enabled container.

NOTE: Yes, OSGi bundles are just JAR files. This means they can be used in the same way as any other JAR file. However, if an OSGi bundle (JAR) is deployed onto a non-OSGi enabled container, the OSGi meta data (inside MANIFEST.MF) will simply be ignored.

First, start with the OSGi project you wish to bundle.

Bundle-1.png

Check the manifest by viewing it in your editor.

Bundle-2.png

Right click, then select Run As -> Run Configurations ...

Bundle-3.png

Give your configuration a name, and deselect Target Platform - leaving only your project. Now click Apply followed by Run.

Bundle-4.png

In the Console window you can see your bundle running.

Bundle-5.png

Type 'ss' inside the Console window to see the ID of your bundle.

Bundle-6.png

Use the 'stop' command to stop your bundle. Then click the red square just above the Console window to stop the execution environment.

Bundle-7.png

Now click on the File menu and select Export.

Bundle-11.png

Select Plug-in Development -> Deployable plug-ins and fragments.

Bundle-12.png

Select the project to export and give the directory name on your local file system that will hold your OSGi bundle. Then check the Options tab.

Bundle-13.png

Uncheck Export Source (if necessary) and then click Finish.

Bundle-14.png

Open a terminal window and verify that your bundle was saved.

Bundle-15.png

Congratulations! You've just exported your OSGi bundle onto your local file system.