GameDevWeek/Eclipse
Inhaltsverzeichnis
Allgemeines
Wir empfehlen mind. Eclipse Luna in Verbindung mit JDK 8 zu benutzen.
Notwendige Einstellungen
UTF-8 Character Encoding
UTF-8 Encoding wird schon über unser Maven Projekt eingestellt. Da Eclipse jedoch Maven nicht von Haus aus unterstützt empfiehlt es sich global die Einstellung vorzunehmen:
- Öffne die Optionen
- Navigiere zu General->Workspace
- In "Text file encoding", wähle "UTF-8"
Unix-Style Zeilenumbruch (LF)
- Öffne die Optionen
- Navigiere zu General->Workspace
- In "New text file line delimiter", wähle "Unix"
4 Whitespaces anstelle von Tabs
- Öffne die Optionen
- Navigiere zu General->Editors->Text Editors
- Setze "Displayed tab width" auf 4
- Setze den Haken für "Insert spaces for tabs"
Hilfreiches
Package Darstellung ändern
Es kann zur Übersichtlichkeit beitragen die Packages in einem Baum darzustellen:
- Im Package Explorer ist auf der Rechten Seite oben ein Pfeil nach unten ("View Menu")
- Wähle dort die Option "Package Presentation->Hierarchical"
Projekt Gruppen
Man kann mehrere Projekte in der Projektansicht geöffnet haben, man sollte jedoch nur Projekte die zueinander gehören gleichzeitig offen haben. Es ist möglich Projekte zu Gruppen hinzuzufügen und dann komplette Gruppen zu laden:
- Im Package Explorer ist auf der Rechten Seite oben ein Pfeil nach unten ("View Menu")
- Wähle dort die Option "Select Working Set..."
- Hier können nun Gruppen gewählt oder erstellt werden.
- Die Funktionalität dürfte selbsterklärend sein.
Maven Projekte
Eclipse Unterstützt Maven nicht von Haus aus. Dazu ist das Plugin M2Eclipse benötigt. Dies bitte installieren.
Importieren von Maven Projekten
Zum Importieren wie folgt vorgehen:
- File->Import wählen
- Maven->Existing Maven Projects wählen.
- Next wählen
- Den Ordner wählen, wo die CodeBase liegt.
- Es erscheint ein Projekt in der Liste "....parent-pom...".
- Dieses auswählen und auf "Finish" klicken.
Diesen Prozess nun für alle Subprojekte ausführen. Diese liegen in folgenden Unterordnern:
- gdw-commons
- gdw-commons-gdx
- gdw-examples
- gdx-test
- gdx-tools
Updaten von Maven Projekten
Gelegentlich werden Maven Projekte angepasst. In dem Fall muss das Projekt manuell geupdated werden:
- Rechte Maustaste auf das Projekt
- Maven-> Update Project... wählen.
Bauen
- Rechte Maustaste auf das Projekt
- Run As-> Maven Build... wählen.
- Als Goals "install" wählen ("clean install" alternativ zum sauberen Neubauen)
- "Apply" wählen
- "Run" wählen
- Nach erfolgreichem Bauen steht in der Konsole "BUILD SUCCESS"
Reihenfolge des Bauens
Die Maven Projekte müssen in einer bestimmten Reihenfolge gebaut werden. Stellt vorher sicher, dass ihr mit dem Internet verbunden seid und eure Firewall Maven zulässt.
In dieser Reihenfolge muss gebaut werden:
- GDW-Parent
- GDW-Commons
- GDW-Commons-GDX
Es mag vorkommen, dass während der GDW Änderungen an diesen Projekten gemacht werden. In diesem Fall muss wieder in der Reihenfolge gebaut werden, ab dem Projekt, an dem die Änderung durchgeführt wurde. Also wenn nur GDW-Commons verändert wurde, muss GDW-Parent nicht neu gebaut werden.
Danach können die übrigen Projekte nach belieben gebaut werden:
- GDX-Tools (Partikel und Font Editor)
- GDW-Examples (Einige Beispiele zur CodeBase)
- GDW-Test (Ein Test Projekt)
Nachdem ihr Updates von Git gezogen habt, empfiehlt es sich mindestens das Projekt einmal neu zu bauen.