Introduction

This installation procedure has been tested on a macbook pro with macosx 10.6 64 bits

Details

1. Download the Eclipse Modeling Tools version
• http://www.eclipse.org/downloads/packages/eclipse-modeling-tools/indigosr2
2. Unpack it anywhere and run it
3. Choose a new workspace
• A workspace is a folder in which Eclipse stores all your projects.
4. Install the required plugins. « Help » -> « Install new software »
• In "Work with", choose "Indigo - http://download.eclipse.org/releases/indigo" and install:
• In "Web, XML, Java EE and OSGI Entreprise Development" (uncheck the box "Show only the latest versions of available software")
• Eclipse Web Developer Tools 3.3.1.v201107072200
• Eclipse XML Editors and Tools 3.3.1.v201108102009
• In "Collaboration"
• Subversive SVN JDT Ignore Extensions (Optional) (Incubation) 0.7.9.I20110602-1700
• Subversive SVN Team Provider (Incubation) 0.7.9.I20110819-1700 (this one will ask, once restarted, to download one or more connectors. Choose the latest SVNKit — 1.3.5)
• In "work with", write "http://download.eclipse.org/modeling/tmf/xtext/updates/composite/releases/", click on "Add" and choose a name (e.g. Xtext)
• In "Xtext-2.2.1"
• Xtext SDK 2.2.1.v201112130541
5. Eclipse proposes to restart -> Restart now
6. Add SVN repository exploring perspective
• To activate this perspective, choose Window / Open Perspective / Other... and select "SVN Repository Exploring"
• A popup appears (Discovery of SVN connector)
• Choose: SVN Kit 1.3.5
• Popup Unsigned content -> ok
• Popup -> restart now
7. New > repository location
• https://gama-platform.googlecode.com/svn
• Finish (& wait)
8. Checkout of the GAMA code source
• In the SVN repository view, navigate to the directory "branches/GAMA_CURRENT" and select "Find/Checkout As..." from the contectual menu.
• Choose "Find projects in the children of the selected resource" and follow the indications.
• Pop-up "Check Out projects", all projects should be selected. Finish.
• Once the checkout is finished, switch to Java Perspective.

To compile and run GAMA properly, you will need to configure your Eclipse IDE and the GAMA .product file.

1. By default, Eclipse uses the Java 7 whereas GAMA needs Java 6. We have thus to change the version of the Java compiler.
• Window->Preferences
• In: Java / Compiler: set "Compiler compliance level" to 1.6
• In: Java / Installed JREs -> Add -> Standard VM -> JRE home -> Directory and choose the directory of a Java 6 jre
• Download of the JRE Java 6: http://www.oracle.com/technetwork/java/javase/downloads/jre-6u31-download-1501637.html
• In: Java / Installed JREs -> select the Java 1.6
2. You should configure the GAMA .product file depending on your OS.
• In the msi.gama.application project, open the gama1.4.product file
• In: the "Dependencies" tab: click on "Add Required plug-ins"
• In: the "Launching" tab: check whether the launching options are correct
• In particular, for a 32bits OS, you have to change in "VM Arguments" "-Xmx1536m" into "-Xmx1024m"
• For 64bits OS, check that the option "-d32" is not in the "VM Arguments" (otherwise delete it) in the "macosx" specific tab.
3. Compile and Run GAMA
• Do a "Project -> Clean... (clean all projects)"
• In gama1.4.product file, in "Overview" tab.
• click on the « Synchronize » link. This will ensure your product has updated the inclusion of the plugins (from both Eclipse 3.7 and the new XText). Do not forget to save it.
• click on the « Launch an Eclipse application » link. Note that, a run configuration will be automatically created allowing to only click on the run button for future runs.