Skip to main content
Version: 1.8.1

Installing the GIT version

Tested on MacOS X (10.14.4) and Ubuntu 18.04.3 LTS

Important note: the current Git version is not compatible with the GAMA 1.6.1 release and neither with the GAMA 1.7RC2 release.

Install Eclipse 2019-03

Download the "Installer of 2019-03" and choose to install the Eclipse DSL TOOLS version. This is the latest version under which GAMA is certified to work. Alternatively, you can directly download the "Eclipse IDE for Java and DSL developers" package. Regarding Java, we strongly recommend to install the Java Oracle 1.8 JDK that can be downloaded here.

Install GAMA source code

The source is to be downloaded from GitHub in two steps: by creating a local clone of the GitHub repository and then importing the different projects that constitute GAMA into the Eclipse workspace.

  1. Open the Git perspective:
  • Windows > Perspective > Open Perspective > Other...
  • Choose Git Open GIT perspective
  1. Click on "Clone a Git repository" Clone Repository
  • In Source Git repository window:
    • Fill in the URI label with: https://github.com/gama-platform/gama.git
    • Other fields will be automatically filled in. Source GIT repository
  • In Branch Selection windows,
    • check the master branch
    • Next

Git branch selection

  • In Local Destination windows,
    • Choose a Directory (where the source files will be downloaded).
    • Everything else should be unchecked
    • Finish

Local destination

This can take a while...

Import projects into workspace

You have now to import projects into the workspace (notice that the folders downloaded during the clone will neither be copied nor moved).

Note: contrarily to previous Eclipse versions, import project from the Git perspective does not work properly for GAMA.

  1. In the Java perspective, choose:
  • File / Import...,

Context Working tree

  • In the install window, select Git / Projects from Git,
  • Click on Next,
  • In the Project from Git window, select Existing local repository.,

Context Local Repository

  • Click on Next,
  • In the new window, select your Git repository,
  • Click on Next,
  • In the Select a wizard to used to import projects, check that
    • Import existing Eclipse projects is selected
    • Working Tree is selected

GIT Import projects

  • Click on Next,

  • In the Import project window,

    • Uncheck Search for nested projects
    • Select all the projects Choose Projects to import
  • Finish

  1. Clean project (Project menu > Clean ...)

If you have errors...

If errors continue to show on in the different projects, be sure to correctly set the JDK used in the Eclipse preferences. GAMA is targeting JDK 1.8, and Eclipse will produce errors if it not found in your environment. So, either you set the compatibility to 1.8 by default (in Preferences > Java > Compiler > Compiler Compliance Level) or you change the error produced by Eclipse to a warning only (in Preferences > Java > Compiler > Building > "No strictly compatible JRE for execution environment available).

Run GAMA

  1. In the ummisco.gama.product plugin, open the gama.runtime.product file (gama.product is used to produce the release).
  2. Go to "Overview" tab and click on Synchronize
  3. Click on Launch an Eclipse Application

GIT Tutorials

For those who want learn more about Git and Egit, please consult the following tutorials/papers

  1. EGIT/User Guide http://wiki.eclipse.org/EGit/User_Guide
  2. Git version control with Eclipse (EGIT) - Tutorial http://www.vogella.com/tutorials/EclipseGit/article.html
  3. 10 things I hate about Git http://stevebennett.me/2012/02/24/10-things-i-hate-about-git/
  4. Learn Git and GitHub Tutorial https://www.youtube.com/playlist?list=PL1F56EA413018EEE1