Merge pull request #142 from software-challenge/intellij-tutorial

Intellij tutorial

Author: SturmEnte

hyperbook/book/entwicklung/java/Anleitung-Abgabe.md

@@ -1,6 +1,6 @@
 ---
 name: Spieler für Abgabe Exportieren
-index: 9
+index: 8
 ---
 
 # Computerspieler abgabefertig machen (Anleitung für Export aus der IDE für Java)

hyperbook/book/entwicklung/java/bedienung-von-eclipse.md

@@ -1,6 +1,6 @@
 ---
 name: Bedienung von Eclipse
-index: 7
+index: 6
 ---
 
 # Bedienung von Eclipse

hyperbook/book/entwicklung/java/bedienung-von-intellij.md

@@ -0,0 +1,114 @@
+---
+name: Bedienung von IntelliJ
+index: 5
+---
+
+# Bedienung von IntelliJ
+
+Wenn man bisher noch nicht mit einer Entwicklungsumgebung gearbeitet hat,
+mag der Anblick erschreckend unübersichtlich sein.
+Sobald man sich jedoch etwas intensiver damit beschäftigt hat,
+möchte man den Bedienkomfort eines solchen Entwicklertools gar nicht mehr missen.
+
+Dieser Artikel stellt die wichtigsten Komponenten der Entwicklungsumgebung IntelliJ vor. 
+
+IntelliJ ist im Vergleich zu Eclipse die modernere IDE mit mehr Features,
+weshalb wir diese für neu Beginnende empfehlen würden. 
+
+## Die Oberfläche
+
+![Überblick über die wichtigsten Fenster in
+IntelliJ](/images/java/intellij_important.png)
+
+### Project Tool Window
+
+Das Project Tool Window befindet sich standartgemäß am linken Rand.
+In ihm sieht man die Ordnerstruktur und alle im Projekt enthaltenen Dateien.
+Wenn man eine Datei doppelklickt,
+wird diese Datei im Editor geöffnet.
+Mit einem Rechtsklick auf eine Datei oder ein Verzeichnis bekommt man viele Optionen,
+mit denen sich das ausgewählte Objekt bearbeiten lässt.
+
+### Editor
+
+Der Editor ist die große Fläche in der Mitte des IntelliJ-Fensters.
+Am oberen Rand befindet sich die Tab-Leiste, die alle geöffneten Dateien beinhaltet.
+
+### Problems
+
+Das Problems Fenster ist standardgemäß nicht auf.
+Um es zu öffnen,
+muss man unten links in der Tool Window Bar den Knopf dafür (Kreis mit ! in der Mitte) drücken.
+Hier werden sowohl Programmierfehler als auch  Warnungen angezeigt.
+
+Mit einem Doppelklick auf einen Eintrag springt der Cursor im Editor an die entsprechende Codezeile die den Fehler oder die Warnung enthält.
+
+### Console
+
+Die Console ist nicht sofort sichtbar, sondern erscheint erst,
+nachdem das erste Programm ausgeführt worden ist.
+Alternativ kann man die Console auch unten links in der Tool Window Bar öffnen.
+
+In der Console werden alle Systemausgaben angezeigt.
+Falls ein Fehler (Exception) geworfen wird,
+kann man durch einen Klick auf den blauen unterstrichenen Teil der Fehlermeldung an die entsprechende Zeile im Programmcode gelangen.
+
+### Gradle Tool Window
+
+Das Gradle Tool Window kann geöffnet werden, 
+durch einen Klick auf das Elefantensymbol am rechten Rand.
+In ihm finden sich Informationen zu dem Gradle Projekt und außerdem unter dem Reiter "Tasks" verschiedene Gradle Befehle.
+Mit einem Doppelklick auf einen Befehl oder mit Rechtsklick und dann Linksklick auf "Run" kann ein Befehl ausgeführt werden.
+Hier sind einige wichtige Funktionen:
+- Unter "build" befindet sich der build-Befehl, mit dem man aus dem Projekt eine Jar erstellen kann,
+  die dann im Contest System hochgeladen werden kann.
+- Unter "application" befindet sich der run Befehl,
+  welcher eine weitere Möglichkeit ist um den Spieler zu starten.
+
+## Programme starten
+
+1. Um eine Start-Konfiguration zum Starten der Spielervorlage zu erstellen,
+   musst man zuerst im Run/Debug Widget auf die aktuelle Buildeinstellung klicken (standard "Current File")
+   und in dem Dropdown Menü, welches sich dann öffnet, auf "Edit Configurations" klicken.
+
+![intellij run configurations](/images/java/build1.png)
+
+2. Wenn noch keine Start-Konfiguration existiert,
+   kann man sie entweder durch klicken auf das "+" oben links
+   oder durch klicken auf "Add new ..." im sich öffnenden Fenster erstellen.
+
+   Im sich öffnenden Fenster müssen folgende Einstellungen vorgenommen werden, 
+   um die Software-Challenge GUI aus IntelliJ heraus starten zu können.
+
+    1. Das Build Tool muss auf Gradle gestellt werden.
+    2. Im nächsten Fenster musst überprüft werden, ob das Projekt richtig "eingelesen" wurde.
+    3. Unter der Überschrift "Run" muss "run" ins Eingabefeld geschrieben werden.
+    4. "Apply" oder "Ok" speichert die Eingaben.
+
+![intellij run configurations](/images/java/build2.png)
+
+3. Danach ist im Run/Debug Widget die neu erstellte Konfiguration ausgewählt
+   und du kannst den Spieler durch klicken auf das Startsymbol (grünes Dreieck) starten.
+
+![intellij run configurations](/images/java/build3.png)
+
+## Tastaturkürzel
+
+IntelliJ IDEA bietet ebenfalls zahlreiche Tastenkombinationen,
+mit denen sich Funktionen schneller aufrufen lassen.
+Die wichtigsten Shortcuts sind in der folgenden Tabelle aufgeführt:
+
+| Aktion | Effekt |
+| ------- | ------- |
+| Shift+F10 | Führt die zuletzt ausgeführte Datei erneut aus |
+| Cursor auf Variablen-, Klassen- oder Methodennamen, dann Shift+F6 | Benennt alle Vorkommen des Namens im ganzen Projekt um |
+| Alt+Enter | Zeigt Verbesserungs- bzw. Reparaturvorschläge an, wenn der Cursor auf einem Fehler oder einer Warnung steht |
+| Ctrl+Alt+I | Rückt den markierten Text sauber ein |
+| Ctrl+/ | Kommentiert die markierten Zeilen ein, bzw. aus |
+| Cursor auf Variablen-, Methoden- oder Klassennamen, dann Ctrl+B | Springt zu der Definition der Variable, Methode oder Klasse |
+| Variablen- oder Klassenname teilweise eingegeben, dann Ctrl+Space | IntelliJ liefert Vorschläge zur Vervollständigung |
+| Eingabe von `sout`, dann Tab oder Enter | Erzeugt `System.out.println` |
+| Eingabe von `fori`, dann Tab oder Enter | Erzeugt die folgende `for`-Schleife: ```for (int i = 0; i < ; i++) {}``` |
+| Eingabe von `ifn`, dann Tab oder Enter | IntelliJ erzeugt eine `if`-Struktur |
+
+**Hinweis:** Unter macOS wird statt der **Strg**-Taste die **Command (⌘)**-Taste verwendet.

hyperbook/book/entwicklung/java/einfuehrung-oop.md

@@ -1,6 +1,6 @@
 ---
 name: Objektorientierte Programmierung
-index: 3
+index: 2
 ---
 
 # Einführung in die objektorientierte Programmierung

hyperbook/book/entwicklung/java/einrichtung-der-entwicklungsumgebung.md

@@ -1,6 +1,6 @@
 ---
 name: Einrichtung der Entwicklungsumgebung
-index: 6
+index: 4
 ---
 
 # Einrichtung der (Java-)Entwicklungsumgebung

hyperbook/book/entwicklung/java/sauberer-programmierstil.md

@@ -1,6 +1,6 @@
 ---
 name: Sauberer Programmierstil
-index: 4
+index: 3
 ---
 
 # Der saubere Programmierstil