mit Ferdinand Malcher

---

Herzlich Willkommen – und schön, dass du dabei bist!
In diesem Repository findest du alle Infos zur Vorbereitung und während des Workshops den Quelltext unserer Beispielanwendung.

🎮 RxJS Playground

Du kannst dir entweder

• den Code als ZIP-Datei herunterladen: rxjs-playground.zip
  oder
  
• dieses Repository per Git herunterladen und in den Ordner rxjs-playground wechseln.

cd rxjs-playground
npm install
ng serve

Öffne den Browser unter der URL http://localhost:4300 (!), um die Anwendung zu sehen. Die Übungen befinden sich im Ordner rxjs-playground/src/app/exercises/.

✅ Vorbereitung

Damit wir gleich durchstarten können, solltest Du ein paar Vorbereitungen treffen.
Die gesamte Installation wird rund 30 Minuten dauern.

1.) Benötigte Software

1. Node.js 14 oder 16 (aktuelle LTS-Version): https://nodejs.org
   • Mac-Nutzer:innen bitte Homebrew verwenden! (siehe Anleitung)
2. Google Chrome: https://www.google.com/chrome/
3. Visual Studio Code: https://code.visualstudio.com
   • Wir empfehlen dir eine Auswahl an Extensions für Visual Studio Code.
     Dazu haben wir ein Extension Pack vorbereitet, das alles Nötige einrichtet:
     Angular-Schule: Extension Pack

2.) Proxy?

Für die Proxykonfiguration im Unternehmensnetz sind gesonderte Einstellungen nötig. Wir haben dir hierfür folgende Anleitung erstellt: https://workshop.angular.schule/proxy
Sollte es Probleme mit dem Proxy geben, melde Dich bitte bei uns, dann finden wir eine Lösung.

3.) Pakete installieren

Die Angular CLI ist das offizielle Build-Tool für Angular. Mit folgendem Befehl kannst Du die CLI auf dem System installieren:

npm install -g @angular/cli

⚠️ Überprüfe bitte anschließend die Versionen, damit wir beim Workshop alle auf dem gleichen Stand sind:

node -v
> Erwartet: v14.x oder v16.x

npm -v
> Erwartet: 6.x oder höher

ng version
> Erwartet: 13.x.x

4.) Startprojekt erzeugen

Bitte lege das Übungsprojekt schon vor Beginn des Workshops an. Die Angular CLI nimmt uns die meisten Schritte schon ab. Was die Parameter im Einzelnen bedeuten, besprechen wir natürlich im Workshop!

⚠️ Bitte erstelle das Projekt nicht auf einem Netzlaufwerk, sondern direkt auf der lokalen Festplatte!

Führe in Deinem Arbeitsverzeichnis die folgenden Befehle aus:

ng new book-rating --routing --style=scss --prefix=br
cd book-rating
ng serve

Die Installation kann bei langsamer Internetverbindung sehr lange dauern. Warte beim Schritt Installing packages (npm) mit Geduld ab!

Auf http://localhost:4200 sollte nun eine Website mit dem Text "book-rating app is running!" erscheinen!

Beende danach den laufenden Webserver mit Strg + C.

5.) Test-Umgebung prüfen

Prüfe bitte, ob der folgende Befehl ohne Fehlermeldungen ausführt:

ng test

Anschließend kannst du den Prozess wieder mit Strg + C beenden.

6.) Styles installieren

Bitte führe diesen Befehl im Projektverzeichnis book-rating aus, um unser Paket mit CSS-Styles zu installieren. Wir werden diese Stylesheets dann im Workshop gemeinsam verwenden.

npm i @angular-schule/workshop-styles

Die Warnungen bei der Installation kannst du ignorieren.

7.) ESLint einrichten

Richte bitte anschließend das Tool ESLint im Projekt ein. Den folgenden Befehl musst du ebenfalls im Projektverzeichnis book-rating ausführen:

ng add @angular-eslint/schematics

Wir freuen uns schon! 🙂

Wenn bei allen Teilnehmenden das Grundgerüst steht, können wir ohne Zeitverlust loslegen. Sollte es zu einer Fehlermeldung kommen, dann sende uns den Fehlertext einfach per Mail an team@angular.schule oder bringe deine Fragen zum Technikcheck mit.

---

© https://angular.schule | Stand: 21.04.2022