.. _installation:

Installation
++++++++++++++

Mit dieser Schritt-für-Schritt Anleitung wird erläutert, wie diese Bibliothek auf Windows zum laufen gebracht werden kann. Dabei ist diese 
Anleitung auch für Programmieranfänger geeignet, da wir mit der Installation von Visual Studio Code beginnen. Erfahre Programmierer können die für sie irrelevante
Schritte gerne überspringen. Nach der Installation empfhielt sich, mit dem :ref:`Quickstart Guide<quickstartguide>` weiter zu machen.

Schritt 1: Installation von VSCode
=====================================
| 1. Gehe auf `code.visualstudio.com <https://code.visualstudio.com/>`_.
| 2. Klicke auf **Download for Windows**.
| 3. Öffne die gedownloadete Datei und folge den Anweisungen dort.

Schritt 2: Installation von Git
==============================================================
| 1. Minimiere Visual Studio Code.
| 2. Drücke die Windows Taste auf der Tastatur oder navigiere direkt zur Windowssuchleiste.
| 3. Gibt **cmd** ein und öffne die **Eingabeaufforderung**.
| 4. Gib **git version** ein um zu testen, ob Git bereits installiert ist. Wird keine Version ausgegeben, ist Git noch nicht installiert.
| 5. Schließe die **Eingabeaufforderung**.
| 6. Gehe auf `gitforwindows.org <https://gitforwindows.org/>`_
| 7. Drücke auf **Download**.
| 8. Öffne die gedownloadete Datei und folge den Anweisungen dort.
| 9. Wiederhole 3. und 4. Nun sollte eine Versionsnummer angezeigt werden.

Schritt 3: Installation von Platform IO
=========================================
| 1. Starte Visual Studio Code.
| 2. In Visual Studio Code, klicke auf **Extensions** am linken Bildschirmrand.
| 3. Klicke auf die Suchleiste und suche nach **PlatformIO IDE**. Das Symbol ist eine weiße Silhouette auf blauen Hintergrund.
| 4. Klicke auf **Install** und warte, bis die Installation abgeschlossen ist.
| 5. Schließe das Fenster von **PlatformIO IDE**. 

Schritt 4: Installation von Github Pull Requests and Issues
==============================================================
| 1. In Visual Studio Code, klicke auf **Extensions** am linken Bildschirmrand.
| 2. Klicke auf die Suchleiste und suche nach **Github Pull Requests and Issues**. Das Symbol sieht aus wie eine orangener Ameisenkopf auf weisem Hintergrund.
| 3. Klicke auf **Install** und warte, bis die Installation abgeschlossen ist.
| 4. Schließe das Fenster von **Github Pull Requests and Issues**. 


Schritt 5: Klone die Library von GitHub
=========================================
| 1. In Visual Studio Code, klicke auf das Zahnrad-Icon **Manage** am unteren linken Bildschirmrand.
| 2. Klicke auf **Command Palette...**.
| 3. Klicke auf die Suchleiste und suche nach **Git: Clone**.
| 4. Kopiere die URL des Github Repositories `https://github.com/Coding-Alexx/TouchMenu <https://github.com/Coding-Alexx/TouchMenu>`_
| 5. Füge die URL in die Suchleiste ein und drücke Enter.
| 6. Wähle einen Speicherort für das Projekt. 
| 7. Klicke nun auf **Add to Workspace**, um das geklonte Repository dem eigenen Projekt hinzuzufügen.


Schritt 6: Start der Programms
=========================================
| 1. Klicke auf den **TouchMenuLib** Ordner, um in aufzuklappen.
| 2. Klicke auf **src**, dann auch **main.cpp**
| 3. Schließe den Microcontroller mit Display an den PC an.
| 4. Am unteren Bildschirmrand, klicke auf **PlatformIO: Upload** (Pfeil nach rechts Symnol).
| 5. Nach Ende des Uploads, wird auf dem Display ein grüner Button angezeigt. Drücke ihn.