wiki:Eclipse_Settings
Last modified 20 months ago

Pre requisites

Software install

  • Download and install a  JDK, ver 1.5 min
  • Download and install subversion client (svn command line)
  • Download and install  Maven, ver 2.0.9 min
  • Download and launch  Eclipse RCP 3.4

eclipse plugins

I also install and use the following eclipse plugins :

Name Update URL Description
 subclipse  http://subclipse.tigris.org/update_1.6.x Manage Subversion Repositories
 findbugs  http://findbugs.cs.umd.edu/eclipse find potential vulnerabilities in the source
 Mylyn base  http://download.eclipse.org/tools/mylyn/update/e3.4/ Task and application lifecycle management (ALM) framework for Eclipse
Mylyn Extra (Trac Connector)  http://download.eclipse.org/tools/mylyn/update/extras/ Trac plugin to manage tickets directly in eclipse
 eclipse NSIS  http://eclipsensis.sourceforge.net/update/ Create NSIS installer scripts


Download latest project sources

  • use subversion command line client 
    svn co http://svn.eparapher.com/trunk eparapher
cd eparapher
  • use eclipse and subclipse

TODO

Prepare eclipse workspace

  • Download library, sources and javadocs, compile create eclipse project's files : 
    mvn install studio:eclipse
  • Generate M2_REPO eclipse variable : 
    mvn -Declipse.workspace=. eclipse:add-maven-repo
  • Launch eclipse : 
    eclipse -clean -data .
  • Import eParapher projects :
    Add them through the import menu, add existing project to workspace

Launch eParapher in eclipse

There is two ways :

  1. Quick : Run or Debug eParapher as an eclipse plugin :
    Select Run/Debug? -> Open Run/Debug? Dialog..., select eParapher Runtime and press the Run button.
  1. Run or Debug eParapher as an eclipse product :
    Right click on org.eparapher.client.rcp/eParapher.product File.
    Select Run/Debug? as, Run/Debug? configuration.
    In this new Window :
    • In Main tab, Program to run, select Run an application and eParapher.application.
    • In Arguments tab, under VM arguments, enter -Xms128m -Xmx512m -Dlog4j.appenders=console -Dlog4j.level=DEBUG.
    • In plugin tab, select Workspace, unselect Target Platform and click on Add Required Plug-ins

Et voila! You are now ready to run/debug eParapher!

Working with Mylyn

Mylyn help developers to work with project's task directly in eclipse IDE.

You can add a task repository in the task repositories view with the following settings :

  • Server : http://trac.eparapher.com/.
  • Label : eParapher.
  • Disable anonymous access and enter your trac user id / password.
  • Additional settings -> Access type, select XML-RPC.

Click validate settings to check the settings and credentials, and then click on finish if it's OK.

Working on eParapher

  • if you modify code in the core module, then you must run this in order to use your modification in the rcp module : 
    cd org.eparapher.core/ && mvn clean install && cd ../org.eparapher.client.jars/ && mvn clean studio:clean studio:eclipse install && cd ..
  • To build the project with maven directly in eclipse, simply add the following external tool program :
    • Location : maven2 install directory (e.g. : /usr/bin/mvn if Maven2 is installed with your Linux distribution)
    • Working directory : ${workspace_loc:/}
    • Arguments :
      • install for a normal build;
      • -Dfastbuild install for a fast build;
      • -Puserguides install for a build with html and pdf documentation;
      • -Pwin32,macosx,linux-x86,linux-x86_64,linux-ppc install for a complete build for all available platform.
  • If you want to contribute to the code, please follow the project's Coding Rules

Developer Resources/Documentation?

Maven

Official Maven  site, including :

French tutorials :

eclipse RCP

Spring Framework

Apache directory studio developpers resources

Then follow  Apache directory studio developpers resources. eParapher is using it's maven-eclipse integration, as a project management tool with eclipse RCP tools.