Skip to content

Creating an Eclipse Development Environment for Dialog

Jump to bottom
Andrew Crapo edited this page Jun 29, 2020 · 7 revisions

This document provides step-by-step instructions for creating an Eclipse Plug-in Development Environment for the Dialog grammar and IDE. Below are described setup steps, followed by two different ways of installing Eclipse, followed by steps to be taken after installing Eclipse, regardless of which method of installation was followed. These instructions are for setting up a development environment on a local machine.

Setup steps

  1. Create a folder in the local file system under which the source code and Eclipse workspace will be located. (For example, on MS Windows this might be "c:\darpa-aske\dialog".) This folder will be referred to as DEV-HOME.
  2. Create a folder under DEV-HOME named "git".
  3. Clone the SADL github repository under DEV-HOME/git.
  • Using Git Bash client, change directory so that the DEV-HOME/git is the current directory
  • Make a folder named "sadlos2"; change directory to this folder (DEV-HOME/git/sadlos2)
  • Go to SADL project on github.com: https://github.com/crapo/sadlos2/
  • Copy the URL for cloning by clicking on the button "Clone or download"
  • In the Git Bash client, type "git clone " and then paste in the URL copied in the previous step
  1. Clone the DARPA-ASKE-TA1 github repository under DEV-HOME/git.
  • Using Git Bash client, change directory so that the DEV-HOME/git is the current directory
  • Make a folder named "DARPA-ASKE-TA1"; change directory to this folder (DEV-HOME/git/DARPA-ASKE-TA1)
  • Go to DARPA-ASKE-TA1 project on github.com: https://github.com/GEGlobalResearch/DARPA-ASKE-TA1/
  • Copy the URL for cloning by clicking on the button "Clone or download"
  • In the Git Bash client, type "git clone " and then paste in the URL copied in the previous step
  1. Download and install (if not already present) the Java 9 JDK (see https://www.oracle.com/technetwork/java/javase/downloads/index.html
  2. Install Eclipse 2020-03 by one of the methods below

Method 1: Install Eclipse by Direct Download

  1. Download and install "Eclipse IDE for Java and DSL Developers" (see https://www.eclipse.org/downloads/packages/). Eclipse 2020-03 is recommended but newer versions should work.
  2. Configure proxies if behind a firewall (Preferences -> General -> Network Connections)

Method 2: Using the Eclipse Installer

  1. Download the Eclipse Installer

  2. C. Change to Advanced Mode

  3. Configure proxies if behind a firewall (mouse over icons on lower left corner until the one for Network Proxies settings is found)
  4. Select Eclipse DSL Tools as the Platform
  5. Select 2020-03 or later as the version
  6. Finish

Configure Eclipse

  1. Start Eclipse and configure as follows:
  • Make the Java 9 JDK the default JRE (Window -> Preferences -> Java -> Installed JREs -> Add, then browse to the folder where the Java 9 JDK is installed, select. Once added, check to make default.)
  • Switch workspace to DEV-HOME/ws (File -> Switch Workspace -> Other..., then Browse to and create folder "ws".
  • Import as Maven projects the following SADL and DARPA-ASKE-TA1 projects (File -> Import... -> Maven -> Existing Maven Projects):
    • sadlos2/sadl3/com.ge.research.sadl.parent and all projects under it except
    • DARPA-ASKE-TA1/com.ge.research.darpa.aske.dialog.parent and all projects under it
  1. Select all imported projects in the Package Explorer window and do a Maven Project Update (right-click on the selected projects, select Maven -> Update Project...)
  2. Set the target platform to com.ge.research.sadl.target (Window -> Preferences -> Plug-in Development -> Target Platform, check "com.ge.research.sdl.target, then click "Apply and Close")
  3. Make sure that Build Automatically... is checked (on the toolbar's Project dropdown menu, "Build Automatically should be checked; if not check it)
  4. With all projects selected, clean and build all projects (Project -> Clean...)

Clone this wiki locally