WebPack
您现在的位置是:博客主页 > Web教程 > WebPack

webpack v4.30.0(13)官方指南说明文档 渐进式网络应用程序

By 点想博主 on WebPack Time 2019-05-04 from:互联网 579人已围观
简介:    渐进式网络应用程序(Progressive Web Application - PWA),是一种可以提供类似于原生应用程序(native app)体验的网络应用程序(web app)。PWA 可以用来做很多事。其中最重要的是,在离线(offline)时应用程序能够继续运行功能。这是通过使用名为 Service Workers 的网络技术来实现的。

本指南继续沿用管理输出中的代码示例。

渐进式网络应用程序(Progressive Web Application - PWA),是一种可以提供类似于原生应用程序(native app)体验的网络应用程序(web app)。PWA 可以用来做很多事。其中最重要的是,在离线(offline)时应用程序能够继续运行功能。这是通过使用名为 Service Workers 的网络技术来实现的。

本章将重点介绍,如何为我们的应用程序添加离线体验。我们将使用名为 Workbox 的 Google 项目来实现此目的,该项目提供的工具可帮助我们更轻松地配置 web app 的离线支持。

现在我们并没有离线环境下运行过

到目前为止,我们一直是直接查看本地文件系统的输出结果。通常情况下,真正的用户是通过网络访问网络应用程序;用户的浏览器会与一个提供所需资源(例如,.html, .js 和 .css 文件)的服务器通讯。
那么让我们来使用一个简易服务器,搭建出我们所需的离线体验。我们将使用 http-server package 包:npm install http-server --save-dev。还要修改 package.json 的 scripts 部分,来添加一个 start 脚本:

package.json

{
  ...
  "scripts": {
-    "build": "webpack"
+    "build": "webpack",
+    "start": "http-server dist"
  },
  ...
}

如果你之前没有操作过,请运行命令 npm run build 来构建你的项目。然后运行命令 npm start。这应该输出以下:

> http-server dist

启动 http-server,服务目录是 dist
可以访问:
  http://xx.x.x.x:8080
  http://127.0.0.1:8080
  http://xxx.xxx.x.x:8080
按下 CTRL-C 停止服务

如果你打开浏览器访问 http://localhost:8080/index.html (即 http://127.0.0.1:8080/index.html)(http-server需要安装),你应该会看到在 dist 目录创建出服务,并可以访问 webpack 应用程序。如果停止服务器然后刷新,则 webpack 应用程序不再可访问。
这就是我们最终要改变的现状。在本章结束时,我们应该要实现的是,停止服务器然后刷新,仍然可以查看应用程序正常运行。

Administrator@PC-20190222QKVD MINGW64 /d/webpack-demo
$ npm run build

> webpack-demo@1.0.0 build D:webpack-demo
> webpack

Hash: ef3cef4e4e8126acb8ad
Version: webpack 4.30.0
Time: 847ms
Built at: 2019-05-04 01:18:50
          Asset       Size  Chunks             Chunk Names
  app.bundle.js   70.6 KiB    0, 1  [emitted]  app
     index.html  254 bytes          [emitted]
print.bundle.js   1.02 KiB       1  [emitted]  print
Entrypoint app = app.bundle.js
Entrypoint print = print.bundle.js
[0] ./src/print.js 84 bytes {0} {1} [built]
[2] ./src/index.js 429 bytes {0} [built]
[3] (webpack)/buildin/global.js 472 bytes {0} [built]
[4] (webpack)/buildin/module.js 497 bytes {0} [built]
    + 1 hidden module

WARNING in configuration
The 'mode' option has not been set, webpack will fallback to 'production' for this value. Set 'mode' option to 'development' or 'production' to enable defaults for each environment.
You can also set it to 'none' to disable any default behavior. Learn more: https://webpack.js.org/concepts/mode/
Child html-webpack-plugin for "index.html":
     1 asset
    Entrypoint undefined = index.html
    [2] (webpack)/buildin/global.js 472 bytes {0} [built]
    [3] (webpack)/buildin/module.js 497 bytes {0} [built]
        + 2 hidden modules

Administrator@PC-20190222QKVD MINGW64 /d/webpack-demo
$ http-server -d false
Starting up http-server, serving ./
Available on:
  http://169.254.44.138:8081
  http://192.168.1.2:8081
  http://127.0.0.1:8081
Hit CTRL-C to stop the server 

添加 Workbox

添加 workbox-webpack-plugin 插件,并调整 webpack.config.js 文件:

npm install workbox-webpack-plugin --save-dev

webpack.config.js

const path = require('path');
  const HtmlWebpackPlugin = require('html-webpack-plugin');
  const CleanWebpackPlugin = require('clean-webpack-plugin');
+ const WorkboxPlugin = require('workbox-webpack-plugin');

  module.exports = {
    entry: {
      app: './src/index.js',
      print: './src/print.js'
    },
  plugins: [
    new CleanWebpackPlugin(['dist']),
    new HtmlWebpackPlugin({
-     title: 'Output Management'
+     title: 'Progressive Web Application'
-   })
+   }),
+   new WorkboxPlugin.GenerateSW({
+     // 这些选项帮助 ServiceWorkers 快速启用
+     // 不允许遗留任何“旧的” ServiceWorkers
+     clientsClaim: true,
+     skipWaiting: true
+   })
  ],
    output: {
      filename: '[name].bundle.js',
      path: path.resolve(__dirname, 'dist')
    }
  };

有了 Workbox,我们再看下执行 npm run build 时会发生什么:

Administrator@PC-20190222QKVD MINGW64 /d/webpack-demo
$ npm run build

> webpack-demo@1.0.0 build D:webpack-demo
> webpack

Hash: ef3cef4e4e8126acb8ad
Version: webpack 4.30.0
Time: 791ms
Built at: 2019-05-04 01:35:45
                                                Asset       Size  Chunks             Chunk Names
                                        app.bundle.js   70.6 KiB    0, 1  [emitted]  app
                                           index.html  264 bytes          [emitted]
precache-manifest.30abbff5f509507b7f9fca1580565c03.js  308 bytes          [emitted]
                                      print.bundle.js   1.02 KiB       1  [emitted]  print
                                    service-worker.js  927 bytes          [emitted]
Entrypoint app = app.bundle.js
Entrypoint print = print.bundle.js
[0] ./src/print.js 84 bytes {0} {1} [built]
[2] ./src/index.js 429 bytes {0} [built]
[3] (webpack)/buildin/global.js 472 bytes {0} [built]
[4] (webpack)/buildin/module.js 497 bytes {0} [built]
    + 1 hidden module

WARNING in configuration
The 'mode' option has not been set, webpack will fallback to 'production' for this value. Set 'mode' option to 'development' or 'production' to enable defaults for each environment.
You can also set it to 'none' to disable any default behavior. Learn more: https://webpack.js.org/concepts/mode/
Child html-webpack-plugin for "index.html":
     1 asset
    Entrypoint undefined = index.html
    [2] (webpack)/buildin/global.js 472 bytes {0} [built]
    [3] (webpack)/buildin/module.js 497 bytes {0} [built]
        + 2 hidden modules 

现在你可以看到,生成了 2 个额外的文件:sw.js 和体积很大的 precache-manifest.30abbff5f509507b7f9fca1580565c03.js。sw.js 是 Service Worker 文件,precache-manifest.30abbff5f509507b7f9fca1580565c03.js 是 sw.js 引用的文件,所以它也可以运行。可能在你本地生成的文件会有所不同;但是你那里应该会有一个 sw.js 文件。
所以,值得高兴的是,我们现在已经创建出 Service Worker 的高兴点。接下来该做什么?

注册我们的 Service Worker
让我们将注册 Service Worker,使其出场并开始表演。通过添加以下注册代码来完成此操作:
index.js

import _ from 'lodash';
  import printMe from './print.js';

+ if ('serviceWorker' in navigator) {
+   window.addEventListener('load', () => {
+     navigator.serviceWorker.register('/sw.js').then(registration => {
+       console.log('SW registered: ', registration);
+     }).catch(registrationError => {
+       console.log('SW registration failed: ', registrationError);
+     });
+   });
+ }

再次运行 npm build build 来构建包含注册代码版本的应用程序。然后用 npm start 启动服务。

访问 http://localhost:8080 并查看 console 控制台。

在那里你应该看到:

SW registered

现在来进行测试。停止服务器并刷新页面。如果浏览器能够支持 Service Worker,你应该可以看到你的应用程序还在正常运行。然而,服务器已经停止了服务,此刻是 Service Worker 在提供服务。
结论
你已经使用 Workbox 项目构建了一个离线应用程序。开始进入将 web app 改造为 PWA 的旅程。你现在可能想要考虑下一步做什么。在这里的谷歌文档中可以找到一些不错的资源。

文件尺寸 0.000 bytes
下载次数 0( 次 )
本地下载 本地下载
百度密钥 r1bk
百度网盘 百度下载
相关文章
文章评论

( 0 )