GameDevWeek/Eclipse: Unterschied zwischen den Versionen

Aus /dev/null
Wechseln zu: Navigation, Suche
[gesichtete Version][gesichtete Version]
 
(8 dazwischenliegende Versionen von 3 Benutzern werden nicht angezeigt)
Zeile 1: Zeile 1:
−
== Allgemeines ==
+
Es wird empfohlen, Eclipse Luna (oder neuer) in Verbindung mit JDK 8 zu benutzen.  
−
Wir empfehlen mind. Eclipse Luna in Verbindung mit JDK 8 zu benutzen.
 
  
−
== Notwendige Einstellungen ==
+
== Erforderliche Einstellungen ==
 
=== UTF-8 Character Encoding ===  
 
=== 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:
+
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:
  
−
# Öffne die Optionen
+
# Optionen öffnen
−
# Navigiere zu General->Workspace
+
# General->Workspace wählen
−
# In "Text file encoding", wähle "UTF-8"
+
# In "Text file encoding", "UTF-8" wählen
  
−
=== 4 Whitespaces anstelle von Tabs ===  
+
=== Tab vs. Whitespace ===  
 +
Es wurde sich darauf geeinigt, statt Tabulatoren vier Leerzeichen zu nutzen. Dies wird wie folgt erreicht:
  
−
# Öffne die Optionen
+
# Optionen öffnen
−
# Navigiere zu General->Editors->Text Editors
+
# General->Editors->Text Editors wählen
−
# Setze "Displayed tab width" auf 4
+
# "Displayed tab width" auf 4 setzen
−
# Setze den Haken für "Insert spaces for tabs"
+
# 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 ==
 
== Hilfreiches ==
Zeile 22: Zeile 40:
 
Es kann zur Übersichtlichkeit beitragen die Packages in einem Baum darzustellen:
 
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")
 
# Im Package Explorer ist auf der Rechten Seite oben ein Pfeil nach unten ("View Menu")
−
# Wähle dort die Option "Package Presentation->Hierarchical"
+
# Dort kann die Option "Package Presentation->Hierarchical" gewählt werden.
  
 
=== Projekt Gruppen ===
 
=== Projekt Gruppen ===
Zeile 28: Zeile 46:
 
Es ist möglich Projekte zu Gruppen hinzuzufügen und dann komplette Gruppen zu laden:
 
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")
 
# Im Package Explorer ist auf der Rechten Seite oben ein Pfeil nach unten ("View Menu")
−
# Wähle dort die Option "Select Working Set..."
+
# Dort die Option "Select Working Set..." wählen
 
# Hier können nun Gruppen gewählt oder erstellt werden.
 
# Hier können nun Gruppen gewählt oder erstellt werden.
 
# Die Funktionalität dürfte selbsterklärend sein.
 
# Die Funktionalität dürfte selbsterklärend sein.
  
 
== Maven Projekte ==
 
== Maven Projekte ==
−
Eclipse Unterstützt Maven nicht von Haus aus. Dazu ist das Plugin [http://www.eclipse.org/m2e/ M2Eclipse] benötigt. Dies bitte installieren.
+
Eclipse Unterstützt Maven nicht von Haus aus. Dazu ist das Plugin [http://www.eclipse.org/m2e/ M2Eclipse] benötigt. Dies ist zu installieren.
  
 
=== Importieren von Maven Projekten ===
 
=== Importieren von Maven Projekten ===
Zeile 41: Zeile 59:
 
# Maven->Existing Maven Projects wählen.
 
# Maven->Existing Maven Projects wählen.
 
# Next wählen
 
# Next wählen
−
# Den Ordner wählen, wo die CodeBase liegt.
+
# Den Ordner wählen, wo die Codebase liegt.
−
# Es erscheint ein Projekt in der Liste "....parent-pom...".
+
# '''Ab Version 1.8''' erscheinen hier nun alle Projekte in einer Liste.
−
# Dieses auswählen und auf "Finish" klicken.
+
#* Diese alle auswählen und auf "Finish" klicken.
 +
# '''Vor Version 1.8''' erscheint hier nur 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:
+
'''Für Versionen vor 1.8''' muss der Prozess für alle Subprojekte durchgeführt werden. Diese liegen in folgenden Unterordnern:
 
# gdw-commons
 
# gdw-commons
 
# gdw-commons-gdx
 
# gdw-commons-gdx
Zeile 57: Zeile 77:
 
# Maven-> Update Project... wählen.
 
# Maven-> Update Project... wählen.
  
−
=== Bauen ===
+
=== Bauen der Projekte ===
  
 
# Rechte Maustaste auf das Projekt
 
# Rechte Maustaste auf das Projekt
Zeile 65: Zeile 85:
 
# "Run" wählen
 
# "Run" wählen
 
# Nach erfolgreichem Bauen steht in der Konsole "BUILD SUCCESS"
 
# Nach erfolgreichem Bauen steht in der Konsole "BUILD SUCCESS"
 +
# Hierbei ist jedoch die [[GameDevWeek/Maven|Build-Reihenfolge]] zu beachten.
  
−
=== Reihenfolge des Bauens ===
+
Weitere wichtige Informationen zu unseren Maven Builds sind [[GameDevWeek/Maven|hier zu finden]].
−
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.
+
[[Kategorie:GameDevWeek]]

Aktuelle Version vom 3. März 2016, 22:23 Uhr

Es wird empfohlen, Eclipse Luna (oder neuer) in Verbindung mit JDK 8 zu benutzen.

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:

  1. Optionen öffnen
  2. General->Workspace wählen
  3. 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:

  1. Optionen öffnen
  2. General->Editors->Text Editors wählen
  3. "Displayed tab width" auf 4 setzen
  4. Den Haken für "Insert spaces for tabs" setzen

Save Actions

Es wird darum gebeten keine 'Save Actions' zu benutzen.

  1. Optionen öffnen
  2. Java->Editor->Save Actions wählen
  3. 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:

  1. Optionen Öffnen (Window -> Preferences)
  2. Java -> Code Style -> Formatter
  3. Aktives Profil bearbeiten (Active Profile -> Edit...)
  4. Indentation (1. Reiter) Tab policity: Spaces only

Hilfreiches

Package Darstellung ändern

Es kann zur Übersichtlichkeit beitragen die Packages in einem Baum darzustellen:

  1. Im Package Explorer ist auf der Rechten Seite oben ein Pfeil nach unten ("View Menu")
  2. 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:

  1. Im Package Explorer ist auf der Rechten Seite oben ein Pfeil nach unten ("View Menu")
  2. Dort die Option "Select Working Set..." wählen
  3. Hier können nun Gruppen gewählt oder erstellt werden.
  4. 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:

  1. File->Import wählen
  2. Maven->Existing Maven Projects wählen.
  3. Next wählen
  4. Den Ordner wählen, wo die Codebase liegt.
  5. Ab Version 1.8 erscheinen hier nun alle Projekte in einer Liste.
    • Diese alle auswählen und auf "Finish" klicken.
  6. Vor Version 1.8 erscheint hier nur ein Projekt in der Liste "....parent-pom...".
    • Dieses auswählen und auf "Finish" klicken.

Für Versionen vor 1.8 muss der Prozess für alle Subprojekte durchgeführt werden. Diese liegen in folgenden Unterordnern:

  1. gdw-commons
  2. gdw-commons-gdx
  3. gdw-examples
  4. gdx-test
  5. gdx-tools

Updaten von Maven Projekten

Gelegentlich werden Maven Projekte angepasst. In dem Fall muss das Projekt manuell geupdated werden:

  1. Rechte Maustaste auf das Projekt
  2. Maven-> Update Project... wählen.

Bauen der Projekte

  1. Rechte Maustaste auf das Projekt
  2. Run As-> Maven Build... wählen.
  3. Als Goals "install" wählen ("clean install" alternativ zum sauberen Neubauen)
  4. "Apply" wählen
  5. "Run" wählen
  6. Nach erfolgreichem Bauen steht in der Konsole "BUILD SUCCESS"
  7. Hierbei ist jedoch die Build-Reihenfolge zu beachten.

Weitere wichtige Informationen zu unseren Maven Builds sind hier zu finden.

Abgerufen von „https://fsi.hochschule-trier.de/wiki/index.php?title=GameDevWeek/Eclipse&oldid=1086“