Skip to main content
Jump to: navigation, search

Difference between revisions of "Nebula/Contributions/Setup IDE"

(Move from gerrit/Eclipse git server to PRs and GitHub)
(Import our PSF File)
Line 21: Line 21:
 
[https://raw.githubusercontent.com/eclipse/nebula/master/oomph.setup https://raw.githubusercontent.com/eclipse/nebula/master/oomph.setup]
 
[https://raw.githubusercontent.com/eclipse/nebula/master/oomph.setup https://raw.githubusercontent.com/eclipse/nebula/master/oomph.setup]
  
=== Import our PSF File ===
+
=== Import Project Set File ===
Copy and paste [https://raw.githubusercontent.com/eclipse/nebula/master/releng/org.eclipse.nebula.feature/Nebula_All.psf this file] into a file.psf inside an eclipse project select it and use "Import Project Set..." from the context menu.
+
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.
  
(https://raw.githubusercontent.com/eclipse/nebula/master/releng/org.eclipse.nebula.feature/Nebula_All.psf)
+
The wizard will fail if git was not setup correctly or if the nebula git directory already exists 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]
  
 
=== Clone the GIT Repo Manually ===
 
=== Clone the GIT Repo Manually ===

Revision as of 09:44, 18 August 2018

Get your Eclipse Credentials

To provide patches to Nebula, create an Eclipse account, sign the ECA and get a GitHub account.

Create an Eclipse Account

Create an Eclipse Account (or use your existing one)

Sign the ECA

Sign the ECA

Create a GitHub Account

Create a GitHub account (or use your existing one)

Three Ways to Setup Your IDE

To setup your IDE there are three possibilities. Using Oomph is the easiest for newcomers.

  1. Use Oomph
  2. Import our PSF file
  3. Setup manually

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.
https://raw.githubusercontent.com/eclipse/nebula/master/oomph.setup

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 wizard will fail if git was not setup correctly or if the nebula git directory already exists 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.

[1]

Clone the GIT Repo Manually

The Nebula repository on GitHub is here: https://github.com/eclipse/nebula. For example:

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

Forking and Pull Requests

To be able to submit a Pull Request you need to fork the Nebula repository. See GitHub's extensive documentation on working with Pull Requests. Start with the GitHub flow overview and then continue with the rest of the documentation.

Start Eclipse

Open your Eclipse IDE and open the Git perspective

Add Local Git Repo

Add a local Git repository and find your freshly created repo


Import Projects

If you did not use the psf file then you have to use git to import the relevant projects. Import the widgets you want to work on from the widgets directory and import the first two example projects from the example directory.

Nebula proj 1.png

Run Eclipse

Create a new run configuration and press Run

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.

Back to the top