Setting up the Development Environment
Contents
Using Eclipse
In a nutshell
Install Eclipse IDE for Java Developers from here
Install Subclipse Plug-in (update site: http://subclipse.tigris.org/update_1.6.x)
Check out the LarKC Platform from the SVN repository (https://larkc.svn.sourceforge.net/svnroot/larkc/trunk)
- Build the LarKC Platform with Maven
Prerequisites
Before starting make sure that you have
Java installed (in this guide version 1.6 was used)
Install Eclipse
Download Eclipse IDE for Java Developers from here
- Extract the downloaded archive file to a folder of your choice
Start Eclipse by running eclipse.exe on Windows and eclipse on Unix
NOTE: If you have installed an Eclipse version different to Eclipse IDE for Java Developers (Eclipse Indigo) you have to install the m2eclipse plug-in. To check whether you have a Maven integration in Eclipse select in the menu Window -> Preferences. If you find an entry Maven in the left column you have installed Maven and can skip the next step.
OPTIONAL: Install m2eclipse Plug-In
Prerequisites: Eclipse
To install the m2eclipse plug-in, start Eclipse and select in the menu Help -> Install new software. A new window pops up where, by clicking on Add, a name and a location can be defined where the desired plug-in can be found. In our case we fill in the following values:
- Name: m2eclipse
Location: http://download.eclipse.org/technology/m2e/releases
After confirming (clicking Ok) the available software is listed and we mark the checkbox Maven Integration for Eclipse. When clicking Next two times we have to accept the terms of the license agreement and can then start installing the plug-in (Finish). When the installation process is finished we can restart Eclipse and we are done.
Install Subclipse Plug-In
Prerequisites: Eclipse
To install the subclipse plug-in, start Eclipse and select in the menu Help -> Install new software. A new window pops up where, by clicking on Add, a name and a location can be defined where the desired plug-in can be found. In our case we fill in the following values:
- Name: subclipse
Location: http://subclipse.tigris.org/update_1.6.x
After confirming (clicking Ok) the available software is listed and we mark the following checkboxes:
- Core SVNKit Library
- Optional JNA Library (recommended)
- Subclipse
When clicking Next two times we have to accept the terms of the license agreement and can then start installing the plug-in (Finish). When the installation process is finished we can restart Eclipse and we are done.
Check out the LarKC Platform
Prerequisites: Eclipse, Subclipse Plug-In
To check out the LarKC platform a SVN repository location has to be defined. Therefore you have to open the SVN Repository Exploring Perspective. To show this perspective go to Window -> Open Perspective -> Other... and select SVN Repository Exploring Perspective. Add a new SVN Repository with the following URL: https://larkc.svn.sourceforge.net/svnroot/larkc/trunk. By clicking Finish the SVN Repository appears on the left side.
To check out the platform expand the entry on the left side and do a right click on the folder platform. Select Checkout... and mark the option "Check out as a project in the workspace". By clicking Finish the source code of the LarKC platform gets checked out, which takes a while.
Build the LarKC Platform
Prerequisites: Java JDK, Eclipse, Maven (integrated in the Eclipse distribution or m2eclipse Plug-in), checked out LarKC platform
In order to build the LarKC platform, do a right click on the platform project. Then choose Run As -> Run Configurations.... A new window opens where we can create a new maven run configuration by double clicking on Maven Build on the left side. Then we can define a name for new run configuration (e.g. platform clean install). We also have to specify the base directory which is the root directory of the platform project (Browse Workspace and select the folder of the LarKC platform project). By doing so the value for the base directory should be ${workspace_loc:/platform}. Furthermore we select the goals (e.g. clean install, several goals a separated by a space). When we now click on Run the platform gets build and all JUnit tests executed (If the tests should not be executed, mark the checkbox Skip Tests).