Einrichten der Entwicklungsumgebung

Zuerst Eclipse downloaden von www.eclipse.org/downloads. Am einfachsten ist es, hier die “Eclipse IDE for Java Developer” zu nehmen. Die Parrot Engine stellt keine besonderen Anforderungen an die Eclipse-Variante, hauptsache die JDT (Java Development Tools) sind dabei. Das heruntergeladene Eclipse kann dann in einen beliebigen Ordner entpackt werden. Danach empfiehlt es sich auch das JDK6 von java.oracle.com herunterzuladen und zu installieren – dadurch wird es möglich auch in Eclipse Ant-Skripte laufen zu lassen und Programme zu debuggen. Außerdem enthält das JDK eine Menge andere nützliche Tools für Entwickler.

Nach dem Start von Eclipse erscheint zunächst die Frage nach einem Workspace – hier kann ein beliebiger Ordner gewählt werden.

Ist Eclipse schließlich gestartet, sollte im Dialog unter “Windows / Preferences” auf der Seite “Java / Installed JREs” noch das soeben installierte JDK hinzugefügt und als Default ausgewählt werden indem der Haken vor dem JDK gesetzt wird.

Das Complete-Package der Parrot-Engine downloaden und an einem beliebigen Ort speichern.

Unter Eclipse im “Package Explorer” Fenster mit der rechten Maustaste “Import” und in dem sich öffnenden Dialog dann “General / Existing Projects from Workspace” auswählen. Dort dann das heruntergeladene Parrot-Engine Archiv angeben unter “select archive file”. In der Liste der gefundenen Projekte dann die Parrot Engine auswählen und “Finish” klicken.

Die Engine ist nun als Projekt in Eclipse eingerichtet und kann gebaut werden:

Blendet mit “Window / Show View / Ant” die Ant-View ein und fügt dann in der neu erschienenen View mit dem Titel “Ant” mit dem Kontextmenü “Add Buildfiles” das build.xml aus dem ParrotEngine Projekt hinzu.

Klappt den Eintrag “TheParrotEngine” auf und doppelklickt dann auf “all”. Der Build-Prozess startet nun und sollte ohne Fehler beenden.

Nun könnt ihr bereits die Beispiele starten indem ihr das Ziel “run-samples-browser” doppelt anklickt! Das Programm zum Aufrufen der Samples wird dann gestartet.

Eigene Programme mit der Engine schreiben

Erstellt ein neues Java-Projekt und ruft anschließend die Properties des Projekts auf und wechselt dort in das Pane “Java Build Path”. Dort muss das ParrotEngine-Projekt hinzugefügt werden. Dies geschieht in dem Tab “Projects” mit dem Button “Add Jars”. Wählt dann das “TheParrotEngine” Projekt aus. Durch diesen Eintrag bekommt das neue Projekt Zugriff auf die Klassen und Daten der Engine.

Erstellt nun eine neue Klasse “Test” die folgenden Code beinhaltet:

 import de.gaffga.parrotengine.engine.Engine;
 import de.gaffga.parrotengine.engine.EngineException;

public class Test {

public static void main(String[] args) throws EngineException {
 Test test = new Test();
 test.start();
 }

public void start() throws EngineException {
 Engine engine = new Engine();

engine.start();
 }
 }
 

Nun muss noch eine neue Run-Configuration für diese Klasse erstellt werden. Dies geht unter “Run / Run Configurations”; dort ist “Java Application” auszuwählen und dann mit dem Icon “New launch configuration” ein neuer Eintrag zu erstellen. ACHTUNG: Stellt unbedingt sicher, dass unter der Registerkarte “JRE” in der Run-Configuration das JDK 1.6 das ihr oben eingetragen habt eingestellt ist – sonst gibt es Probleme mit der Darstellung von Texturen.

Wenn ihr das Programm startet, erhaltet ihr kurz den Startbildschirm der Engine und anschließend einen schwarzen leeren Screen. Das Programm kann über das Schließen des Fensters oder über die Console mit “^” und anschließend “quit”+Enter beendet werden. Hier gibt es weitere Infos zu den Console-Kommandos.

Ihr habt nun das erste Programm mit der Engine erstellt. Jetzt können weitere Features integriert werden. Schaut euch dazu am besten mal die Beispiele an. Diese befinden sich unter dem Projekt “TheParrotEngine” im Ordner “src” im Paket “de.gaffga.parrotengine.samples”.