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)
 
(28 intermediate revisions by 2 users not shown)
Line 1: Line 1:
 
== Get your Eclipse Credentials ==
 
== 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 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 ===
 
=== 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===
+
[https://git.eclipse.org/r/#/settings/http-password Get your Gerrit password]
+
  
 +
=== Sign the ECA ===
 +
[https://wiki.eclipse.org/Development_Resources/Contributing_via_Git#Eclipse_Contributor_Agreement Sign the ECA]
  
 
== Three Ways to Setup Your IDE ==
 
== Three Ways to Setup Your IDE ==
To setup your IDE there are three possibilities. Using Oomph is the easiest for newcomers.
+
To setup your IDE there are three possibilities. Using the project set file is the easiest for newcomers.
  
 +
# Import our PSF file
 
# Use Oomph
 
# Use Oomph
# Import our PSF file
 
 
# Setup manually
 
# Setup manually
  
== 1. Import with Oomph ==
+
=== 1. Import Project Set File ===
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.
+
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.  
<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 ==
+
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.
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.
+
  
(http://git.eclipse.org/c/nebula/org.eclipse.nebula.git/plain/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 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.
  
== 3. Clone the GIT Repo Manually ==
+
[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]
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
 
  
=== Change the Push URI ===
+
=== 2. Import with Oomph ===
Change the push URI to https://'''''yourname'''''@git.eclipse.org/r/<big>'''''p'''''</big>/nebula/org.eclipse.nebula.git
+
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]
  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 ===
+
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.
+
 
+
 
+
[[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 ===

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