View source for Nebula/Contributions/Setup IDE

== Get your Eclipse Credentials ==
To provide patches to Nebula, create an [https://accounts.eclipse.org/user/register Eclipse account], sign the ECA and get a [https://github.com/join GitHub account].

=== Create a GitHub Account ===
[https://github.com/join Create a GitHub account] (or use your existing one)

=== Create an Eclipse Account ===
[https://accounts.eclipse.org/user/register Create an Eclipse Account] (or use your existing one) and set your GitHub account (this will tell Eclipse who you are on GitHub)

=== Sign the ECA ===
[https://wiki.eclipse.org/Development_Resources/Contributing_via_Git#Eclipse_Contributor_Agreement Sign the ECA]

== Three Ways to Setup Your IDE ==
To setup your IDE there are three possibilities. Using the project set file is the easiest for newcomers.

# Import our PSF file
# Use Oomph
# Setup manually

=== 1. Import Project Set File ===
In an empty workspace select the URL below and open File/Import... en find Team/Team Project Set. Paste the url in the wizard that appears and lean back. 

The PSF file will import all wizards and assign projects to [https://help.eclipse.org/photon/index.jsp?topic=%2Forg.eclipse.platform.doc.user%2Fconcepts%2Fcworkset.htm working sets] for your convenience.

The wizard will fail if git was not setup correctly or if the nebula git directory already exist or if any of the projects already exists. In this case, install git, remove the nebula directory, run with a clean workspace or any combination of the previous options.

[https://raw.githubusercontent.com/eclipse/nebula/master/releng/org.eclipse.nebula.feature/Nebula_All.psf https://raw.githubusercontent.com/eclipse/nebula/master/releng/org.eclipse.nebula.feature/Nebula_All.psf]

=== 2. Import with Oomph ===
Use the Eclipse installer or, if you have already installed Oomph, use the Oomph import wizard and select Nebula. If Nebula is not in the list, add this setup file.
<br/>
[https://raw.githubusercontent.com/eclipse/nebula/master/oomph.setup https://raw.githubusercontent.com/eclipse/nebula/master/oomph.setup]


=== 3. Clone the GIT Repo Manually ===
The Nebula repository on GitHub is here: https://github.com/eclipse/nebula. For example:

  C:\Users\You\git>git clone https://github.com/eclipse/nebula.git


== Find the Nebula Examples View ==

=== Run Eclipse ===
Create a new run configuration and press Run

[[Image:nebula_ide3.png]]

=== Open Nebula Perspective ===
Open the Nebula perspective and find the example view for your widget and test your changes. You can also test your changes by using the widget in a snippet or in your own project.