Dark Planet Development Platform

Pre-Requisites: Setting up Eclipse for DPS Development with OSGi

1. Install Java 6 or better. Older versions back to Java 4 should work but haven't been tested. If you decide to use an older JDK, you'll need to change the MANIFEST files in the bundles as they specify Java 6 as the minimum runtime environment.
2. Make sure you have Eclipse Helios or better with the Plug-in Development Environment (PDE). Older versions of Eclipse may work but haven't been tested. If you can get to the "Plug-In Development" perspective in Eclipse then you likely have everything you need.
3. Download or checkout the following bundle dependencies:
   • hibernate-3
   • org.apache.log4j_1.2.13.v200903072027
   Extract these as projects into your Eclipse workspace. These are the minimum required bundles dependencies. The reference implementations require a few more bundles but that's covered in the appropriate tutorials.
4. (optional) If you plan to release your own OSGi-based DPS application then you'll eventually want to install our build target or create your own. We advise that you skip setting the build target for now as it's a large download and you really don't need it for initial development.

   The build target defines the base bundles which will be included when you release an OSGi application. Our build target includes something called the "delta pack", as well as bundles for RCP (Rich Client Platform) and Equinox. This is a very common style of target platform which includes things you'll need to run on different operating systems (the delta pack), things you'll need to run OSGi (Equinox), and things you'll need if you want to build Eclipse driven GUI tools (the RCP). As a result, our build target is pretty large, about 200 MB. If you want to install our build target then download or checkout "EveTarget" and extract it as a project in your Eclipse workspace. You can set "EveTarget" as your build target as follows:

   1. Select Window->Preferences->Plug-in Development->Target Platform
   2. Look for the entry called "BaseEveTarget".
   3. Select the checkbox beside "BaseEveTarget" and click "Apply" and "Ok".

How to Import Downloaded Bundles

Eclipse makes it very easy to import a bundle:

1. First download the appropriate bundle. This will give you a JAR file.
2. Open up Eclipse and select File->Import...->Plug-in Development->Plug-ins and Fragments.
3. Under "Import From" choose "Directory" and browse to the directory where you downloaded the jar.
4. Under "Plug-ins and Fragments to Import" choose "Select from all plug-ins...".
5. Under "Import As" you have a choice. You can choose "Binary projects" if you just want the compiled JAR dependency, or you can choose "Projects with source folders" to create a project with the downloaded source placed in the "src" folder.
6. Click "Next >" and select the plug-ins you want to import.
7. Click "Finish" and you're done, you should see the imported bundle in your workspace.

Special Handling for Unit Testing and Reference Implementation Unit Tests