Vue Academy · 课时

配置 vite-plugin-pwa

Q: 「配置 vite-plugin-pwa」这节课中我会学到什么？

插件配置、清单选项、图标、屏幕截图、显示模式，以及作用域 你通过在浏览器中直接运行的动手代码来练习 Vue Academy，全天候 AI 导师会在你学习这节课的过程中回答你的问题。

插件配置、清单选项、图标、屏幕截图、显示模式，以及作用域

配置 vite-plugin-pwa 是 CoddyKit 上的免费 Vue Academy 课时。这是第 1 节课，共 4 节。你可以在下方免费阅读本课时的完整内容 — 然后在浏览器中使用内置代码编辑器和全天候 AI 导师进行实践。这是 Vue Academy 学习路径的一部分，你的进度在网页和 CoddyKit 应用中同步。 Vue Academy 课程共包含 4 节课。

什么是 PWA

渐进式 Web 应用通过服务工作线程和 Web 应用清单，为 Web 应用增加可安装、离线支持以及类似原生应用的功能。vite-plugin-pwa 可以自动将这两者接入 Vue + Vite 构建流程。

安装插件

将 vite-plugin-pwa 作为开发依赖安装。它会在底层使用 Workbox 生成服务工作线程。

npm install -D vite-plugin-pwa

将 VitePWA 添加到插件中

导入 VitePWA，并将其添加到 Vite 插件数组中。选项会传递给它唯一的一次函数调用。

import { defineConfig } from "vite";
import vue from "@vitejs/plugin-vue";
import { VitePWA } from "vite-plugin-pwa";

export default defineConfig({
  plugins: [vue(), VitePWA({ /* options */ })]
});

registerType

registerType 控制更新行为。"autoUpdate" 会立即激活新的服务工作线程；"prompt" 则允许您在重新加载前询问用户。

VitePWA({
  registerType: "autoUpdate"
});

清单选项

manifest 对象会成为 Web 应用清单。重要字段包括 name、short_name、theme_color 和 icons。

VitePWA({
  manifest: {
    name: "My Vue App",
    short_name: "VueApp",
    theme_color: "#42b883"
  }
});

图标数组

请提供多个图标尺寸，以便 OS 为主屏幕和启动画面选择合适的图标。请加入一个可遮罩图标，以支持自适应形状。

manifest: {
  icons: [
    { src: "/pwa-192.png", sizes: "192x192", type: "image/png" },
    { src: "/pwa-512.png", sizes: "512x512", type: "image/png" },
    { src: "/maskable.png", sizes: "512x512", type: "image/png", purpose: "maskable" }
  ]
}

Workbox 配置

workbox 选项用于配置生成的服务工作线程，包括要预缓存的文件以及运行时缓存规则。

VitePWA({
  workbox: {
    globPatterns: ["**/*.{js,css,html,png,svg}"]
  }
});

injectRegister 自动模式

injectRegister: "auto" 会自动注入注册服务工作线程所需的代码，因此您不必手动编写注册逻辑。

VitePWA({
  registerType: "autoUpdate",
  injectRegister: "auto"
});

使用虚拟注册模块

对于基于提示的更新，请在入口文件中导入虚拟的 registerSW 模块，并接入其回调函数。

import { registerSW } from "virtual:pwa-register";

const updateSW = registerSW({
  onNeedRefresh() { /* show update toast */ },
  onOfflineReady() { /* show ready toast */ }
});

在开发环境中启用

默认情况下，服务工作线程只会在生产环境中运行。启用 devOptions，即可在开发过程中测试 PWA 行为。

VitePWA({
  devOptions: { enabled: true }
});

验证安装

完成构建并启动服务后，打开 Chrome DevTools 的 Application 选项卡。您应该能看到已解析的清单、处于活动状态的服务工作线程，以及地址栏中可用的安装提示。

快速检查

injectRegister: "auto" 会执行什么操作？

回顾

将 VitePWA 添加到 Vite 插件数组中，并配置 registerType（autoUpdate 或 prompt）、manifest（name、short_name、theme_color 和 icons 数组）以及 workbox 选项。使用 injectRegister: "auto" 自动注册服务工作线程，或使用 virtual:pwa-register 模块实现基于提示的更新。

常见问题解答

「配置 vite-plugin-pwa」课时是免费的吗？

是的 — 「配置 vite-plugin-pwa」的完整文本可在网页上免费阅读。要进行交互式练习（内置代码编辑器和全天候 AI 导师）并解锁 Vue Academy 课程的其余内容，请升级到 CoddyKit PRO。 Vue Academy 课程共包含 4 节课。

「配置 vite-plugin-pwa」这节课中我会学到什么？

插件配置、清单选项、图标、屏幕截图、显示模式，以及作用域你通过在浏览器中直接运行的动手代码来练习 Vue Academy，全天候 AI 导师会在你学习这节课的过程中回答你的问题。

学习 Vue Academy 需要有经验吗？

无需任何先前经验。CoddyKit 上的 Vue Academy 课程适合初学者到高级学习者，你可以从这里开始或从头开始，按照自己的节奏学习。这是第 1 节课，共 4 节。

「配置 vite-plugin-pwa」课时需要多长时间？

大多数 CoddyKit 课程大约需要 5–10 分钟。每节课都很精短且互动，所以你能稳步进步，并在网页和应用中从离开的地方继续。

我能在这节 Vue Academy 课中编写并运行代码吗？

能。每节 Vue Academy 课都包含内置代码编辑器，你可以在浏览器中直接编写并运行真实代码，并获得即时 AI 反馈 — 无需本地设置。

此课程中的所有课时

← 返回 Vue Academy