Importieren eines bestehenden EEA Projekts

Aufsetzen der Entwicklungsumgebung

Anmerkung: In der folgenden Anleitung wird davon ausgegangen, dass Eclipse als IDE verwendet wird. Natürlich können auch andere Entwicklungsumgebungen benutzt werden, allerdings können die Schritte zum Aufsetzen dabei variieren.

Das EEA-Framework basiert auf libGDX, welches das Eclipse-Plugin Gradle verwendet. Gradle kümmert sich darum, dass die von libGDX verwendeten Bibliotheken automatisch heruntergeladen und korrekt importiert werden.

Installation von Gradle

Das Gradle-Plugin für Eclipse kann von folgender Update-Site installiert werden:

• Für Eclipse >= 4.4: http://dist.springsource.com/snapshot/TOOLS/gradle/nightly
• Für Eclipse < 4.4: http://dist.springsource.com/release/TOOLS/gradle

Eine Anleitung für die Installation von Plugins gibt es z.B. hier.

Importieren des Projekts

Import des Gradle-Projekts

Nun kann das bestehende Projekt, welches als .zip-Archiv vorliegen sollte, in Eclipse importiert werden.

Dazu sind folgende Schritte auszuführen:

• Entpacken des .zip-Archivs
• File -> Import -> Gradle -> Gradle Project
• Auswahl des korrekten Ordners, dann Build Model klicken
• Projekte anwählen und mit Finish bestätigen

Struktur eines Projekts

libGDX verwendet eine spezielle Projektstruktur, um verschiedene Teile des Programms voneinander zu trennen. Da es möglich ist für verschiedene Zielplattformen zu entwickeln, wird für jede Plattform ein eigenes Unterprojekt erstellt. Folgende Projekte sollten nach dem Import in Eclipse sichtbar sein (wobei "Projektname" mit dem tatsächlichen Name zu ersetzen ist).

• Projektname: Dies ist das übergeordnete Projekt, das die anderen Unterprojekte enthält.
• Projektname-core: Hier befindet sich der eigentliche Programmcode, der übergreifend auf jeder Plattform genutzt wird.
• Projektname-desktop: Das Desktop-Projekt enthält einen "DesktopLauncher", der das Spiel auf dem Computer ausführt.
• Projektname-test: Hier befinden sich Tests, die in einer eigenenen Umgebung ausgeführt werden müssen und deshalb ihr eigenes Unterprojekt haben.

Einbinden der EEA-Jar

Wenn das Projekt erfolgreich in Eclipse importiert wurde, kann nun die EEA-Bibliothek hinzugefügt werden.
Dazu muss die aktuelle Jar heruntergeladen werden, die auf der Kursseite bereitgestellt wird.

Diese kann dann mit folgenden Schritten eingebunden werden:

• Rechtsklick auf das -core-Projekt im Package Explorer
• Auswahl Build Path -> Configure Build Path
• Add External JARs im Reiter Libraries klicken und die EEA-Jar auswählen
• Zum Schluss im Reiter Order and Export das Häkchen für die Jar setzen

Optional können zusätzlich noch Javadocs hinzugefügt werden. Diese können ebenfalls auf der Kursseite heruntergeladen und dann im gleichen Menü gesetzt werden.

Ausführung

Die Main-Methode zum Ausführen des Projekts befindet sich im -desktop-Projekt (standardmäßig unter dem Namen "DesktopLauncher").
Mit Rechtsklick -> Run As -> Java Application wird das Programm gestartet.

Troubleshooting

Treten bei der Ausführung Fehler auf, weil Assets nicht geladen werden können, liegt das vermutlich daran, dass das Asset-Verzeichnis nicht korrekt verlinkt ist. Dies kann einfach behoben werden, indem ein symbolischer Link von "Projektname-desktop/assets" auf "Projektname-core/assets" erstellt wird.