ionic-team / ionic-team/ionic-docs
content: Angular PWA guide is missing the angular.json step for Angular 18+
- 主要语言
- MDX
- 星标
- 621
- 派生
- 3.2k
- 平均合并
- 1 天 2 小时
- 30 天内合并 PR
- 86
描述
### 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.
贡献指南
调研方向
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.
由索引模型根据 Issue 内容生成。
评估
- 技术栈
- angular
- 领域
- documentation
- Issue 类型
- 文档
- 难度
- 2/5
- 预计耗时
- 半天
- 活跃度
- 活跃
- 描述清晰度
- 基本清楚
- 新手友好度
- 78/100