ionic-team / ionic-team/ionic-docs

content: Angular PWA guide is missing the angular.json step for Angular 18+

Offen Anfängerfreundlich
#4,702 0 Kommentare 0 Reaktionen 0 zugewiesene Personen Auf GitHub ansehen
content package: angular
Vorherrschende Sprache
MDX
Sterne
621
Forks
3.2k
Ø Merge
1 T. 2 Std.
Gemergte PRs (30 T.)
86

Beschreibung

### URL

https://ionicframework.com/docs/angular/pwa

### Issue Description

The guide's only setup step is `ng add @angular/pwa`, which was accurate before Angular 18 but is no longer sufficient for a project created with `ionic start`.

Since Angular 18 the pwa schematic writes `manifest.webmanifest` and the icons to `public/` and no longer adds an entry to `angular.json`. The Ionic starter's `angular.json` has no `public` asset glob, so those files are never copied into `www/`. On a host with a SPA rewrite the 404 is served as index.html and the browser reports `Manifest: Line: 1, column: 1, Syntax error`.

The page should tell readers to add the public glob to the `assets` array after running the schematic:

{ "glob": "**/*", "input": "public" }

Note there is deliberately no `output` key, so the files land at the web root and match the `` the schematic injects into index.html.

The `ngsw-config.json` sample on the page is also stale relative to what Angular 18+ generates and worth refreshing at the same time.

Reported in ionic-team/starters#1888, which covers the starter-side fix.

Beitragsleitfaden

Beitragsleitfaden öffnen

Rechercherichtung

Open the Angular PWA guide at https://ionicframework.com/docs/angular/pwa and review the setup instructions, especially the ng add step and the ngsw-config.json sample. Document the angular.json assets entry with { "glob": "**/*", "input": "public" } and refresh the sample for Angular 18+; done means the guide covers the generated public files and web-root manifest behavior.

Vom Indexierungsmodell aus dem Issue-Text verfasst.

Bewertung

Tech-Stack
angular
Bereich
documentation
Issue-Typ
Dokumentation
Schwierigkeit
2/5
Geschätzter Aufwand
Ein halber Tag
Aktivitätsstatus
Aktiv
Klarheit
Größtenteils klar
Anfängerfreundlichkeit
78/100

Neue Issues direkt in Ihr Postfach

Eine kurze Übersicht über anfängerfreundliche GitHub-Issues.