GameDevWeek/NetBeans: Unterschied zwischen den Versionen

Aus /dev/null
Wechseln zu: Navigation, Suche
[gesichtete Version][gesichtete Version]
 
(10 dazwischenliegende Versionen von 2 Benutzern werden nicht angezeigt)
Zeile 1: Zeile 1:
== Allgemeines ==
+
Es wird empfohlen, NetBeans 8 (oder neuer) in Verbindung mit JDK 8 zu benutzen.
Wir empfehlen mind. NetBeans 8 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.
+
UTF-8 ist bereits im Mavenprojekt als Character Encoding definiert.
 +
Sollte es dennoch notwendig sein UTF-8 Global zu konfigurieren, so kann dies wie folgt erreicht werden:
  
Sollte es dennoch notwendig sein, UTF-8 Global zu konfigurieren, so kann dies wie folgt erreicht werden:
+
# Öffnen der Datei netbeans.conf ''(zu finden im NetBeans-Verzeichnis unter etc/netbeans.conf)'' mit einem Texteditor.
 
+
# Zur Option ''netbeans_default_options'' hinzufügen:
# Öffne die Datei netbeans.conf (Im NetBeans verzeichnis unter etc/netbeans.conf zu finden.) mit einem Text Editor.
 
# Dort gibt es eine Option netbeans_default_options. Zu dieser sollte hinzugefügt werden:
 
 
#* -J-Dfile.encoding=UTF-8
 
#* -J-Dfile.encoding=UTF-8
  
=== 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 über das Menü die Optionen: Tools->Options
 
# Gehe zur Sektion "Editor" und dort in den Tab "Formatting"
 
# Wähle dort die Sprache "All languages"
 
# Setze den Haken für "Expand Tabs to Spaces"
 
# Setze den Wert für "Number of Spaces per Indent" und "Tab Size" auf 4.
 
# Führe Folgendes für die Sprachen "Java" und "JSON" durch:
 
## Wähle die Sprache aus dem Dropdown
 
## Wähle die Kategorie "Tabs And Indents"
 
## Setze den Haken für "Use All Languages Settings"
 
 
 
=== Unix-Style Zeilenumbruch (LF) ===
 
  
# Öffne über das Menü die Optionen: Tools->Options
+
# Menü ''"Optionen"'' öffnen: ''Tools -> Options''
# Gehe zur Sektion "Editor" und dort in den Tab "Line Endings"
+
# Sektion ''"Editor"'', Tab ''"Formatting"''
# Setze den Haken für "Enable adjusting the line endings"
+
# Sprache ''"All languages"'' wählen
# Wähle aus dem Dropdown die Option "Unix (LF)"
+
# Haken bei ''"Expand Tabs to Spaces"'' setzen
 +
# Wert für ''"Number of Spaces per Indent"'' und ''"Tab Size"'' auf vier setzen.
 +
# Folgendes für die Sprachen "Java" und "JSON" durchführen:
 +
## Sprache im Dropdownmenü auswählen
 +
## Kategorie ''"Tabs And Indents"'' wählen
 +
## Haken bei ''"Use All Languages Settings"'' setzen
  
 
== Hilfreiches ==
 
== Hilfreiches ==
 
+
=== Packagedarstellung ändern ===
=== Package Darstellung ändern ===
 
 
Es kann zur Übersichtlichkeit beitragen die Packages in einem reduziertem Baum darzustellen:
 
Es kann zur Übersichtlichkeit beitragen die Packages in einem reduziertem Baum darzustellen:
 
# Rechte Maustaste auf die Projektansicht (*nicht* auf einen Eintrag im Baum)
 
# Rechte Maustaste auf die Projektansicht (*nicht* auf einen Eintrag im Baum)
 
# Im Kontextmenü wählen "View Java Packages as->Reduced Tree"
 
# Im Kontextmenü wählen "View Java Packages as->Reduced Tree"
  
=== Projekt Gruppen ===
+
=== Projektgruppen ===
 
Man kann mehrere Projekte in der Projektansicht geöffnet haben, man sollte jedoch nur Projekte die zueinander gehören gleichzeitig offen haben.
 
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:
 
Es ist möglich Projekte zu Gruppen hinzuzufügen und dann komplette Gruppen zu laden:
# Rechte Maustaste auf die Projektansicht (*nicht* auf einen Eintrag im Baum)
+
# Rechte Maustaste auf die Projektansicht ('''nicht''' auf einen Eintrag im Baum)
# Im Kontextmenü wählen "Project Groups..." wählen
+
# Im Kontextmenü ''"Project Groups..."'' 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.
 
  
Alternativ auch über File->Project Groups... zu erreichen.
+
Alternativ auch über ''"File -> Project Groups..."'' zu erreichen.
  
 
=== Hauptprojekt ===
 
=== Hauptprojekt ===
Wenn man mehrere Projekte geöffnet hat und den Run Button oder ähnliches benutzt, wird immer das aktuelle Projekt gestartet.
+
Wenn mehrere Projekte geöffnet sind und der ''"Run"''-Button oder Ahnliches verwendet wird, wird immer das aktuelle Projekt gestartet.
Hat man jedoch ein Hauptprojekt und alle anderen sind nur Bibliotheken, so kann es hilfreich sein, das Hauptprojekt als solches zu markieren, so dass dieses favorisiert wird.
+
Existiert jedoch ein Hauptprojekt und alle anderen Projekte sind lediglich Bibliotheken, so kann es hilfreich sein das Hauptprojekt als solches zu markieren, sodass dieses favorisiert wird.
Netbeans versteckt diese Funktionalität von Haus aus. Man kann sie jedoch noch aktivieren:
+
Netbeans versteckt diese Funktionalität von Haus aus, sie kann jedoch aktivieren werden:
# Öffne das Run-Menü
+
# Menü ''"Run"'' öffnen
# Wähle einen Eintrag im Submenü "Set Main Project"
+
# Einen Eintrag im Untermenü ''"Set Main Project"'' wählen
  
Sobald man ein Hauptprojekt gewählt hat, kann man auch über das Kontextmenü eines Projekts diese Einstellung schnell ändern ("Set as Main Project").
+
Sobald Hauptprojekt definiert ist, kann über das Kontextmenü eines Projekts diese Einstellung schnell geändert werden ''("Set as Main Project")''.
  
 
== Maven Projekte ==
 
== Maven Projekte ==
Maven Projekte können direkt über File->Open Project geöffnet werden.
+
Maven Projekte können direkt über ''"File -> Open Project"'' geöffnet werden.
 
 
Sobald ihr Mit Git einen Klon der CodeBase erstellt habt, könnt ihr die Projekte direkt öffnen:
 
# File->Open Project wählen.
 
# Zum Ort navigieren, wo der Klon gespeichert wurde.. dieser dürfte schon als Maven Projekt sichtbar sein durch ein Symbol "ma"
 
# Den Knoten aufklappen, so dass man die Unterknoten sehen kann.
 
# Den Oberknoten und alle Unterknoten, die als Maven Projekt sichtbar sind auswählen (Strg + Klick)
 
 
 
=== Bauen ===
 
Gebaut wird NetBeans typisch:
 
# Rechte Maustaste auf das Projekt
 
# "Build" oder "Clean and Build" wählen.
 
 
 
=== 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:
+
Sobald per Git ein Klon der Codebase erstellt wurde, können alle Projekte auf direktem Wege geöffnet werden:
# GDW-Parent
+
# ''"File -> Open Project"'' wählen
# GDW-Commons
+
# Zum Speicherort des Klons navigieren ''(dieser wird durch das Symbol "ma" sichtbar als Maven Projekt gekenntzeichnet)''
# GDW-Commons-GDX
+
# Die Baumstruktur "ausklappen"
 +
# Alle "Knoten" die als Mavenprojekt anwählen ''(Strg + Klicken)''
  
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.
+
=== Bauen der Projekte ===
Also wenn nur GDW-Commons verändert wurde, muss GDW-Parent nicht neu gebaut werden.
+
Gebaut wird NetBeans-typisch:
 +
# Rechtsklick auf das Projekt
 +
# ''"Build"'' oder ''"Clean and Build"'' wählen.
 +
# Nach erfolgreichem Bauen erscheint in der Konsole ''"BUILD SUCCESS"''
 +
# Hierbei ist jedoch die [[GameDevWeek/Maven|Build-Reihenfolge]] zu beachten.
  
Danach können die übrigen Projekte nach belieben gebaut werden:
+
Weitere wichtige Informationen zu unseren Maven Builds sind [[GameDevWeek/Maven|hier zu finden]].
* 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 8. März 2015, 23:22 Uhr

Es wird empfohlen, NetBeans 8 (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. Sollte es dennoch notwendig sein UTF-8 Global zu konfigurieren, so kann dies wie folgt erreicht werden:

  1. Öffnen der Datei netbeans.conf (zu finden im NetBeans-Verzeichnis unter etc/netbeans.conf) mit einem Texteditor.
  2. Zur Option netbeans_default_options hinzufügen:
    • -J-Dfile.encoding=UTF-8

Tab vs. Whitespace

Es wurde sich darauf geeinigt, statt Tabulatoren vier Leerzeichen zu nutzen. Dies wird wie folgt erreicht:

  1. Menü "Optionen" öffnen: Tools -> Options
  2. Sektion "Editor", Tab "Formatting"
  3. Sprache "All languages" wählen
  4. Haken bei "Expand Tabs to Spaces" setzen
  5. Wert für "Number of Spaces per Indent" und "Tab Size" auf vier setzen.
  6. Folgendes für die Sprachen "Java" und "JSON" durchführen:
    1. Sprache im Dropdownmenü auswählen
    2. Kategorie "Tabs And Indents" wählen
    3. Haken bei "Use All Languages Settings" setzen

Hilfreiches

Packagedarstellung ändern

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

  1. Rechte Maustaste auf die Projektansicht (*nicht* auf einen Eintrag im Baum)
  2. Im Kontextmenü wählen "View Java Packages as->Reduced Tree"

Projektgruppen

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. Rechte Maustaste auf die Projektansicht (nicht auf einen Eintrag im Baum)
  2. Im Kontextmenü "Project Groups..." wählen
  3. Hier können nun Gruppen gewählt oder erstellt werden

Alternativ auch über "File -> Project Groups..." zu erreichen.

Hauptprojekt

Wenn mehrere Projekte geöffnet sind und der "Run"-Button oder Ahnliches verwendet wird, wird immer das aktuelle Projekt gestartet. Existiert jedoch ein Hauptprojekt und alle anderen Projekte sind lediglich Bibliotheken, so kann es hilfreich sein das Hauptprojekt als solches zu markieren, sodass dieses favorisiert wird. Netbeans versteckt diese Funktionalität von Haus aus, sie kann jedoch aktivieren werden:

  1. Menü "Run" öffnen
  2. Einen Eintrag im Untermenü "Set Main Project" wählen

Sobald Hauptprojekt definiert ist, kann über das Kontextmenü eines Projekts diese Einstellung schnell geändert werden ("Set as Main Project").

Maven Projekte

Maven Projekte können direkt über "File -> Open Project" geöffnet werden.

Sobald per Git ein Klon der Codebase erstellt wurde, können alle Projekte auf direktem Wege geöffnet werden:

  1. "File -> Open Project" wählen
  2. Zum Speicherort des Klons navigieren (dieser wird durch das Symbol "ma" sichtbar als Maven Projekt gekenntzeichnet)
  3. Die Baumstruktur "ausklappen"
  4. Alle "Knoten" die als Mavenprojekt anwählen (Strg + Klicken)

Bauen der Projekte

Gebaut wird NetBeans-typisch:

  1. Rechtsklick auf das Projekt
  2. "Build" oder "Clean and Build" wählen.
  3. Nach erfolgreichem Bauen erscheint in der Konsole "BUILD SUCCESS"
  4. Hierbei ist jedoch die Build-Reihenfolge zu beachten.

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