Tested on MacOS X (10.13)
Important note: the current Git version is not compatible with the GAMA 1.6.1 release: if you plan to create plugins for this release, please download the source at revision r11988 (on Google Code) and Eclipse following this procedure. It is neither compatible with the GAMA 1.7RC2 release: if you plan to create plugins for this release, please download the source on the branch mars on the GitHub and install Eclipse Mars SR2.
Download the “Eclipse Oxygen 3A IDE for Java and DSL Developers” version. This is the latest version under which GAMA is certified to work. Regarding Java, we strongly recommend to install the Java Oracle 1.8 JDK that can be downloaded here.
Unpack it and launch it. Please refer to this link for more information on running Eclipse.
One important step required for GAMA to correctly produce its supporting files once it will have been installed is to set the default encoding of the workspace to UTF-8. It can be done by selecting, in the Preferences, “General”, then “Workspace”, then “Text file encoding” and choosing “UTF-8” in the drop-down menu available in “Other:”.
If you install another version of Eclipse, please keep in mind that GAMA is compatible only, for the moment, with XText 2.14.0 (see here to obtain it).
The Xtext plugin provided with the Eclipse release should be updated to XText 2.14.
Work withtext field:
Show only the latest versions of available software
Xtext Complete SDK 2.14.xxx* Next
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.
This can take a while…
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.
Projects from Git,
Project from Gitwindow, select
Existing local repository.,
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).
ummisco.gama.productplugin, open the
gama.productis used to produce the release).
For those who want learn more about Git and Egit, please consult the following tutorials/papers