为什么捐赠
API 浏览器
升级指南
NEW!
quasar.config 配置文件
迁移到 Webpack 版 CLI
浏览器兼容性
TypeScript 支持
目录结构
命令列表
CSS 预处理器
使用 Vue Router 进行页面路由
懒加载 - 代码分割
资源处理
Boot 文件
预取特性
API 代理
配置 Webpack
处理 process.env
使用 Pinia 管理状态
代码检查与格式化
测试与审计
开发移动应用
Ajax 请求
开放开发服务器到公网
联系站长
Quasar CLI with Webpack - @quasar/app-webpack
开发 PWA 的准备工作

我们将利用 Quasar CLI 开发和构建 PWA 网站。构建 SPA、Mobile App、Electron App、PWA 或 SSR 之间的区别仅仅是由 quasar devquasar build 命令中的 mode 参数决定的。

为了开发或构建一个 PWA 网站,我们首先需要将 PWA 模式添加到 Quasar 项目中:

quasar mode add pwa

如果您想直接开始开发,也可以跳过 “quasar mode” 命令,直接使用:

quasar dev -m pwa

这样,如果项目缺少 PWA 模式,则会自动添加后启动。

项目中会新建一个目录(详情请参考配置 PWA 页面):

register-service-worker.js
# (或 .ts)管理 service worker 的 UI 代码
manifest.json
# PWA manifest 文件
custom-service-worker.js
# (或 .ts)可选的自定义 service worker 文件(仅在 injectManifest 模式中)
pwa-end.d.ts
# 仅 TypeScript
tsconfig.json
# 仅 TypeScript

以上所有文件将在后续页面中详细介绍,但主要概述如下:

  • register-service-worker.js 文件是 UI 代码的一部分,用于与 service worker 通信。
  • manifest.json 是 PWA 的 manifest 文件。
  • 当使用 InjectManifest 模式时,您可以编写自定义的 service worker(custom-service-worker.js)。

如果您想使用不同的文件名,可以在 /quasar.config 文件中进行修改:

/quasar.config file

sourceFiles: {
  pwaRegisterServiceWorker: 'src-pwa/register-service-worker',
  pwaServiceWorker: 'src-pwa/custom-service-worker',
  pwaManifestFile: 'src-pwa/manifest.json',
}