Skip to main content

Notice: this Wiki will be going read only early in 2024 and edits will no longer be possible. Please see: https://gitlab.eclipse.org/eclipsefdn/helpdesk/-/wikis/Wiki-shutdown-plan for the plan.

Jump to: navigation, search

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

(Three Ways to Setup Your IDE)
 
(29 intermediate revisions by 2 users not shown)
Line 1: Line 1:
== Setup Your 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. To setup your IDE there are three possibilities. Using Oomph is the easiest for newcomers.
+
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].
  
# Use Oomph
+
=== Create a GitHub Account ===
# Import our PSF file
+
[https://github.com/join Create a GitHub account] (or use your existing one)
# Setup manually
+
  
 
=== Create an Eclipse Account ===
 
=== Create an Eclipse Account ===
[https://dev.eclipse.org/site_login/createaccount.php Create an Eclipse Account] (or use your existing one)
+
[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 CLA ===
+
[http://wiki.eclipse.org/Development_Resources/Contributing_via_Git#Eclipse_Foundation_Contributor_License_Agreement Sign the CLA]
+
  
=== Get your Gerrit password===
+
=== Sign the ECA ===
[https://git.eclipse.org/r/#/settings/http-password Get your Gerrit password]
+
[https://wiki.eclipse.org/Development_Resources/Contributing_via_Git#Eclipse_Contributor_Agreement Sign the ECA]
  
=== 1. Import with Oomph ===
+
== Three Ways to Setup Your IDE ==
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.
+
To setup your IDE there are three possibilities. Using the project set file is the easiest for newcomers.
<br/>
+
[https://git.eclipse.org/c/nebula/org.eclipse.nebula.git/plain/oomph.setup https://git.eclipse.org/c/nebula/org.eclipse.nebula.git/plain/oomph.setup]
+
  
=== 2. Import our psf file ===
+
# Import our PSF file
Copy and paste [http://git.eclipse.org/c/nebula/org.eclipse.nebula.git/plain/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.
+
# Use Oomph
 +
# Setup manually
  
(http://git.eclipse.org/c/nebula/org.eclipse.nebula.git/plain/releng/org.eclipse.nebula.feature/Nebula_All.psf)
+
=== 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.  
  
=== 3. clone the GIT repo ===
+
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.
or clone the following repo https://'''''yourname'''''@git.eclipse.org/r/nebula/org.eclipse.nebula.git
+
  
  C:\>git clone https://'''''yourname'''''@git.eclipse.org/r/nebula/org.eclipse.nebula.git
+
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.
  
==== Change the push URI ====
+
[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]
Change the push URI to https://'''''yourname'''''@git.eclipse.org/r/<big>'''''p'''''</big>/nebula/org.eclipse.nebula.git
+
  
 
 
  C:\>cd org.eclipse.nebula
 
  C:\org.eclipse.nebula>git remote set-url --push origin  https://'''''yourname'''''@git.eclipse.org/r/p/nebula/org.eclipse.nebula.git
 
  
==== Start Eclipse ====
+
=== 2. Import with Oomph ===
Open your Eclipse IDE and open the Git perspective
+
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/>
==== Add local Git repo ====
+
[https://raw.githubusercontent.com/eclipse/nebula/master/oomph.setup https://raw.githubusercontent.com/eclipse/nebula/master/oomph.setup]
Add a local Git repository and find your freshly created repo
+
 
+
==== Configure Gerrit ====
+
Open Remotes/origin and open the context menu. Select Gerrit Configuration.
+
 
+
 
+
[[Image:nebula_ide1.png]]
+
 
+
 
+
Review and press Finish
+
  
  
[[Image:nebula_ide2.png]]
+
=== 3. Clone the GIT Repo Manually ===
 +
The Nebula repository on GitHub is here: https://github.com/eclipse/nebula. For example:
  
==== Import Projects ====
+
  C:\Users\You\git>git clone https://github.com/eclipse/nebula.git
If you did not use the psf file you are you are ready to import the relevant projects. Import all widgets from the widgets directory and import the first two example projects from the example directory.
+
  
[[Image:nebula_proj_1.png]]
+
== Find the Nebula Examples View ==
  
==== Run Eclipse ====
+
=== Run Eclipse ===
 
Create a new run configuration and press Run
 
Create a new run configuration and press Run
  
 
[[Image:nebula_ide3.png]]
 
[[Image:nebula_ide3.png]]
  
==== Open Nebula Perspective ====
+
=== 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.
 
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.

Latest revision as of 17:25, 9 November 2018

Get your Eclipse Credentials

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

Create a GitHub Account

Create a GitHub account (or use your existing one)

Create an Eclipse Account

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

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.

  1. Import our PSF file
  2. Use Oomph
  3. 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 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


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.
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

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