Getting Started¶

This guide will give you a short briefing of how to get your development environment up and running within a few minutes.

Basic Setup¶

For the basic setup of your development environment you need to obtain the following tools and programmes:

• The Java Development Kit (JDK) version 6 or higher
• A text editor or an IDE
• Maven
• Git

Since the setup process of the development environment is dependent on the operating system used, you will find the instructions for different systems (Windows, OS X and Linux) below.

Windows¶

1. Download and install the Java Development Kit
   Version 6 of the JDK is sufficient, but we strongly recommend to use the most recent version.
2. Get an editor or an IDE of your choice and install it
   Good IDEs for Java development are NetBeans and Eclipse. If you prefer a pure text editor, Notepad++ is worth trying.
3. Download and install the most recent version of Maven
4. Download Git.
   There are different options available in order to use Git on Windows:
• Git Extensions
  Git Extensions is a graphical user interface for Git, that comes with Windows Explorer integration. It is based on MSysGit. Our recommendation for Windows users.
• TortoiseGit
  TortoiseGit is a port of TortoiseSVN. For those familiar with TortoiseSVN, TortoiseGit is worth trying. It requires MSysGit.
• MSysGit
  Git on the command line.

You are done!

OS X¶

TODO

Linux¶

On Linux you can use your system's package manager to install all required tools and programmes. Below you will find the commands to do so, based on aptitude, a front-end for Debian's Advanced Package Tool (APT).

1. Install OpenJDK
   OpenJDK 6: sudo aptitude install openjdk-6-jdk
   OpenJDK 7: sudo aptitude install openjdk-7-jdk
   If you prefer the Oracle JDK, you have to download and install it manually. You can get from here.
2. Install an editor or an IDE of your choice
   If you want to use a plain text editor, we recommend Emacs: sudo aptitude install emacs
   NetBeans: sudo aptitude install netbeans
   Eclipse: sudo aptitude install eclipse
   Note: If you want to use the most recent version of NetBeans or Eclipse, which is recommended, you should obtain the installer packages from the official websites and perform a manual installation.
3. Install Maven
   sudo aptitude install maven
4. Install Git
   sudo aptitude install git

You are done!

Configuration¶

TODO

Further Reading¶

TODO