Skip to main content

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.

Jump to: navigation, search

JDT Code Setup Using Oomph

This page is a simple starting point for where to begin when wanting to contribute to the JDT project using Oomph. The goal of this wiki page is to help users to set up coding workspace for JDT components using Oomph.

Note.png
Note
There is also a more comprehensive page Eclipse_Platform_SDK_Provisioning, which explains how to pull in even more Eclipse projects and also explains working with Oomph in more detail.


Setting up Oomph

Oomph can be extracted to a local folder after downloading it from Eclipse Installer (by Oomph).
You can learn more about the Oomph project at https://projects.eclipse.org/proposals/oomph
FAQ is available at Eclipse_Oomph_FAQ

Using Oomph

Selecting Advanced Mode

Code setup using Oomph Installer for Eclipse is available in Advanced mode.
OomphAdvancedMode.PNG

Commonly used Preferences

Eclipse has many workspace-specific preferences. Oomph helps us set the preferences across all workspaces.
Oomph can manage following preferences and by enabling the last preference (Enable Oomph Preference Recorder), any preference set later can be managed by Oomph:

  • Refresh Resources Automatically?
  • Show Line Numbers in Editors?
  • Check Spelling in Text Editors?
  • Execute Jobs in Background?
  • Encode Text Files with UTF-8?
  • Enable Oomph Preference Recorder?

Eclipse Product and Version selection

Select Eclipse Product as "Eclipse IDE for Java Developers"
Product version can be selected as required.

ProductSelection.PNG

Project Selection

Projects to be selected for components JDT Core, JDT UI and JDT debug:

CoreProject.PNGUIProject.PNGDebugProject.PNG


Variable Selection

Rules and details for Install, Workspace and JRE can be selected based on user choice. For each project (Core, UI and Debug) Git Feature repository connection method needs to be selected. For Core Project there are 2 repositories( Core and Binaries). User can use Git or Gerrit based on there convenience. User without Commit rights should use HTTPS and with commit rights should use SSH. If they have Gerrit account, they can use HTTPS(read-write, gerrit). HTTP (read only, anonymous, direct) will be the simplest to use.

Wait for the setup to complete

After Eclipse launches, the workspace is still being set up for JDT development. See the platform SDK provisioning page for details.

Using Oomph but checkout and prepare older branch (2020-06)

Eclipse IDE for Eclipse commiters

Choose the "Product Version" you want. Take care of the java version. For 2020-06 we need java 8.

ScreenshotOOMP1.png

Projects

Choose the projects - all JDT projects and platform news for the "News & Noteworthy" pages could be useful.

ScreenshotOOMP2 checkprojects.png

Variables

It automatically increases a postfix number in case you have already a oomph based project with the same name.

ScreenshotOOMP3 entervalues.png

Review

Review tasks

ScreenshotOOMP4 reviewtasks.png

Task execution

Now you have to wait for the git fetch operation.

ScreenshotOOMP5 waitforsetup.png

ScreenshotOOMP6 finish.png

First build

After everything is there it builds all projects.

ScreenshotOOMP7 build.png

Switch git branch

To switch to the 4.16 (2020-06) branch you have to open the view for the git repositories.

ScreenshotOOMP8 opengit.png

Double click on the "Remote Tracking" branch for "origin/R4_16_maintenance".

ScreenshotOOMP9 remoteTracking.png

Confirm the dialog to checkout. Repeat that for all git repositories you have.

ScreenshotOOMP10 createBranch.png

Switch baseline

Now go to Navigate->Open Setup->Workspace.

ScreenshotOOMP11 navigatesetupworkspace.png

Copy and Paste the following snippet to the "workspace" node.

  1. <?xml version="1.0" encoding="UTF-8"?>
  2. <xmi:XMI xmi:version="2.0"
  3.     xmlns:xmi="http://www.omg.org/XMI"
  4.     xmlns:setup="http://www.eclipse.org/oomph/setup/1.0">
  5.   <setup:VariableTask
  6.       name="eclipse.target.platform"
  7.       value="2020-06"
  8.       storageURI="scope://Workspace"/>
  9.   <setup:VariableTask
  10.       name="eclipse.api.baseline.target.platform"
  11.       value="2020-03"
  12.       storageURI="scope://Workspace"/>
  13. </xmi:XMI>

ScreenshotOOMP12 pasteonworkspace.png

Task execution to fix baseline

Save. Then Help->Perform Setup Tasks

ScreenshotOOMP13 runsetuptasks.png

Hit "Finish" button.

ScreenshotOOMP14 finish.png

Now you have a checkout of 4.16 (2020-06) where you can work on.

Further reading

Back to the top