AMAPstudio

User Tools


Install Eclipse with SVN

It may be tricky to install correctly the SVN plugin and connectors in Eclipse. This is an installation proposal, other options may be chosen.

This was done on Linux Ubuntu 11.04 64 bits edition but it should be ok for other systems.

Note: use the last Eclipse version: e.g. Kepler (24.4.2014). Check that you select the correct SVN version, e.g. SVN 1.8 (24.4.2014)

An Eclipse SVN plugin is mandatory

Eclipse should always be used with a SVN plugin installed, even if the SVN commands are passed from another SVN client (Tortoise under Windows, SmartSVN or the terminal). Otherwise, the refactoring actions (rename, move files) would not be stored and would be forgotten when comitting (commit can be done from every SVN client), resulting in an incomfortable result (renamed or moved files considered missing and re downloaded from the server…).

1. Install Eclipse (download the last version for Java developers)

  • Download Eclipse archive, e.g. from here : http://www.eclipse.org/downloads/ (choose your system and 32 / 64 bits)
  • Unzip it in a local folder, e.g. /home/coligny/Applications/
  • Run it with the given script 'eclipse'

2. Install the svn plugin

  • Eclipse > Help > Install New Sofware > Work with: 'Indigo - http://download.eclipse.org/releases/indigo' (adapt if you installed another version of Eclipse, like Juno or Kepler)
  • Expand the entry 'Collaboration'
  • Select all the entries beginning by 'Subversive' (e.g. 4 entries)
  • Finish installation
  • Restart Eclipse when proposed
  • At start time, you should be proposed the Subversive Connector Discovery

If the Subversive Connector Discovery is not proposed

Window → Preference → Team → SVN click. It should appear
  • Choose the connector you need
    • Prefer the SVNkit (pure java, no need for additive .dll or .so files)
    • Take care of the version, must be compatible with the version of your svn server (e.g. svn 1.8, SVNkit v1.8.x)
    • That's it

If the Subversive SVN Connector Discovery dialog appears at each Eclipse launching

Install the SVN kit connector manually :

  • Help > Install New Software
  • In the Work with section, click on the Add… button
  • Copy the following url in Name and Location :

http://community.polarion.com/projects/subversive/download/eclipse/6.0/update-site/

  • Expand Subversive SVN Connectors
  • Select every entry not containing JavaHL (we do not want JavaHL which is harder to install…)
  • Finish installation (then restart Eclipse)

3. Create your project in Eclipse

Two choices: if you don't have yet a local copy and you'd like to checkout directly with Eclipse, see section 3.1. If you already have a local copy and you want to open it Eclipse, see section 3.2.

3.1. Checkout your project

  • Eclipse > File > New > Project… > SVN > Project from SVN
  • Follow the instructions to set the location of your svn server and your Eclipse project name

Optional: tell Eclipse this is a Java project (fc-24.4.2014)

In some cases, the upper process is not enough to make Eclipse understand that this is a Java project, to be built with Java (the project can not be built: Project > Build project is disabled).

In this case, you may try this way:

  • after a svn checkout through Eclipse or whatever SVN client (e.g. SmartSVN or the command line svn)
  • with a file manager, remove the .project, .classpath and .settings files (if any) from the project directory
  • Eclipse > File > New > Java Project > set the location: the directory of the local copy you obtained with SVN checkout, finish
  • Eclipse > Select your new Java project > Team > Share project SVN > Finish

After this procedure, your project should be recognized by Eclipse as a Java project AND a SVN project.

3.2. Add an existing local copy in Eclipse

If you already have a local copy of Capsis, you may add it as a project in Eclipse:

  • Eclipse > New Project > Java Project from Existing Ant File
  • Ant build file: select the build.xml file in capsis4/
  • Project Name: capsis (use the name of the directory of your local copy to avoid bugs)
  • Select “javac task found in target compile”
  • Check Link to the buildfile in the filesystem

Then, to tell Eclipse the project is under SVN

  • Select your new project: 'capsis' in the Package Explorer
  • Right click > Team > Share Project…
  • SVN > Next
  • Check 'Utiliser un emplacement du référentiel existant' and select the proposed line in the table below, mentioning '…amap-dev.cirad.fr…'
  • Finish
private/installeclipsewithsvn.txt · Last modified: 2017/07/26 15:45 by coligny