Notice: This Wiki is now read only and edits are no longer possible. Please see: https://gitlab.eclipse.org/eclipsefdn/helpdesk/-/wikis/Wiki-shutdown-plan for the plan.
Nebula/Contributions/Setup IDE
Get your Eclipse Credentials
To provide patches to Nebula, create an Eclipse account, get your Gerrit password and push your changes to the Gerrit git repo.
Create an Eclipse Account
Create an Eclipse Account (or use your existing one)
Sign the CLA
Get your Gerrit Password
When you push to our Gerrit repo you have to do that with your Gerrit user and password, not with your Eclipse password.
Three Ways to Setup Your IDE
To setup your IDE there are three possibilities. Using Oomph is the easiest for newcomers.
- Use Oomph
- Import our PSF file
- 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://git.eclipse.org/c/nebula/org.eclipse.nebula.git/plain/oomph.setup
Import our PSF File
Copy and paste this file into a file.psf inside an eclipse project select it and use "Import Project Set..." from the context menu.
Clone the GIT Repo Manually
The Nebula repository settings can be found here https://git.eclipse.org/r/#/admin/projects/nebula/org.eclipse.nebula
C:\>git clone https://yourname@git.eclipse.org/r/a/nebula/org.eclipse.nebula
Change the Push URI
Finally you need to change the target ref for push. It should change from /refs/heads/master to /refs/for/master. The config file should look like this (use properties on the repository context menu in Eclipse)
[remote "origin"] url = https://yourname@git.eclipse.org/r/nebula/org.eclipse.nebula.git fetch = +refs/heads/*:refs/remotes/origin/* fetch = refs/notes/*:refs/notes/* pushurl = https://yourname@git.eclipse.org/r/a/nebula/org.eclipse.nebula push = HEAD:refs/for/master
You can also use "Gerrit Configuration..." in Eclipse to do this:
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
Configure Gerrit
Open Remotes/origin and open the context menu. Select Gerrit Configuration.
Review and press Finish
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.
Run Eclipse
Create a new run configuration and press Run
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.