GameDevWeek/Eclipse
Es wird empfohlen, Eclipse Luna (oder neuer) in Verbindung mit JDK 8 zu benutzen.
Inhaltsverzeichnis
Erforderliche Einstellungen
UTF-8 Character Encoding
UTF-8 ist bereits im Mavenprojekt als Character Encoding definiert. Da Eclipse jedoch Maven nicht von Haus aus unterstützt empfiehlt es sich die Einstellung global vorzunehmen:
- Optionen öffnen
- General->Workspace wählen
- In "Text file encoding", "UTF-8" wählen
Tab vs. Whitespace
Es wurde sich darauf geeinigt, statt Tabulatoren vier Leerzeichen zu nutzen. Dies wird wie folgt erreicht:
- Optionen öffnen
- General->Editors->Text Editors wählen
- "Displayed tab width" auf 4 setzen
- Den Haken für "Insert spaces for tabs" setzen
Save Actions
Es wird darum gebeten keine 'Save Actions' zu benutzen.
- Optionen öffnen
- Java->Editor->Save Actions wählen
- Den Haken bei 'Perform the selected actions on save' entfernen. (Falls gesetzt)
(Wer Line-Wrapping will kann Line-Wrapping/Word-Wrapping aktivieren - verfügbar über Plugins)
Zusätzlich muss gegebenenfalls das Java Code Profil bearbeitet werden. Dies wird wie folgt erreicht:
- Optionen Öffnen (Window -> Preferences)
- Java -> Code Style -> Formatter
- Aktives Profil bearbeiten (Active Profile -> Edit...)
- Indentation (1. Reiter) Tab policity: Spaces only
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")
- Dort kann die Option "Package Presentation->Hierarchical" gewählt werden.
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")
- Dort die Option "Select Working Set..." wählen
- 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 ist zu 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 der Projekte
- 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"
- Hierbei ist jedoch die Build-Reihenfolge zu beachten.
Weitere wichtige Informationen zu unseren Maven Builds sind hier zu finden.