• Guide Tutorials Examples Services App notes Links FAQ Forum
  • Guide
    Tutorials
    Example Projects
    Documentation
    Service Catalog
    OSGi Specifications
    App Notes
    Where to Find Stuff
    Videos
    Known Issues
    Frequently Asked Questions
  • Prev Next

    This website and its associated repositories, are deprecated and no longer supported by the OSGi Alliance. Please visit https://enroute.osgi.org for the latest supported version of OSGi enRoute.

    This enRoute v2 archive site is kept for those who do not intend to use the latest version of OSGi enRoute. If you are new to OSGi enRoute, then please start with the latest OSGi enRoute.

    The Workspace

    What you will learn in this section

    We will setup a bnd(tools) workspace for OSGi enRoute so we can build an application in the next section.

    Before you start this section, make sure you’ve checked the prerequisites for OSGi enRoute on your platform.

    The Workspace

    OSGi enRoute requires that you group a number of projects in a bnd workspace. A bnd workspace is basically a directory with a cnf directory. We start with a template workspace by getting it from git.

    This is the BETA tutorial for OSGi enRoute 2.0.0. To use the right workspace template, go to Bndtools preferences and select Workspace Templates. You should edit the OSGi enRoute template and select the next branch.

    This tutorial requires Bndtools 3.3.0 or later, the workspace templates were added in 3.2.0

    We generally advise you to place things in your home directory (~). However, Eclipse does not recognize the tile (~) as a reference to your home directory so different paths are shown in the pictures.

    Two Workspaces???

    First get some confusing stuff out of the way. We will have two (2) workspaces:

    • Eclipse – The Eclipse workspace. An Eclipse workspace is a directory with a .metadata directory. In OSGi enRoute tutorials we never place any projects in this directory. This directory will never be stored in Git or another SCM, it should therefore only contain your local preferences and information. To make it easy to switch between Eclipse workspaces, it is suggested to place all Eclipse workspaces in one easy to access directory. For example /Ws/eclipse.
    • bnd – All projects will reside in a single bnd workspace directory. The bnd workspace is stored in Git or an alternative SCM. It must therefore never contain any personal stuff. A bnd workspace is flat, the cnf directory and all project directories must reside in exactly the same parent directory, which is the workspace directory. Sorry, no exceptions. The bnd workspaces could be grouped in a directory for Git. Eclipse recommends ~/git.

    The structure is depicted in the following illustration:

    Eclipse & bnd workspace

    Opening Eclipse (Or Switching Workspace)

    If you start Eclipse you will have to open the Eclipse workspace, see the previous issues. At the start of Eclipse (or when you do File/Switch Workspace) you will see the following dialog:

    Switch Workspace

    After filling in the proper path and then closing the dialog by clicking OK, we get an Eclipse restart. After Eclipse is done, we should finally get:

    Start Screen

    Creating the bnd Workspace

    To create a new bnd Workspace we use the New/Other/Bndtools/Bnd OSGi Workspace menu:

    Select New Workspace Wizard

    Select Bnd OSGi Workspace and click Next. This will bring you to a dialog that allows you to specify the location of the bnd workspace. Here we must select the Create in radio button because it is bad practice to use the same directory for the bnd workspace as the Eclipse workspace as explained before.

    bnd workspace location

    Clicking on Next will bring us to the window that selects the template that we will use. In this case we will obviously choose the OSGi enRoute template.

    Select OSGi enRoute Template

    After you selected the template and clicked Next then Bndtools will show you proposed new content of the workspace in a list. If you would update an existing workspace you could control any conflicts.

    Content list

    In our case we just click Finish and we’re done! Our Eclipse should look like:

    Empty IDE with just cnf

    File System

    Since we made changes to your file system, a short summary of where we placed what.

    The Eclipse workspace was placed in a special place for Eclipse workspaces, the ~/eclipse directory. We named this workspace com.acme.prime, which is a good name. The bnd workspace was placed also in your home directory, in the ~/git directory, also under the name com.acme.prime; using the same name for both the Eclipse and bnd workspaces is a good practice.

    Next

    In the next section of this quick start tutorial we will create a sample application.


    Prev Next
    • Copyright © 2021 OSGi™ Alliance.