Download Eclipse

http://www.eclipse.org/downloads/

• Download Eclipse SDK (so far so good with version 3.4 or greater), the common developers version is not enough, because we'll need to develop Equinox plugin and bundles. (For instance download the Eclipse Modeling Tools)

Install Subclipse

• As usual install the Subclipse plugin using the Eclipse market or following the instructions from the url

http://subclipse.tigris.org/servlets/ProjectProcess?pageID=p4wYuA

Install PDE

• Install PDE software o check it is installed correctly. There are two ways to find out if PDE is installed (Eclipse Plug-in development environment).
  • From Windows -> Preferences: The new option 'Plug-in Development' is active.

After check it out if it's installed and didn't find it then can be installed using the eclipse market.

Equinox Download

http://archive.eclipse.org/equinox/drops/R-3.5-200906111540/index.php#Equinox

• Download the Equinox bundles that we need to run the application from Eclipse:

  org.eclipse.equinox.transforms.hook - Transformer Hook Framework Extension

  org.eclipse.equinox.wireadmin - Wire Admin Service

  org.eclipse.equinox.util - Equinox Util Bundle

  org.eclipse.osgi - OSGi System Bundle

  org.eclipse.osgi.services - OSGi Release 4.0.1 Services

  org.eclipse.osgi.util - OSGi Release 4.0.1 Utility Classes

• Once all are downloaded, copy all to the eclipse plugins folder from the file explorer.

• Restart Eclipse to update the new loaded plug-ins. Maybe need run eclipse -clean from the console to update the OSGI plugins.

Install Maven

http://maven.apache.org/download.html

• Download the latest Maven from your operating system that we need to compile the application from console, follow the installation instructions for your operating system.

Configure gvSIG Mobile SVN

Add the gvSIG Mobile SVN

https://devel.gvsig.org/svn/gvsig-mobile

Can found more information about the project from: https://devel.gvsig.org/redmine/projects/gvsig-mobile

Downloading the workspace from the tag

Simply download all the projects from the tag:

SVN repository: https://devel.gvsig.org/svn/gvsig-mobile
Tag folder: /appGvsigMobile/tags/gvsig_mobile_1_0__22_nov_2012

Downloading the workspace from latest versions

Alternatively, you can download each project from their original URLs to get the latest versions (compilation is not guaranteed in all cases):

Editing our settings.xml file

Developers who have commit permission in the gvSIG Mobile repository should write their user/password settings here in case they need to deploy something.

Other developers need to have this settings file too (the user and password will not be used):

<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<settings xmlns="http://maven.apache.org/POM/4.0.0"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:schemaLocation="http://maven.apache.org/POM/4.0.0
    http://maven.apache.org/xsd/settings-1.0.0.xsd">

 <servers>
     <server>
         <id>gvsig-repository</id>
         <username>[user]</username>
         <password>[password]</password>
         <filePermissions>666</filePermissions>
         <directoryPermissions>777</directoryPermissions>
     </server>
 </servers>

 <!-- optionally you can change the path to your local            -->
 <!-- maven repository. Remember you have to edit the little file -->
 <!-- build/initial_m2/build.xml to point at the same folder      -->
 <localRepository>[path_to_local_maven_repo]</localRepository>

 <!-- This value is changed during the setup of the workspace -->
 <!-- (see instructions)                                      -->
 <offline>true</offline>
 </settings>

Where:

• [user] must be our user account in the gvSIG Mobile project
• [password] must be our password in the gvSIG Mobile project
• [path_to_local_maven_repo] is (optionally) the path to our local maven repository. The default value is [user_home]/.m2/repository (for example "C:\Users\Peter\.m2\repository" in Windows 7 or "/home/Peter/.m2/repository" in Linux)

Install Dependencies

• From Eclipse, right-click on the file build/initial_m2/build.xml and execute it (Run ass/Ant Build). This process will take about 20 seconds and will provide a first version of your local maven repository. Open the file first with the Eclipse text editor to make sure that the target folder is actually your local maven repository.
• Open the file [user_home]/.m2/settings.xml and make sure the offline parameter is false.
• From the system console, go to the workspace build folder and type:

mvn -P cdc install

• Move to the build/projects/gvsig-mobile-init folder and type:

mvn -P cdc clean package eclipse:eclipse -Declipse.pde -Dmaven.test.skip=true install

• Now open the file [user_home]/.m2/settings.xml again and make sure the offline parameter is true.

Compile Projects and Build Eclipse Projects

• In order to compile gvSIG Mobile Core from the System Console, you need to have the mentioned projects downloaded, and then open a system console, go to the workspace folder build/projects/gvsig-mobile-core and type:

mvn -P cdc clean package eclipse:eclipse -Declipse.pde -Dmaven.test.skip=true install

• In order to compile gvSIG Mobile Standard from the System Console, move to the build/projects/gvsig-mobile-standard folder and type:

mvn -P cdc clean package eclipse:eclipse -Declipse.pde -Dmaven.test.skip=true install

• Finally, refresh (F5) and clean the projects within Eclipse.

Problems during the building

If the maven build process finish with 'BUILD SUCCESSFULL' but on Eclipse several compilation errors are shown, sometimes is because the MANIFEST.MF are bad built. Then try to:

• If red cross appears on MANIFEST.MF, maybe it's enough doing CTRL+SHIFT+F (Format the Manifest) and saving it. Eclipse seems to have a bad refresh system.

To prevent maven memory problems during the compilation:

• ERROR: java heap space - java.lang.OutOfMemoryError*

In Windows we have to run from System Console before projects compilation:

• set MAVEN_OPTS=-Xmx1024m