added service to get all taxon nodes
[cdmlib.git] / INSTALL.TXT
index f2e67c3e045682a59ba57665aae2e9689b2c72a2..4e0ed0db3ba8f1d195fd423f5e9a22986499d1f1 100644 (file)
@@ -1,18 +1,31 @@
 EDIT\r
 CDMLIB - PROJECT\r
 \r
+see also http://dev.e-taxonomy.eu/trac/wiki/CdmLibrary#Eclipsesetup\r
+\r
 INSTALL WORKSPACE\r
 =====================================\r
-0) * install maven 2.0.x commandline tools locally (http://maven.apache.org/download.html)\r
-   * make sure Java JDK is installed (JRE is not enough)\r
+0) * install maven 2.0.x commandline tools locally (http://maven.apache.org/download.html). Follow the instruction to install maven on your local machine.\r
+   * install subclipse 1.4.x in eclipse if not yet installed (Update Site: http://subclipse.tigris.org/update_1.4.x). \r
+   * make sure Java JDK >= 1.5 is installed (JRE is not enough) and JAVA_HOME is set to JDK path \r
 \r
 1) Checkout (from outside eclipse) http://dev.e-taxononomy.eu/svn/trunk/cdmLib into a new folder (newFolder).\r
 2) Open newFolder as a new workspace in eclipse (switch to the new workspace by File - Switch Workspace - Other ...)\r
-3) Set in Eclipse preferences (not project properties) java - buildPath - Classpath Variables M2_REPO , pointing to your local repository. \r
+3) make sure maven has run at least one time (to create the .m2 folder). If unsure how to do this, run "mvn install" in the new checked out folder ../cdmlib/cmlib-commons\r
+4) Set in Eclipse preferences (not project properties) java - buildPath - Classpath Variables M2_REPO , pointing to your local repository. \r
       - In OSX for example    /Users/USERNAME/.m2/repository \r
       - In WinXP for example  C:\Documents and Settings\USERNAME\.m2\repository\r
-3 Alternative) use mvn -Declipse.workspace=<path-to-eclipse-workspace> eclipse:add-maven-repo \r
-4) make each subfolder an eclipse project (new - project - from existing source ...\r
-5) run "mvn eclipse:eclipse" in the parent folder (cdmlib) from command line (e.g. $/eclipse/cdmlib>mvn eclipse:eclipse)\r
+4 Alternative) use mvn -Declipse.workspace=<path-to-eclipse-workspace> eclipse:add-maven-repo \r
+5) setup new eclipse workspace (where ever you want but using the cdmlib folder may be comfortable)\r
+6) create new Java project within the new workspace. Check "Create project from existing source" in the dialog. Choose ../cdmlib/cdmlib-commons as the source directory. Use project name "cdmlib-commons".\r
+7) repeat the last step at least for all projects starting with "cdmlib-"\r
+8) Install AspectJ Development Tools (AJDT) - Plugin (for eclipse) \r
+       (Update-Site:http://download.eclipse.org/tools/ajdt/33/dev/update)\r
+  \r
+9) run "mvn install" and  "mvn eclipse:eclipse" in the parent folder (cdmlib) from command line (e.g. $/eclipse/cdmlib>mvn eclipse:eclipse)\r
+10) Convert the cdmlib-model to AspectJ (right mouse click on project -> AspectJ Tools -> ...).\r
+\r
+!! Each time when running mvn eclipse:eclipse on cdmlib-model (or on cdmlib parent folder) you have to first remove and then add AspectJ anew!! \r
 \r
+!!Run mvn eclipse:eclipse each time you change a .pom file\r
 \r