IDE for OSGi and project setups

This page describes the process of consuming the projects provided by the OSGi Alliance from their Github site.

It consists of 2 phased process, which involves interactions on the github.com website and on your local machine.

Setup local IDE for the creation of a PR - PullRequest

Probably you have got an anwser from Peter Kriens including an invitation for a PR. Then this process describes how to accept this invitation ;-)

GitHub: create a fork of a project
local: execute the engage[.sh|.cmd]
local: select IDE for OSGi product and project you forked on GitHub
local: edit the project inside the IDE instance and commit your changes to your GitHub fork
GitHub: create pull request for the changes you made

open a terminal/shell create a installation directory <instDir> e.g. mkdir ~/<instDir>

copy the following line and execute it inside <instDir>

powershell -command "& {(New-Object System.Net.WebClient).DownloadFile('http://peterkir.github.io/idefix/bootstrap/osgi/win32/engage.cmd','engage.cmd')}" & engage.cmd
curl https://peterkir.github.io/idefix/bootstrap/osgi/macosx/engage.sh >engage.sh && chmod +x ./engage.sh && ./engage.sh

on the top-right folder icon mark the OSGi products [required only after initial installation]
select from the section at the bottomOSGi products the product you want to install e.g. IDEfix for OSGi Mars and press Next
on the top-right folder icon mark the OSGi projects [required only after initial installation]
scroll down to OSGi projects and check the projects you want to work e.g. osgi.design on and press Next
configure the variables and press Next
review the tasks and if satisfied press Finish
Press "Accept" in the appearing "Licenses" pop-up window
Eclipse IDE should appear with the "Bndtools - Eclipse" perspective open.
Eclipse Installer can be closed now and IDE with your project is ready.

IDE for OSGi can be started from now via <githubProject-branchname>\eclipseInstaller\eclipse.exe
IDE for OSGi can be started from now via <githubProject-branchname>\Eclipse.app

eclipseInstaller can be started from now via <installDir>\eclipseInstaller\eclipse.exe
eclipseInstaller can be started from now via <installDir>\Eclipse Installer.app

the installation creates (additionally to the <installDir> folder) following directories (~ means %USERPROFILE% on windows)

~/.eclipse/org.eclipse.oomph.* containing the oomph preferences and user-specified variables
~/.p2 containing the shared bundle pool for all oomph installations