1. Einleitung
Das PDF des Dokuments finden Sie HIER.
Den Code dieses Dokuments finden Sie HIER.
Dieses Dokument ist ein Produkt der KI Claude von Anthropic. Es folgt dem Kurs „Schritt-für-Schritt-Einführung in das Mobile-Framework Flutter“, von dem es Gliederung, Beispiele und Fallstudie übernimmt, sowie dem Kurs „Schritt-für-Schritt-Einführung in das Framework Angular“, von dem es die Werkzeuge übernimmt:
- Im Kurs [Flutter] ist die Anwendung eine mobile App, geschrieben in [Dart], deren Engine – [Flutter] – jedes Pixel selbst darstellt;
- Im Kurs [Angular] ist die Anwendung eine Webanwendung: HTML, CSS und [TypeScript], ausgeführt von einem Browser;
- In diesem Kurs ist die Anwendung BEIDES: eine Webanwendung, geschrieben mit [Angular] und Komponenten des Frameworks [Ionic], die das Werkzeug [Capacitor] zu einer auf dem Smartphone installierten [Android]-Anwendung verpackt. Derselbe Code läuft ohne jede Änderung auch in einem Browser.
Der Server bleibt dagegen unverändert: Es ist der JSON-Server [RdvMedecins] aus den vorherigen Lektionen, geschrieben mit [NestJS]. Und die Bildschirme der App sind jene, die die Leser der anderen Lektionen bereits kennen (Anmeldung mit CAPTCHA, Terminkalender des Arztes, Terminfenster, Patientenportal, Arzt- und Kundenverwaltung, Kontoerstellung, Französisch und Englisch), angepasst an einen Smartphone-Bildschirm.
Das Dokument folgt demselben Aufbau wie seine Vorgänger: zuerst zahlreiche kurze Beispiele, die sich jeweils auf ein Konzept von [Ionic] oder [Angular] konzentrieren, danach eine vollständige Fallstudie, der Client [Ionic] für die Anwendung [RdvMedecins], bei der alle Dateien kommentiert sind. Die 25 Beispiele tragen dieselben Nummern und zeigen dieselben Bildschirme wie die im Kurs [Flutter] (und in den Kursen [React] und [Vue.js] ): Leser, die mit einem dieser Frameworks vertraut sind, erkennen dieselben Beispiele wieder, geschrieben im Stil von [Ionic] und [Angular]. Jedes Beispiel schließt außerdem mit einem Vergleich mit [Flutter] ab.
Es wird vorausgesetzt, dass die Leser mit den Grundlagen der Sprache [TypeScript] und des Frameworks [Angular] vertraut sind: Diese werden in den Kursen „Einführung in die Sprache TypeScript anhand von Beispielen“ und „Schritt-für-Schritt-Einführung in das Framework Angular“ behandelt. Die verwendeten Konzepte von [Angular] (Signals, Templates, Dependency Injection, Router, reaktive Formulare usw.) werden jedoch im Verlauf der Beispiele bei Bedarf wiederholt.
1.1. Die Rolle von Ionic in einer Client-Server-Anwendung
Die Anwendung besteht aus zwei Teilen, die ausschließlich über HTTP-Anfragen miteinander kommunizieren:

- 1: Die Anwendung [Ionic], die auf dem Smartphone läuft, sendet eine HTTP-Anfrage an den Server, zum Beispiel [GET /api/schedule?doctorId=1&day=2026-10-05];
- 2: Der Server antwortet mit JSON-Daten: dem Terminkalender dieses Arztes für diesen Tag. Er erzeugt keine Seiten;
- 3: Anhand dieser Daten aktualisiert [Angular] den Bildschirm des Smartphones.
Dies ist genau die Architektur der Clients [Flutter], [React], [Vue.js] und [Angular]: Der einzige Unterschied besteht darin, was die Anzeige erzeugt. Und in dieser Hinsicht ist [Ionic] das Gegenteil von [Flutter]. [Flutter] ist eine Rendering-Engine: Es verlässt sich nicht auf den Browser und stellt jedes Pixel des Bildschirms selbst dar. [Ionic] hingegen stellt nichts selbst dar: Es ist eine Bibliothek von Web Components: neuen HTML-Elementen – [<ion-button>], [<ion-input>], [<ion-list>], [<ion-tabs>] ... –, die mit dem Werkzeug [Stencil] des [Ionic]-Teams erstellt wurden und die jeder Browser anzeigen kann. Diese Komponenten ahmen die nativen Komponenten des Smartphones in zwei „Modi“ nach: [md] ([Material Design], das Erscheinungsbild von [Android]) und [ios] (das Erscheinungsbild des [iPhone]). Dieser Kurs erzwingt überall den Modus [md], auch im Browser. Da es sich um einfache HTML-Elemente handelt, lassen sich die Komponenten von [Ionic] mit [Angular], [React] oder [Vue.js] verwenden: Dieser Kurs setzt sie mit [Angular] ein (dem Paket [@ionic/angular]).
Die Anwendung ist also eine gewöhnliche Webanwendung: eine HTML-Seite, ein Stylesheet und [JavaScript]-Code, der aus [TypeScript] kompiliert wird. Es ist [Capacitor] (vom selben Team wie [Ionic]), das sie in eine [Android]-Anwendung verwandelt:
- [Capacitor] erzeugt ein natives [Android]-Projekt, dessen einziger Bildschirm eine WebView ist: die Browser-Engine [Chrome] des Smartphones im Vollbildmodus, ohne Adressleiste. Die kompilierte Webanwendung wird in dieses Projekt kopiert, und die WebView lädt sie beim Start. Für den Benutzer verhält sie sich wie jede andere App: ein Symbol, ein Startbildschirm und die Zurück-Taste von [Android];
- der [JavaScript]-Code greift über [Capacitor]-Plugins, die als Brücke zum nativen Code dienen, auf die Funktionen des Smartphones zu (Speicher, Kamera, Benachrichtigungen, Geolokalisierung usw.). Dieser Kurs verwendet zwei davon: [@capacitor/preferences] (ein kleiner Schlüssel-Wert-Speicher auf dem Gerät, Beispiel 20) und [CapacitorHttp] (HTTP-Anfragen, die vom nativen Code von [Android] ausgeführt werden, Beispiele 22 bis 25);
- Derselbe Code läuft in einem Browser, wo die Plugins eine Webversion haben (der Speicher von [Capacitor] nutzt dann den [localStorage] des Browsers). Wir entwickeln also in [Chrome] in Smartphone-Größe mit dessen Entwicklerwerkzeugen und wechseln zum Testen anschließend zu [Android] .
Die drei Schichten der Anwendung und was sie bereitstellen:
- [Angular]: das Anwendungs-Framework. Es stellt die Komponenten (eine [TypeScript]-Klasse und ein HTML-Template), Signals (den Zustand, dessen Änderungen den Bildschirm aktualisieren), Dependency Injection (Services, gemeinsamer Zustand), den Router (eine Adresse pro Bildschirm), Formulare, den HTTP-Client und „Pipes“ (Formatierung) bereit. Leser des Kurses [Flutter] erkennen das Prinzip wieder: Die Oberfläche ist eine Funktion des Zustands. Wir ändern nie den Bildschirm selbst: Wir ändern den Zustand, und [Angular] aktualisiert alles, was davon abhängt;
- [Ionic]: die Oberflächenkomponenten, die denen einer mobilen App ähneln (Symbolleisten, Listen, Felder, schwebende Schaltflächen, Tabs, Warnfenster, Kalender usw.), und die Navigation einer mobilen App: ein Stapel von Seiten, animiert wie unter [Android], von dem die Zurück-Taste die oberste Seite entfernt;
- [Capacitor]: die [Android]-Anwendung und der Zugriff auf das Smartphone.
Anders als bei [Flutter] sind für die Kommunikation mit einem Server keine zusätzlichen Pakete nötig: [Angular] stellt den HTTP-Client, den Router, Formulare und Dependency Injection bereit; [JavaScript] liefert zusammen mit dem Objekt [Intl] die Formatierung von Datums- und Zahlenangaben für jede Sprache; die Bibliothek [RxJS], die in [Angular] enthalten ist, liefert asynchrone Datenströme. Die Übersetzungen (Beispiel 21) übernimmt eine eigens dafür geschriebene kleine Klasse, die die JSON-Wörterbücher liest.
1.2. Verwendete Werkzeuge
Die Beispiele wurden mit den folgenden Werkzeugen geschrieben und getestet (ihre Installation wird im nächsten Kapitel und im Anhang beschrieben):
- [Node.js] 24 und sein Paketmanager [npm]: [Angular CLI] 22 erfordert [Node.js] 22.22.3 (oder eine neuere Version 22), 24.15 oder höher oder 26 und später. [Node.js] betreibt außerdem den JSON-Server;
- [Angular CLI] 22.2 (der Befehl [ng]), [Angular] 22.2 und [TypeScript] 6.0;
- [Ionic] 9.0 (das Paket [@ionic/angular] 9.0.6) und seine Icons, [ionicons] 8.1;
- [Capacitor] 8.5 (die Pakete [@capacitor/core], [@capacitor/android] und [@capacitor/cli]) und sein Plugin [@capacitor/preferences] 8.0;
- der Editor [Visual Studio Code] und seine Erweiterungen [Angular Language Service] und [Ionic];
- [Android Studio] für das SDK [Android], sein JDK und seine Emulator-Verwaltung: ein [Android] -Emulator (ein simuliertes Smartphone auf dem Computer) oder ein echtes [Android]-Smartphone, das an den Computer angeschlossen ist;
- der Browser [Chrome] zum Entwickeln und Debuggen der Anwendung, sowohl auf dem Computer als auch auf dem Smartphone;
- das DBMS [MySQL] (oder [MariaDB]), zum Beispiel das von [Laragon] unter [Windows]: Es wird für den JSON-Server benötigt, wie im Kapitel zu dessen Vorstellung beschrieben;
- das Kommandozeilenwerkzeug [curl], das die rohen HTTP-Antworten anzeigt.
Die verwendeten Pakete sind die aus den Dateien [package.json] der beiden [Ionic]-Projekte, die identisch sind: die [@angular/...] 22.2, [@ionic/angular] 9.0, [ionicons] 8.1, [@capacitor/...] 8.5, [@capacitor/app] 8.1, [@capacitor/preferences] 8.0, [rxjs] 7.8 und, nur für die Entwicklung, [typescript] 6.0, [prettier] 3 (Code-Formatierung) und [playwright] 1.56 (Screenshots).
1.3. Screenshots
Die Screenshots in diesem Dokument wurden automatisch von Programmen erzeugt, die die Bibliothek [Playwright] verwenden (Ordner [captures/] beider [Ionic]-Projekte). Das Programm [captures/captures.mjs] steuert einen [Chromium]-Browser (die freie Version von [Chrome]) in der Größe eines [Android]-Smartphones: 412 x 892 Punkte bei 2,625 Pixeln pro Punkt, was Bilder von 1082 x 2342 Pixeln ergibt. Für jedes Beispiel führt es ein „Szenario“ aus dem Ordner [captures/scenarios/] aus: Es öffnet die Beispielseite, interagiert wie ein Benutzer mit ihr (Text eingeben, Schaltflächen drücken) und speichert dann den Bildschirm als Bilddatei.
Es handelt sich also um echte Screenshots der Anwendung, dargestellt von der Engine [Chrome] – derselben, die auch die WebView des Smartphones verwendet; es fehlen lediglich die Statusleiste des Smartphones (Uhrzeit, Akku) und die Bildschirmtastatur. Der Leser kann sie nachbauen (die App muss laufen; siehe unten):
- Zeile 1: nur einmal: lädt den Browser [Chromium] herunter, den [Playwright] verwendet;
- Zeile 2: erzeugt alle Screenshots im Ordner [captures/images/] neu;
- Zeile 3: erzeugt nur die Screenshots der Beispiele 05 und 17 neu.
Für die Screenshots der Beispiele 22 bis 25 und der Fallstudie muss außerdem der JSON-Server im „Testmodus“ für das CAPTCHA laufen (siehe das Kapitel, das den Server beschreibt).
1.4. Die Beispiele
Der Code in diesem Dokument ist in drei Ordnern organisiert:
Die Beispiele bilden ein einziges Projekt, [Ionic]: eine Startseite, das Beispielmenü und eine Seite pro Beispiel, jeweils in einem eigenen Ordner [src/app/] (Beispiel 01 stellt das Projekt ausführlich vor):
Die Ordner [node_modules/] (die Pakete) und [android/] (das [Android]-Projekt) werden nicht mitgeliefert: Der erste wird von [npm install] befüllt, der zweite von [Capacitor] erzeugt. In einer Konsole, die im Ordner [examples_ionic] geöffnet ist (in [VS Code]: Menü Terminal / Neues Terminal):
- Zeile 1: Einmalig für alle Beispiele: lädt die in [package.json] beschriebenen Pakete in den Ordner [node_modules/] herunter;
- Zeile 2: startet [ng serve], den Entwicklungsserver von [Angular], unter der Adresse [http://localhost:8100].
Öffnen Sie diese Adresse in [Chrome]: Die Startseite listet die 25 Beispiele nach Kapiteln gruppiert auf; ein Tipp auf ein Beispiel öffnet es, und die Zurück-Schaltfläche in seiner Symbolleiste führt Sie zurück zum Menü. Sie können auch direkt über die Adresse zu einem Beispiel gehen: [http://localhost:8100/ex05] zum Beispiel für Beispiel 05. Um die App in Smartphone-Größe anzuzeigen, öffnen Sie die Entwicklerwerkzeuge (F12) und dann die Geräteemulationsleiste (Strg+Umschalt+M). Solange [ng serve] läuft, wird jede Dateiänderung sofort kompiliert und im Browser angewendet; Strg+C beendet den Vorgang.
Unter [Android] wird die Beispielanwendung samt ihren 25 Beispielen und dem Menü in einem Zug installiert:
- Zeile 1: Einmalig ausführen: erstellt den Ordner [android/] und ein vollständiges [Android Studio]-Projekt;
- Zeile 2: kompiliert die Webanwendung in den Ordner [dist/examples_ionic/browser/];
- Zeile 3: kopiert sie in das [Android]-Projekt;
- Zeile 4: baut die [Android]-Anwendung, installiert sie auf einem laufenden Emulator oder einem angeschlossenen Smartphone (der Befehl fragt nach, welches, wenn es mehrere gibt) und startet sie.
Die Zeilen 2 bis 4 müssen nach jeder Codeänderung erneut ausgeführt werden. Beispiel 01 zeigt außerdem, wie Sie das automatische Neuladen von [ng serve] auf dem Smartphone aktivieren.
Die Beispiele 22 bis 25 fragen die JSON- und [RdvMedecins]-Server ab: Sie müssen diese installiert haben und laufen lassen, wie im ihnen gewidmeten Kapitel erläutert. Im Browser leitet der Entwicklungsserver die Anfragen [/api] an sie weiter (Datei [proxy.conf.json]); im Emulator verbinden sie sich mit dem Server unter der Adresse [http://10.0.2.2:8080] (siehe Beispiel 22).
1.5. Inhalt des Dokuments
Kapitel | Inhalt | Beispiele |
Erste Schritte mit Ionic | ein Ionic-Projekt (Angular + Capacitor), Ionic-Komponenten, Zustand (signal, computed, effect), Templates (@if, @for), Ereignisse, alle Feldtypen, ein Reducer, Validierung, reaktive Formulare, Formatierung (Intl, Pipes) | 01 bis 09 |
Komponenten | Eingaben (input), Ausgaben (output, model), Komposition (Inhaltsprojektion, ng-template), Lebenszyklus, Dependency Injection (Services, inject), Direktiven und Animationen, Bestätigungsdialog (AlertController) | 10 bis 16 |
Routing | Router von Angular und ion-router-outlet: Routen, Parameter, Shell mit ion-tabs, Lazy Loading, 404-Seite, Guards | 17 und 18 |
Asynchrone Operationen und gemeinsamer Zustand | Promise, Observable (RxJS), Timer, Entprellung, veraltete Antworten, async-Pipe, toSignal, resource, ein Signal-basierter Service, @capacitor/preferences, dunkles Design | 19 und 20 |
Internationalisierung | Eine App auf Französisch und Englisch | 21 |
Der RdvMedecins-Server, eine Blackbox | Installation des JSON-Servers, seine API, curl-Beispiele | - |
Interaktion mit dem Server | HttpClient, der Entwicklungs-Proxy, die Serveradresse, CapacitorHttp unter Android, das httpOnly-Token-Cookie (gespeichert vom Browser oder von Android), eine Zugriffsschicht auf die API, Serverfehler | 22 bis 25 |
Fallstudie | der Ionic-Client der Anwendung RdvMedecins | - |
Bereitstellung | Der kompilierte Web-Client, bereitgestellt vom JSON-Server; die Android-Anwendung | - |
Jedes Beispiel wird mit seinem vollständigen, Zeile für Zeile kommentierten Code und Screenshots seiner Ausführung vorgestellt. Der Code selbst ist ausführlich kommentiert: Diese Kommentare sind Teil des Kurses.