Alle Beiträge
12. Nov. 2026·engineering·7 Min Lesezeit

Angular 14 auf 20: Was bei der Migration eines langlebigen Frontends wirklich zählt

Sechs Major-Versionen am Stück. Eine praktische Checkliste für Teams, die eine Angular-14-Anwendung auf Angular 20 bringen: Toolchain, Angular Material, Standalone, Control Flow, Build-System und Tests.

AngularMigrationTypeScriptFrontend-ArchitekturBarrierefreiheit

Von 2023 bis 2026 war ich Architekt mehrerer Angular-Frontends auf ZHservices, der Behördenplattform des Kantons Zürich. Ein Teil dieser Arbeit war die Migration von Angular 14 auf Angular 20. In diesem Beitrag geht es nicht um den Kunden. Es ist die Checkliste, die ich jedem Team geben würde, das eine Angular-14-Anwendung in Produktion hat und auf den aktuellen Stand kommen muss.

1. Eine Major-Version pro Schritt

ng update unterstützt eine Major-Version pro Schritt. Von 14 auf 20 sind das sechs Schritte: 15, 16, 17, 18, 19, 20. Jeder Schritt bringt eigene Migrations-Schematics mit, und die funktionieren nur in dieser Reihenfolge.

Jeden Schritt auf einem eigenen Branch machen, bauen, testen und mergen. Sechs kleine, langweilige Upgrades sind viel sicherer als ein grosses.

2. Zuerst die Toolchain planen

Meistens bleibt das Upgrade an Node.js und TypeScript hängen, nicht an Angular. Laut der offiziellen Kompatibilitätstabelle:

AngularNode.jsTypeScript
1414.15+ oder 16.10+4.6 bis 4.8
1616.14+ oder 18.10+4.9.3 bis 5.1
1718.13+ oder 20.9+5.2 bis 5.4
2020.19+, 22.12+ oder 24ab 5.8

Angular 19 ist die letzte Version, die auf Node 18 läuft. CI-Agents, Build-Images und alle Entwicklerrechner vorher prüfen, sonst scheitert Schritt 6 an der Infrastruktur und nicht am Code.

3. Angular Material: Die eigentliche Arbeit steckt in v15

Wer Angular Material nutzt, hat mit Version 15 den teuren Schritt. Die Komponenten wurden auf die MDC-basierte Umsetzung umgestellt, die alten gab es nur noch als veraltete legacy-Varianten, und die wurden in Version 17 entfernt.

Die MDC-Komponenten haben eine andere DOM-Struktur, andere Abstände und andere Styles. Eigenes CSS, das interne Material-Klassen anspricht, bricht. Für jede Maske Zeit für eine visuelle Prüfung einplanen, nicht nur für einen grünen Build.

4. Nach Material die Barrierefreiheit erneut prüfen

Auf ZHservices gehörte die WCAG-2.1-Zertifizierung zum selben Projekt. Deshalb behandle ich jede Material-Änderung auch als Änderung der Barrierefreiheit: Fokusreihenfolge, Labels, Kontraste und Screenreader-Ausgabe können sich mit dem neuen DOM verschieben. Automatische Prüfungen laufen lassen und die wichtigsten Abläufe nach dem Material-Schritt mit Tastatur und Screenreader testen, nicht erst am Schluss.

5. Standalone-Komponenten und der neue Control Flow

Zwei Migrationen verändern, wie der Code aussieht, und für beide gibt es Schematics:

  • Standalone-Komponenten sind seit Angular 15 stabil und seit Angular 17 der Standard für neue Projekte. ng generate @angular/core:standalone migriert bestehende Module schrittweise.
  • Eingebauter Control Flow (@if, @for, @switch) kam mit Angular 17. ng generate @angular/core:control-flow stellt die Templates um. In Angular 20 sind *ngIf, *ngFor und *ngSwitch offiziell veraltet und sollen in einer späteren Major-Version entfernt werden.

Beides muss nicht während des Versionssprungs passieren. Ich empfehle, zuerst die Versionen fertig zu migrieren und diese Umstellungen danach als eigene, gut prüfbare Änderungen zu machen.

6. Build-System

Mit Angular 17 wurde der esbuild-basierte Application Builder zum Standard für neue Projekte. Bestehende Projekte können umsteigen, und das Update auf Angular 20 bietet den Wechsel auf @angular/build an. Schnellere Builds sind schön, aber vorher eigene Webpack-Konfiguration, Umgebungsdateien und Asset-Pfade prüfen.

7. Entfernte APIs

In Angular 20 sind einige alte APIs weg, darunter TestBed.get() (veraltet seit Version 9) und das Enum InjectFlags. ng update migriert das meiste automatisch. Trotzdem im Code nach Stellen suchen, die die Schematics nicht sehen, zum Beispiel dynamische Aufrufe oder geteilte Bibliotheken ausserhalb des Workspaces.

8. Tests machen es sicher

Ein solches Upgrade ist nur so sicher wie die Tests dahinter. Unit-Tests (zum Beispiel mit Jest) finden gebrochene APIs, End-to-End-Tests (zum Beispiel mit Cypress) finden gebrochene Abläufe, und eine CI-Pipeline lässt beides bei jedem Schritt laufen. Sind die Tests dünn, zuerst Tests für die kritischen Abläufe schreiben. Diese Zeit zahlt sich schon bei der ersten Major-Version aus.

Zusammenfassung

  • Sechs Schritte, einer pro Major-Version, jeder für sich gemergt.
  • Zuerst Node und TypeScript.
  • Angular Material 15 ist der grosse Brocken: Zeit für visuelle Prüfung und Barrierefreiheit einplanen.
  • Standalone und Control Flow nach dem Upgrade, als eigene Änderungen.
  • Tests und CI entscheiden, wie ruhig die Migration abläuft.

Hängt bei deiner Agentur oder deinem Softwarehaus eine Angular-Anwendung auf einer alten Version fest? Solche Migrationen übernehme ich vollständig remote. Kontakt über mazzotta.dev.

Von Roberto Mazzotta · 12. Nov. 2026

Ähnlicher Build vor dir?