Setting up a Taxonomic Editor development environment
- This document describes all steps necessarry to create a development environment to develop the EDIT Taxonomic Editor. If you are looking for
+ This document describes all steps necessary to create a development environment to develop the EDIT Taxonomic Editor. If you are looking for
instructions on how to install the EDIT Taxonomic Editor please consult the {{{./manual.html} manual}}.
<Table of Contents>
* Requirements
- The current version of the EDIT Taxonomic Editor is developed against Eclipse PDE Version 3.6. Your PDE or at least your target platform have to have the same version.
+ The current version of the EDIT Taxonomic Editor is developed against Eclipse Indigo for RCP developers.
* Checking out the sources
* Click <Select All> to finish the wizard and import the projects into your workspace.
- You should now be able to see the taaxeditor projects in your workspace.
-
- * Install {{{http://www.eclipse.org/swtbot/downloads.php}SWTBot}} using the Eclipse-Install-Wizard via <Help -\> Install new Software> If the SWTBot repository is not already added to your Eclipse-Path
- then paste the URL in the <Work With> row. Click <Add> and use the Filter to find, check and install the SWTBot packages.
+ You should now be able to see the taxeditor projects in your workspace.
+
+ * The eclipse installation may be missing the following plugins which have to be installed via their update site:
+
+ * <SWTBot> <<API>> plugin from update site: <http://download.eclipse.org/technology/swtbot/releases/latest/>
+
+ * <Modeling-\>><<Graphical Editing Framework Zest Visualization Toolkit SDK>> from update site: <http://download.eclipse.org/releases/indigo>
- * Same procedure for the <Graphical Editing Framework Zest Visualization Toolkit SDK>. In case there is no repository already shipped with Eclipse, one can find the update URL {{{http://www.eclipse.org/gef/updates/index.php}here}}.
+ * <Nebula Release Individual Widgets-\>> <<Nebula CompositeTable Widget>> from update site: <http://download.eclipse.org/technology/nebula/archives/Q32014/release/>
+
+ * To Install the plugins use the Eclipse-Install-Wizard via <Help -\> Install new Software> and paste the URL in the <Work With> row. Click <Add> and use the Filter to find, check and install plugins.
* Dependencies
$ mvn validate
---
+ The maven pom.xml provides a special profile which you may want to use if you are developing the cdmlib at the same time. This profile, named <<<local-repository>>>, causes maven to always use the local maven repository, so the latest changes to the cdmlib which have been installed locally by <<<mvn install>>> will be used. In order to use this profile you would execute the validate gloal differently:
+
+ ---
+ $ mvn -P local-repository -Dlocalrepo=/home/${youUserName}/.m2/repository validate
+ ---
+
This will take some time, as maven will download the required dependencies.
After maven has finished follow these steps:
To get rid of the errors, you have to update the classpaths of all plugin projects. To do this right-click any of the <taxeditor-*> projects and choose <PDE Tools -\> Update Classpath...>. Click <Select All> in the dialog and confirm. After a rebuild of your entire workspace all errors should be gone and you are ready to go.
+
+ <<Note>>: If you have also checked out the cdmlib sources you may have to run <<<mvn install>>> on the cdmlib project beforehand to update the cdmlib jars in your local maven repository.
* Bundle overview
** <eu.etaxonomy.taxeditor.test>
- Automated GUI Tests for the Taxonomic Editor that can be run with {{{http://swtbot.com/}SWTBot}}.
+ Automated GUI Tests for the Taxonomic Editor that can be run with {{{http://eclipse.org/swtbot/}SWTBot}}.
* Creating a launch configuration