[译]基于Vue JS, Webpack 以及Material Design的渐进式web应用 [Part 1]

渐进式web应用是大势所趋。越来越多的大公司开始使用这些技术（比如推特：https://mobile.twitter.com/）。

想象你可以在地铁中浏览一个web应用，这个应用能够向用户推送通知并且提供实时的数据，以及提供类似于app的浏览，这些就是PWA的大致的能力。

渐进式web应用（PWA）是一个web应用能够提供给用户一种类似于app的体验。PWA得益于现代web科技创新（Service Workers, Native APIS, JS famework）以及提升的web应用质量标准。

如果你想了解更多关于PWA，请访问这个很棒的Google developer page。

看一下下面的PWA！看起来很像原生的app，是不是？

推特渐进式web应用

从开发者的角度来看，PWA相对于原生应用具有巨大的优点。它基本上就是一个网站，因此：

你可以选择任何你喜欢的框架来进行开发；
一段代码搞定一切：它是跨平台的以及跨设备的（代码是通过用户的浏览器执行的）；
很容易获得：不需要通过应用商店来下载。

然而，在2017年早期，PWA仍然面临一些限制条件：

Safari不支持一些基本的PWA特性，比如 Service workers，但是苹果公司似乎已经准备开始着手了；
一些原生的函数依然没有得到支持：对于更多信息，浏览这个页面What web can do。

教程目标

本教程的目标是利用VueJS以及Webpack从头创建一个基本的但是完整的渐进式web应用。我们的应用将会满足介绍里面的所有需求：渐进式的，响应式的，连接独立的等等。我想给你一个能够在PWA内完成的目标的总览：流畅的原生式的应用，离线行为，原生特性结构，推送通知。

为了让事情保持挑战性，我们打算构建一个猫图信息app：CropChat！CropChat用户能够阅读主流的猫的图片，并且能够打开他们了解更多细节以及上传新的猫的图片（首先从互联网，接着是从设备驱动或者照相机）。

这个教程将会分为几个部分，它们将会连续地进行发布

[Part 1] Lite基于Vue JS, Webpack 以及Material Design的渐进式web应用
[Part 2] 基于Vue-Resource以及VueFire将App和远程的API进行连接
[Part 3] 基于Service Worker来实现离线模式
[Part 4] 访问设备照相机来拍照
[Part 5] 访问设备驱动来上传图片
[Part 6] 实现推送通知
[Part 7] 访问设备地址

我们的PWA的基本组件

我们的渐进式web应用是基于你喜欢的现在组件！

VueJS 2视图层：通过利用Material Design Lite来渲染视图
Vue-Router：处理SPA路由
Vue-Resource & Vuefire：处理和Firebase数据库的通信
Service Worker：处理离线模式并且保持数据更新
Webpack & Vue-loader：构建我们的应用，提供热加载 build our application, provides hot reload, ES2016 and pre-processors.

让我们开始part 1！

[PART 1] Lite基于VueJS, Webpack 以及 Material Design Lite创建一个单页面应用

如果你不熟悉VueJS 2,我强烈建议你阅读官方教程。

构建VueJS APP基础

我们打算利用Vue-cli来创建我们的应用：

`npm install -g vue-cli`

Vue-cli自带一些模板。我们将会选择webpack模板。Webpack是一个对于Javascript应用的现代模块打包工具，它能够处理并且构建我们的资源。Vue-cli将使用Webpack，vue-loader（热加载！），JS linter以及测试套件来创建一个虚拟的VueJS应用。

`vue init webpack cropchat`

你可能会问一些问题。下面是我使用过的配置：

`This will install Vue 2.x version of the template.`

 `For Vue 1.x use: vue init webpack#1.0 cropchat`

? Project name cropchat
? Project description Image messenging application
? Author Charles BOCHET <charlesb@theodo.fr>
? Vue build standalone
? Install vue-router? Yes
? Use ESLint to lint your code? Yes
? Pick an ESLint preset Standard
? Setup unit tests with Karma + Mocha? Yes
? Setup e2e tests with Nightwatch? No

 `vue-cli · Generated "cropchat".`

这个过程会创建一个包含以下子文件夹的项目文件夹：

build: 包含webpack以及vue-loader配置文件
config: 包含我们的app配置（环境，参数等等）
src: 我们应用的源代码
static: 图片，css以及其它的公共资源
test: Karma & Mocha创建的单元测试文件

然后运行：

cd cropchat
npm install
npm run dev

这将会在你的浏览器打开localhost:8080：

通过一个合适的Manifest让它可以进行安装：

PWA的最大优点之一就是容易安装并且分享。让我们别再等待了！

为了这样做，我们需要添加一个manifest.json文件并且在index.html文件中进行声明。

pwa-manifest-webpack-plugin能够让我们在应用构建的时候生成文件：

`npm i pwa-manifest-webpack-plugin --save`

我们接着能够通过编辑build/webpack.dev.conf.js 以及build/webpack.prod.conf.js来更新构建过程。

在顶部引入pwa-manifest-webpack-plugin ：

var path = require('path')
var manifestPlugin = require('pwa-manifest-webpack-plugin')

并且将它添加到插件：

plugins: [new manifestPlugin({name: 'CropChat',description: 'CropChat - Image Messenger Application',display: 'fullscreen',icon: {src: path.resolve('src/assets/logo.png'),sizes: [200]}}),

最后，在 index.html中声明使用manifest.json：

<meta name="viewport" content="width=device-width, initial-scale=1.0">
<link rel="manifest" href="./manifest.json">

你可能需要重启你的应用：来这样做，杀掉之间的进程并且再次运行：

`npm run dev`

就是它了！让我们在手机设备上安装CropChat。有多种方式可以从不同的手机设备上访问localhost:8080。我最喜欢就是使用ngrok。

Ngrok是一种服务，可以远程登录您的本地环境，免费！

安装它：

`npm install -G ngrok`

接着，运行：

`ngrok http 8080`

那应该会给你以下的输出：

ngrok by @inconshreveable                                                                   (Ctrl+C to quit)Session Status                online
Version                       2.1.18
Region                        United States (us)
Web Interface                 http://127.0.0.1:4040
Forwarding                    http://5ef29506.ngrok.io -> localhost:8080
Forwarding                    https://5ef29506.ngrok.io -> localhost:8080                                   Connections                   ttl     opn     rt1     rt5     p50     p90                                   39      3       0.01    0.01    120.01  881.89

通过你的手机浏览ngrok的url http://5ef29506.ngrok.io 。你可以在你的设备桌面添加！

Cropchat的源代码能够在GitHub here上能够访问。Git历史符合教程的步骤：你可以在下面的commit 5ff77fd3cd71a988fad9c187d57e87ea80d670f0种发现这个步骤的变化

想了解更多关于ngrok，你可以阅读Matthieu Auger的文章：Expose your local environment to the world with ngrok

创建视图框架和句柄路由

既然我们已经具有合适的基础，那么我们打算开始构建CropChat的特性。CropChat具有三个视图：

Home View: 展示一个猫的图片列表
Detail View: 展示特定猫的图片的细节（在Home View种点击访问）
Post View: 能够让用户上传一个新的图片

创建一个具有以下框架的src/component/HomeView.vue 视图：

<template><ul class="list"></ul>
</template>

<script>
export default {
}
</script>

<style scoped>.list {width: 100%;padding: 0;}
</style>

对于src/component/DetailView.vue视图也是一样的：

<template><div class="card-image"></div>
</template>

<script>
export default {
}
</script>

<style scoped>
</style>

对于 src/component/PostView.vue也是一样的：

<template><div class="waiting">Not yet available</div>
</template>

<script>
export default {
}
</script>

<style scoped>.waiting {padding: 10px;color: #555;}
</style>

最终，更新路由文件 src/router/index.js：

import Vue from 'vue'
import Router from 'vue-router'
import HomeView from 'components/HomeView'
import DetailView from 'components/DetailView'
import PostView from 'components/PostView'

`Vue.use(Router)`

export default new Router({routes: [{path: '/',name: 'home',component: HomeView},{path: '/detail/:id',name: 'detail',component: DetailView},{path: '/post',name: 'post',component: PostView}]
})

也移除没有使用的Hello.vue视图。你应该你能够直接看到影响你手机app的变化（热加载很棒，是不是？）

Git commit: 22ab9a2058dae8f7689b8635ff52d89652675aa6

安装 Material Design Lite

不知道Material Design Lite？它是一个轻量级的并且容易在你的web应用上实现Material Design 的框架。

你可以在这看到更多的文档：Get MDL.io

更新依赖：

`npm install material-design-lite --save`

更新src/App.vue来导入MDL样式并且加载MDL模块：

<script>
require('material-design-lite')
...
</script>

<style>@import url('https://fonts.googleapis.com/icon?family=Material+Icons');@import url('https://code.getmdl.io/1.2.1/material.blue-red.min.css');
</style>

Git commit: b726b40488132c400dd861bd397f61b15e81631e

为你的单页面应用提供一个导航栏：

更新主要组件src/App.vue种的模块部分：

<template><div class="mdl-layout mdl-js-layout mdl-layout--fixed-header"><header class="mdl-layout__header"><div class="mdl-layout__header-row"><span class="mdl-layout-title">CropChat</span></div></header><div class="mdl-layout__drawer"><span class="mdl-layout-title">CropChat</span><nav class="mdl-navigation"><a class="mdl-navigation__link" href="/#/" @click="hideMenu">Home</a><a class="mdl-navigation__link" href="/#/post" @click="hideMenu">Post a picture</a></nav></div><main class="mdl-layout__content"><div class="page-content"><router-view></router-view></div></main></div>
</template>

因为Material Design Lite不是特别为单页面应用构建的，因此在用户点击菜单链接的时候我们需要隐藏burger菜单：

<script>
...
export default {name: 'app',methods: {hideMenu: function () {document.getElementsByClassName('mdl-layout__drawer')[0].classList.remove('is-visible')document.getElementsByClassName('mdl-layout__obfuscator')[0].classList.remove('is-visible')}}
}
</script>

Git commit: 829d0af767a9f7cba13355296d9da79384d80099

传播视图并将你的应用带到生活

我们还没有连接一个后台的服务。我们现在打算暂时使用假数据。

创建一个src/data.js文件：

export default {pictures: [{'id': 0,'url': 'http://25.media.tumblr.com/tumblr_m40h4ksiUa1qbyxr0o1_400.gif','comment': 'A cat game','info': 'Posted by Kevin on Friday'},{'id': 1,'url': 'http://25.media.tumblr.com/tumblr_lhd7n9Qec01qgnva2o1_500.jpg','comment': 'Tatoo & cat','info': 'Posted by Charles on Tuesday'},{'id': 2,'url': 'http://24.media.tumblr.com/tumblr_m4j2atctRm1qejbiro1_1280.jpg','comment': 'Santa cat','info': 'Posted by Richard on Monday'},{'id': 3,'url': 'http://25.media.tumblr.com/tumblr_m3rmbwhVB51qhwmnpo1_1280.jpg','comment': 'Mexico cat','info': 'Posted by Richard on Monday'},{'id': 4,'url': 'http://24.media.tumblr.com/tumblr_mceknxs4Lo1qd477zo1_500.jpg','comment': 'Curious cat','info': 'Posted by Richard on Monday'}]
}

在HomeView.vue script部分中导入数据并且将图片链接到对应的细节视图：

<script>
import data from '../data'
export default {methods: {displayDetails (id) {this.$router.push({ name: 'detail', params: { id: id }})}},data () {return {'pictures': data.pictures}}
}
</script>

更新HomeView.vue 模板和样式：

<template><div><div class="mdl-grid"><div class="mdl-cell mdl-cell--3-col mdl-cell mdl-cell--1-col-tablet mdl-cell--hide-phone"></div><div class="mdl-cell mdl-cell--6-col mdl-cell--4-col-phone"><div v-for="picture in this.$data.pictures" class="image-card" @click="displayDetails(picture.id)"><div class="image-card__picture"><img :src="picture.url" /></div><div class="image-card__comment mdl-card__actions"><span>{{ picture.comment }}</span></div></div></div></div><a class="add-picture-button mdl-button mdl-js-button mdl-button--fab mdl-button--colored" href="/#/post"><i class="material-icons">add</i></a></div>
</template>
...
<style scoped>.add-picture-button {position: fixed;right: 24px;bottom: 24px;z-index: 998;}.image-card {position: relative;margin-bottom: 8px;}.image-card__picture > img {width:100%;}.image-card__comment {position: absolute;bottom: 0;height: 52px;padding: 16px;text-align: right;background: rgba(0, 0, 0, 0.5);}.image-card__comment > span {color: #fff;font-size: 14px;font-weight: bold;}
</style>

对DetailView.vue进行同样的操作：

<template><div class="mdl-grid"><div class="mdl-cell mdl-cell--8-col"><div class="picture"><img :src="this.$data.pictures[$route.params.id].url" /></div><div class="info"><span>{{ this.$data.pictures[$route.params.id].info }}</span></div></div><div class="mdl-cell mdl-cell--4-col mdl-cell--8-col-tablet"><div class="comment"><span>{{ this.$data.pictures[$route.params.id].comment }}</span></div><div class="actions"><a class="mdl-button mdl-js-button mdl-button--raised mdl-button--colored" href="/#/post">ANSWER</a></div></div></div>
</template>

<script>
import data from '../data'
export default {data () {return {'pictures': data.pictures}}
}
</script>

<style scoped>.picture > img {color: #fff;width:100%;}.info {text-align: right;padding: 5px;color: #555;font-size: 10px;}.comment {padding: 10px;color: #555;}.actions {text-align: center;}
</style>

Git commit: 39360f251da153c780cd148dc3cf234348bb1e87

关于'href'链接的使用：我推荐使用vuejs的组件但是在这我想使代码尽可能的简单。

最后的结果

我们完成了，CropChat完成啦！

源代码能够在GitHub repository访问： https://github.com/charlesBochet/vueJSPwa

总结

我希望我已经令你确信你能够利用VueJS和Webpack就可以简单地创建web应用。总结来说：

Vue-cli可以在命令行种创建一个虚拟的VueJS + Webpack应用
通过添加Manifest.json文件让你的web应用能够安装
使用Vue-Router以及Material Design来创建一个类似于app用户体验的应用

然而，CropChat还依然不是一个渐进式web应用：让我们看一下PWA的需求清单：

一半的需求还没有满足。在下一个部分将会有其它的目标。未完待续！

译者注：

安利几个我之前翻译过的其它的关于PWA的文章以及我自己的PWA小应用：

Twitter Lite以及大规模的高性能React渐进式网络应用
Service worker介绍
weather app
subway-shanghai