ionic-team / ionic-team/ionic-docs

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

未关闭 适合新手
#4,702 0 条评论 0 个 reaction 已指派 0 人 在 GitHub 查看
content package: angular
主要语言
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

把新 issue 发到你的邮箱

精选适合新手参与的 GitHub issue 摘要。