hexo博客简单支持PWA

摘要：文章首次发表在博客支持了前言使用插件使博客支持功能，目前我所知道的有两种插件均可实现该功能前提全站支持目前本人使用的是腾讯云的免费证书网站配置已经有很多文章写了配置过程本篇文章不在赘述使用安装修改配置文件的配置文件采用语言想要

文章首次发表在: 博客支持PWA了~

使用hexo插件使博客支持pwa功能，目前我所知道的有两种插件均可实现该功能

hexo-pwa

hexo-offline

全站支持HTTPS.(ps: 目前本人使用的是腾讯云的免费证书)

网站配置HTTPS, 已经有很多文章写了配置过程, 本篇文章不在赘述

npm i --save hexo-pwa

hexo的配置文件采用yml语言, 想要了解该语言的可以去看看

在根目录的_config.yml中添加

pwa:
  manifest:
    path: /manifest.json
    body:
      "name": "funnycoderstar"
      "short_name": "star"
      "theme_color": "rgba(203,7,83,0.86)"
      "background_color": "#FAFAFA"
      "display": "standalone"
      "Scope": "/"
      "start_url": "/"
      icons:
        - src: https://cdn.wangyaxing.cn/icon-144x144.png?v=1
          sizes: 144x144
          type: image/png
        - src: https://cdn.wangyaxing.cn/icon-128x128.png
          sizes: 128x128
          type: image/png
        - src: https://cdn.wangyaxing.cn/icon-96x96.png
          sizes: 96x96
          type: image/png
  serviceWorker:
    path: /sw.js
    preload:
      urls:
        - /
      posts: 5
    opts:
      networkTimeoutSeconds: 5
    routes:
      - pattern: !!js/regexp /hm.baidu.com/
        strategy: networkOnly
      - pattern: !!js/regexp /.*.(js|css|jpg|jpeg|png|gif)$/
        strategy: cacheFirst
      - pattern: !!js/regexp ///
        strategy: networkFirst
  priority: 5

参数含义可以去hexo-pwa文档中查看

这两个文件放的位置要和配置中的路径一致, 我是放在跟目录的
sw.js

importScripts("https://g.alicdn.com/kg/workbox/3.3.0/workbox-sw.js");

if (workbox) {
    workbox.setConfig({ modulePathPrefix: "https://g.alicdn.com/kg/workbox/3.3.0/" });

    workbox.precaching.precache(["/", "/index.html"]);

    workbox.routing.registerRoute(new RegExp("^https?://wangyaxing.cn/?$"), workbox.strategies.networkFirst());

    workbox.routing.registerRoute(new RegExp(".*.html"), workbox.strategies.networkFirst());

    workbox.routing.registerRoute(new RegExp(".*.(?:js|css)"), workbox.strategies.staleWhileRevalidate());

    workbox.routing.registerRoute(new RegExp("https://cdn.wangyaxing.cn/"), workbox.strategies.cacheFirst());
}

manifest.json

{
  "name": "funnycoderstar",
  "short_name": "star",
  "theme_color": "rgba(203,7,83,0.86)",
  "background_color": "#FAFAFA",
  "display": "standalone",
  "Scope": "/",
  "start_url": "/",
  "icons": [
    {
      "src": "/source/images/icons/icon-96x96.png",
      "sizes": "96x96",
      "type": "image/png"
    },
    {
      "src": "/source/images/icons/icon-128x128.png",
      "sizes": "128x128",
      "type": "image/png"
    },
    {
      "src": "/source/images/icons/icon-144x144.png",
      "sizes": "144x144",
      "type": "image/png"
    },
  ],
  "splash_pages": null
}

manifest生成地址： https://app-manifest.firebase...

地址栏输入: Chrome://flags

搜索并启用以下项目: Desktop PWAs(桌面PWAs)、App Banners(应用横幅)、Experimental App Banners(实验性应用横幅)

重启浏览器使修改的设置生效

点击地址栏最右边按钮

选择"安装 funnycoderstar"

在桌面上即可看到博客的小图标

感兴趣的小伙伴可以来我的博客体验一下, 哈哈~~  https://.wangyaxing.cn/

使用基本与hexo-pwa相同, 下面简述一下过程

npm i --save hexo-offline

# Offline
## Config passed to sw-precache
## https://github.com/JLHwung/hexo-offline
offline:
  maximumFileSizeToCacheInBytes: 10485760
  staticFileGlobs:
    - public/**/*.{js,html,css,png,jpg,jpeg,gif,svg,json,xml}
  stripPrefix: public
  verbose: true
  runtimeCaching:
    - urlPattern: /*
      handler: cacheFirst
      options:
        origin: cdn.example.com
    - urlPattern: /*
      handler: cacheFirst
      options:
        origin: cdn.another-example.org

manifest.json放到 source目录下

next主题在 layout/_partials/head.swig 添加

文件放置位置一定要与配置文件中写的路径一致

图标大小一定按照PWA的严格要求

打开 Chrome Dev Tools的Application一栏中进行调试

还可以通过观察network中的请求是否有小齿轮标志来检测serviceWorker是否已加载

hexo博客支持PWA和压缩博文

让 Hexo 博客支持 PWA

五步让 Hexo 博客支持 PWA