Installation

Everything should work on all platforms but we only give step by step instructions for Ubuntu (and notes for Windows).

I. Setting up your programming environment

This section explains how to configure your programming environment to set up the GOOL system. Some steps are important for the whole system whereas others are only required by a specific input/output language and can be left out, depending on your usage of the GOOL System.

1. General setup

• Sign-up with Github
• Install the Git client from Debian packages: sudo apt-get install git
• Install Java7 from Debian packages: sudo apt-get install openjdk-7-source openjdk-7-source
• Correct Java7 installation: sudo apt-get --reinstall install tzdata-java
• Install Eclipse with Git from Debian packages: sudo apt-get install eclipse-egit

Notes for Windows :

• Install Eclipse from http://www.eclipse.org/downloads/
• Install EGit : In Eclipse, add http://download.eclipse.org/egit/updates into the Help > Install new software dialog box. Then tick Eclipse Git Team Provider and install it.
• Install Java SE Development Kit 7.

2. C# output

• Install C# from Debian packages: sudo apt-get install mono-gmcs
• Install C# IDE: sudo apt-get install monodevelop

Notes for Windows :

• Download the last .NET Framework from the Microsoft website and install it.
• Add the install directory in your Windows Path. For example : C:\Windows\Microsoft.NET\Framework64\v4.0.30319

3. C++ output

• Install C++ from Debian packages: sudo apt-get install g++
• Install C++/Boost libraries from Debian packages: sudo apt-get install libboost-all-dev
• Install C++/Eclipse plug-in: sudo apt-get install eclipse-cdt

Notes for Windows :

• Download MinGW from http://www.mingw.org/ and install it.
• Add the bin folder to your Windows Path. For example : C:\MinGW\bin
• Download boost from http://www.boost.org/ and place the boost folder at the root directory of your Git project. For example : C:\Users\MyUserName\git

4. Objective C output

• Install Objective C from Debian packages: sudo apt-get install gobjc gnustep gnustep-devel

Notes for Windows :

• When installing MinGW (previous step), select the Objective-c compiler to be installed.

5. Android output

You will need to perform these steps in order to compile and run Android tests from your Eclipse IDE (they are optionnal if you don't plan to use the Android output).

• Launch your Eclipse IDE previously installed
• Eclipse > Help > Open perspective > Install New Software... then paste the following URL into the field : https://dl-ssl.google.com/android/eclipse/
• Click on "Developer Tools" and select "Android Development Tools", then accept the terms&conditions and restart Eclipse at the end of the installation.
• Once it's done, a "Configure SDK" window should appear when restarting. Select "Install new SDK" and "Install the latest available version of Android APIs".
• The android SDK should now be installed into your $HOME/android-sdks/ directory. Open a terminal and run the Android SDK manager : ~/android-sdks/tools/android.
• Install API17, API11, and Android SDK Platform-tools (if they're not installed already).
• Edit your .bashrc file in order to add the SDK to your PATH : gedit ~/.bashrc then copy&paste these 2 lines at the end: PATH="$PATH:$HOME/android-sdks/platform-tools"
PATH="$PATH:$HOME/android-sdks/tools"
• Reboot your system to apply the modifications

II. Importing the project into the Eclipse IDE

• Eclipse > Window > Open perspective > Java
• Eclipse > Import project > Project from Git > Clone, URI: https://github.com/librecoop/GOOL.git (or that of your clone of this repository) and Import existing project.
• Eclipse > GOOL > src > Build path > Use as source
• Eclipse > GOOL > Build path > Configure Build Path... > Add Library > JRE System: /usr/lib/jvm/java-7-openjdk-xxxx
• Eclipse > GOOL > Build path > Configure Build Path... > Add ext. JARs: /usr/lib/jvm/java-7-openjdk-xxxx/lib/tools.jar (in order to have access to Sun's java compiler)
• Eclipse > GOOL > lib, Select all > Build path > Add to build path (in order to have access velocity, string manipulation libraries, logging libraries and JUnit 4.11)

Notes for Windows :

• The JDK7 directory might be located in C:\Program Files\Java\jdk1.7.0_45
• The tools.jar library is located in the lib folder of the JDK7 directory previously selected.

III. Checking paths to external compilers

• Eclipse > GOOL > src > gool.properties.example has the typical configuration
• Eclipse > GOOL > src > gool.properties has your configuration. If it does not exist, rename the typical configuration to create it.
• Make sure the content of this file is right, for instance on windows the csharp command is csc.
• Make sure you do not put spurious spaces at the end of lines etc.

IV. Testing the project

• Eclipse > gool.test > Run as... JUnit Test
• By default, the enabled outputs are: Java, C#, C++ and Python.
• You may enabled/disable an output by commenting the platform lines at the top of GoolTest.java.
• This should not cause any Errors, nor red text in the console.