GameDevWeek/NetBeans: Unterschied zwischen den Versionen
| [gesichtete Version] | [gesichtete Version] |
| Zeile 1: | Zeile 1: | ||
| − | + | Es wird empfohlen, NetBeans 8 in Verbindung mit JDK 8 zu benutzen. | |
| − | |||
| − | == | + | == erforderliche Einstellungen == |
=== UTF-8 Character Encoding === | === UTF-8 Character Encoding === | ||
UTF-8 Encoding wird schon über unser Maven Projekt eingestellt. | UTF-8 Encoding wird schon über unser Maven Projekt eingestellt. | ||
| − | Sollte es dennoch notwendig sein | + | 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: |
#* -J-Dfile.encoding=UTF-8 | #* -J-Dfile.encoding=UTF-8 | ||
| − | === | + | === Tabulatoren === |
| + | Es wurde sich darauf geeinigt, statt Tabulatoren vier Leerzeichen zu nutzen. Dies wird wie folgt erreicht: | ||
| − | # | + | # Menü ''"Optionen"'' öffnen: ''Tools -> Options'' |
| − | # | + | # Sektion ''"Editor"'', Tab ''"Formatting"'' |
| − | # | + | # Sprache ''"All languages"'' wählen |
| − | # | + | # 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 === | |
| − | === | ||
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" | ||
| − | === | + | === 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 ( | + | # Rechte Maustaste auf die Projektansicht ('''nicht''' auf einen Eintrag im Baum) |
| − | # Im Kontextmenü | + | # 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 |
| − | |||
| − | Alternativ auch über File->Project Groups... zu erreichen. | + | Alternativ auch über ''"File -> Project Groups..."'' zu erreichen. |
=== Hauptprojekt === | === Hauptprojekt === | ||
| − | Wenn | + | 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 | + | Netbeans versteckt diese Funktionalität von Haus aus, sie kann jedoch aktivieren werden: |
| − | # | + | # Menü ''"Run"'' öffnen |
| − | # | + | # Einen Eintrag im Untermenü ''"Set Main Project"'' wählen |
| − | Sobald | + | 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 | + | Sobald per Git ein Klon der CodeBase erstellt wurde, können alle Projekte auf direktem Wege geöffnet werden: |
| − | # File->Open Project wählen | + | # ''"File -> Open Project"'' wählen |
| − | # Zum | + | # Zum Speicherort des Klons navigieren ''(dieser wird durch das Symbol "ma" sichtbar als Maven Projekt gekenntzeichnet)'' |
| − | # | + | # Die Baumstruktur "ausklappen" |
| − | # | + | # Alle "Knoten" die als Mavenprojekt anwählen ''(Strg + Klicken)'' |
| − | === | + | === Kompillieren === |
| − | + | Kompilliert wird NetBeans-typisch: | |
| − | # | + | # Rechtsklick auf das Projekt |
| − | # "Build" oder "Clean and Build" wählen. | + | # ''"Build"'' oder ''"Clean and Build"'' wählen. |
| − | # Nach erfolgreichem | + | # Nach erfolgreichem Kompillieren erscheint in der Konsole ''"BUILD SUCCESS"'' |
| − | === | + | === Kompillierreihenfolge === |
| − | Die | + | Die Mavenprojekte müssen in einer bestimmten Reihenfolge kompilliert werden. Es muss sichergestellt werden dass eine Internetverbindung besteht und die Firewall entsprechen konfiguriert ist. |
| − | + | Kompilliert wird in folgender Reihenfolge: | |
# GDW-Parent | # GDW-Parent | ||
# GDW-Commons | # GDW-Commons | ||
| Zeile 81: | Zeile 79: | ||
* GDW-Test (Ein Test Projekt) | * GDW-Test (Ein Test Projekt) | ||
| − | Nachdem | + | Nachdem per Git ein ''"pull"'' durchgeführt wurde, empfiehlt es sich das Projekt neu zu kompillieren. |
Version vom 5. März 2015, 17:19 Uhr
Es wird empfohlen, NetBeans 8 in Verbindung mit JDK 8 zu benutzen.
Inhaltsverzeichnis
erforderliche Einstellungen
UTF-8 Character Encoding
UTF-8 Encoding wird schon über unser Maven Projekt eingestellt.
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:
- -J-Dfile.encoding=UTF-8
Tabulatoren
Es wurde sich darauf geeinigt, statt Tabulatoren vier Leerzeichen zu nutzen. Dies wird wie folgt erreicht:
- Menü "Optionen" öffnen: Tools -> Options
- Sektion "Editor", Tab "Formatting"
- Sprache "All languages" wählen
- 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
Packagedarstellung ändern
Es kann zur Übersichtlichkeit beitragen die Packages in einem reduziertem Baum darzustellen:
- Rechte Maustaste auf die Projektansicht (*nicht* auf einen Eintrag im Baum)
- 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:
- Rechte Maustaste auf die Projektansicht (nicht auf einen Eintrag im Baum)
- Im Kontextmenü "Project Groups..." wählen
- 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:
- Menü "Run" öffnen
- 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:
- "File -> Open Project" wählen
- Zum Speicherort des Klons navigieren (dieser wird durch das Symbol "ma" sichtbar als Maven Projekt gekenntzeichnet)
- Die Baumstruktur "ausklappen"
- Alle "Knoten" die als Mavenprojekt anwählen (Strg + Klicken)
Kompillieren
Kompilliert wird NetBeans-typisch:
- Rechtsklick auf das Projekt
- "Build" oder "Clean and Build" wählen.
- Nach erfolgreichem Kompillieren erscheint in der Konsole "BUILD SUCCESS"
Kompillierreihenfolge
Die Mavenprojekte müssen in einer bestimmten Reihenfolge kompilliert werden. Es muss sichergestellt werden dass eine Internetverbindung besteht und die Firewall entsprechen konfiguriert ist.
Kompilliert wird in folgender Reihenfolge:
- 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 per Git ein "pull" durchgeführt wurde, empfiehlt es sich das Projekt neu zu kompillieren.
