You are here: ProjetSEG Web>JUCMNavDevDoc>DevDocCheckoutCode (05 Oct 2016)

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

-- Daniel Amyot - 05 Jun 2015

Topic attachments
I Attachment Action Size Date Who Comment
jpgjpg DevDocCheckoutCode1.jpg manage 83.0 K 08 Jul 2005 - 14:16 Jason Kealey jUCMNav: Run-time workbench settings
jpgJPG DevDocCheckoutCode2.JPG manage 63.7 K 08 Jul 2005 - 14:18 Jason Kealey jUCMnav: TestAllTestSuite settings (1)
jpgJPG DevDocCheckoutCode2V2.JPG manage 68.4 K 23 Dec 2005 - 17:08 Unknown User jUCMnav: Test All Test Suite? settings (1)
jpgJPG DevDocCheckoutCode3.JPG manage 84.6 K 08 Jul 2005 - 14:20 Jason Kealey jUCMnav: TestAllTestSuite settings (2)
jpgJPG DevDocCheckoutCode4.JPG manage 58.9 K 08 Jul 2005 - 14:23 Jason Kealey jUCMNav: Java Compiler Compliance Preferences
pngpng JDK.png manage 75.7 K 05 Jun 2015 - 12:26 Daniel Amyot JDK configuration (Eclipse 4.4 and above)
zipzip WPTbundle.zip manage 1709.7 K 08 Apr 2008 - 22:42 Daniel Amyot WPT bundle (if you do not the whole WPT)
pngpng debug.png manage 73.9 K 05 Jun 2015 - 12:27 Daniel Amyot Enable Assertion option (-ea)
pngpng javasettings.png manage 26.1 K 14 Jan 2006 - 17:32 Jason Kealey jUCMNav: Java Compiler Compliance Preferences
Topic revision: r23 - 05 Oct 2016 - 22:09:02 - Daniel Amyot
 
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