Developer setup

Overview

  • Setting up your Eclipse to start developing on jUCMNav is fairly straightforward but there are a few things to remember.
  • This guide was initially written for Eclipse 3.0.1 and upgraded, some aspects may have changed as Eclipse evolves...
  • We now need Eclipse 4.4 and above as a development environment.

Installing Eclipse and required plug-ins

Eclipse 4.4 Modeling Tools or more recent

  • IMPORTANT: Alternatively, you can unzip the attached bundle zip file to your eclipse/plugins folder. It does not contain what is required to run Web services for dynamically feeding data to KPI values, but it allows to compile and run the tool.

Setup from Subversion Server (SVN)

Install Subclipse

  • Help -> Install New Software...
  • Add Remote Site
    • Name: subclipse
    • URL: https://dl.bintray.com/subclipse/releases/subclipse/latest/
  • Select all subclipse update site (others have been added) (Next)
  • Select all features (Next)
  • Accept the terms (Next)
  • Finish

Checkout the code

Checkout takes the code from the repository and saves it on your machine.
  • Window -> Show View -> Other -> SVN -> SVN Repository
  • Right click in SVN Repository view -> New -> Repository Location
  • Location Url: svn://cserg0.site.uottawa.ca/projetseg/
  • svn://cserg0.site.uottawa.ca/projetseg/ -> trunk -> seg.jUCMNav (right click) -> Checkout as project
Checking out the code does not require a username/password. However, commiting core requires it. If you need authentication user/password, contact damyot@uottawa.ca

NOTE: If you get an error about JavaHL, please see this relevant information. (Thanks Marc van Zee for reporting this!)

Setup project properties

Eclipse 4.2 and above

We use JDK 1.7 compatibility (should also work with 1.8). JDK 1.6 is no longer sufficient. Follow the following steps.
  • Right-click on the seg.jUCMNav project you just created, choose properties.
  • Choose Java Compiler
  • Check Enable Project Specific Settings
  • Put the JDK compliance to 1.7 as in the following screenshot.
  • Accept this and give Eclipse a while to rebuild the solution.

JDK.png

Run/Debug/Test jUCMNav

  • Developers should always have assertions enabled when running jUCMNav as our commands are built to catch bugs using assertions.
  • In the Debug or Run configuration preferences (accessible by right-clicking on the project name), select Run-time workbench as the configuration used to run jUCMNav. Create a new configuration (jUCMNav) if necessary.
  • Make sure you have the -ea Java Virtual Machine attribute set.
  • jUCMnav: Runtime workbench settings

debug.png

  • To test jUCMNav, create a new JUnit Plug-in Test for the test class seg.jUCMNav.tests.TestAllTestSuite and don't forget the -ea JVM attribute!

Last thing, coding standards

-- DanielAmyot - 05 Jun 2015
Topic attachments
I Attachment Action Size Date Who Comment
debug.pngpng debug.png manage 73 K 05 Jun 2015 - 12:27 DanielAmyot Enable Assertion option (-ea)
DevDocCheckoutCode1.jpgjpg DevDocCheckoutCode1.jpg manage 83 K 08 Jul 2005 - 14:16 JasonKealey jUCMNav: Run-time workbench settings
DevDocCheckoutCode2.JPGJPG DevDocCheckoutCode2.JPG manage 63 K 08 Jul 2005 - 14:18 JasonKealey jUCMnav: TestAllTestSuite settings (1)
DevDocCheckoutCode2V2.JPGJPG DevDocCheckoutCode2V2.JPG manage 68 K 23 Dec 2005 - 17:08 UnknownUser jUCMnav: TestAllTestSuite settings (1)
DevDocCheckoutCode3.JPGJPG DevDocCheckoutCode3.JPG manage 84 K 08 Jul 2005 - 14:20 JasonKealey jUCMnav: TestAllTestSuite settings (2)
DevDocCheckoutCode4.JPGJPG DevDocCheckoutCode4.JPG manage 58 K 08 Jul 2005 - 14:23 JasonKealey jUCMNav: Java Compiler Compliance Preferences
javasettings.pngpng javasettings.png manage 26 K 14 Jan 2006 - 17:32 JasonKealey jUCMNav: Java Compiler Compliance Preferences
JDK.pngpng JDK.png manage 75 K 05 Jun 2015 - 12:26 DanielAmyot JDK configuration (Eclipse 4.4 and above)
WPTbundle.zipzip WPTbundle.zip manage 1 MB 08 Apr 2008 - 22:42 DanielAmyot WPT bundle (if you do not the whole WPT)
Topic revision: r23 - 05 Oct 2016, DanielAmyot
This site is powered by FoswikiCopyright © by the contributing authors. All material on this collaboration platform is the property of the contributing authors.
Ideas, requests, problems regarding Foswiki? Send feedback