美团开源了mpvue这个项目,使得我们又多了一种用来开发小程序的框架选项。由于mpvue
框架是完全基于Vue框架的(重写了其runtime
和compiler
),因此在用法上面是高度和Vue
一致的(某些功能由于受限于小程序环境本身的原因而不能使用),这给使用过Vue
开发Web应用的前端开发者提供了极低的切换门槛来开发小程序。
mpvue
Vue.js 小程序版, fork 自 vuejs/vue@2.4.1,保留了 vue runtime 能力,添加了小程序平台的支持。
mpvue
是一个使用 Vue.js 开发小程序的前端框架,目前支持 微信小程序
、百度智能小程序
,头条小程序
和 支付宝小程序
。 框架基于 Vue.js
,修改了的运行时框架 runtime 和代码编译器 compiler 实现,使其可运行在小程序环境中,从而为小程序开发引入了 Vue.js
开发体验。
名称由来
mp
:mini program 的缩写mpvue
:Vue.js in mini program
主要特性
使用 mpvue
开发小程序,你将在小程序技术体系的基础上获取到这样一些能力:
- 彻底的组件化开发能力:提高代码复用性
- 完整的
Vue.js
开发体验 - 方便的
Vuex
数据管理方案:方便构建复杂应用 - 快捷的
webpack
构建机制:自定义构建策略、开发阶段 hotReload - 支持使用 npm 外部依赖
- 使用
Vue.js
命令行工具 vue-cli 快速初始化项目 - H5 代码转换编译成小程序目标代码的能力
其它特性正在等着你去探索。
配套设施
mpvue
作为小程序版本的 Vue.js
,在框架 SDK 之外,完整的技术体系还包括如下设施。
- mpvue-loader 提供 webpack 版本的加载器
- mpvue-webpack-target webpack 构建目标
- postcss-mpvue-wxss 样式代码转换预处理工具
- px2rpx-loader 样式转化插件
- mpvue-quickstart mpvue-quickstart
- mpvue-simple 辅助 mpvue 快速开发 Page / Component 级小程序页面的工具
- 其它
通过官网提供的五分钟快速上手教程,可以发现它的开发过程和Vue保持高度一致,连使用的命令行工具也还是原先开发Web应用时所用的vue-cli
:
搭建步骤
一、开发环境Node.js
现代前端开发框架和环境都是需要 Node.js 的,如果没有的话,请先下载 nodejs 并安装。
安装完成后,打开你的命令行输入如下命令,验证安装是否成功:
node --versionv8.1.2npm --version5.0.3
然后,我们需要执行以下命令,将npm的下载源切换到国内淘宝的镜像,以提高下载时的速度和成功率:
npm set registry https://registry.npm.taobao.org/
但是我电脑上用的不是npm
,而是yarn
,因为yarn
相比npm
使用更方便,快速,安装yarn
可以参考
Npm vs Yarn 之备忘详单,
yarn官方文档
JavaScript 包管理工具 yarn 的使用
安装完成后,打开你的命令行输入如下命令,验证安装是否成功:
yarn --version1.3.2
二、开发环境vue-cli
npm install vue-cli -g
提示许可被拒绝, 想起来了昨天启动时的权限问题, 试探性在命令前面加上了sudo, 结果可行:
sudo cnpm install --global vue-cli
安装成功, 查询下版本:
vue -V2.9.2
三、开始创建项目
vue init mpvue/mpvue-quickstart mpvueTest
现在mpvue的模板代码已经生成,现在还不能运行,需要
cd到项目目录下
执行
yarn
进行安装第三方库,安装完成之后,执行
yarn dev
这样就可以运行起来了
四、搭建小程序的开发环境
小程序自己有一个专门的微信开发者工具,最新版本下载地址。
这一步比较简单,按照提示一步步安装好就行,然后用微信扫描二维码登陆。 至此小程序的开发环境差不多完成。
打开之后,就会看到我们新建的小程序页面
至此我们这个基本mpvue小程序框架已经搭建完成
但是这个只是最基本的框架,对于我们正在做项目还是不够的,需要在进行完善
五、加入常用第三方库
需要引入一些项目需要的基本第三方库,下面是我们项目目前用到的库,打开项目的package.json
,加入一下内容,
"dependencies": { "mpvue": "^2.0.0", "vuex": "^3.0.1", "weapp-qrcode": "^0.9.0", "flyio": "^0.5.9", "install": "^0.12.2", "mp-weui": "^1.0.3", "mpvue-zanui": "^1.0.2", "common-mpvue": "^0.4.6", "mpvue-config-loader": "^0.1.3" },
cd到项目目录下,执行一下命令
yarn
这些第三方库下载到我们的项目中,然后打开项目的main.js引入一些第三方。
import Vue from 'vue'import App from './App'import store from '@/store';import WeUI from 'mp-weui/packages';Vue.use(WeUI);Vue.config.productionTip = falseApp.mpType = 'app'const app = new Vue({ store, ...App});app.$mount();
提醒tips1:
还有一个我搭建时候需要的坑,就是新版本的
mpvue
,不能在main.js
里面配置小程序的config
,我们之前的项目都是在main.js
里面进行配置,但是我昨天进行配置,发现不可以配置了,在网上寻找答案,最终发现不支持了在main.js
里面配置,在项目的main.json
里面进行配置
提醒tips2:
还有就是之前项目的每个页面的配置也是在页面的
main.js
里面进行配置,现在这个也不支持了,需要在页面下面的main.json
里面进行配置,如下所示
{ "navigationBarTitleText": "页面标题", "enablePullDownRefresh": true}
六、加入常用方法
在项目utils
目录下的index.js
加入一些常用的方法
// /**// * 获取storage// */export function getCache(key) { var value = wx.getStorageSync(key) if (value) { return value } return ""}// /**// * 删除storage// */export function removeCache(key) { wx.removeStorage(key);}/** * 存储storage */export function setCache(key, value) { try { wx.setStorageSync(key, value) } catch (e) { }}/** 获取url参数 */export function getUrlParam(path) { var result = {}, param = /([^?=&]+)=([^&]+)/gi, match; while ((match = param.exec(path)) != null) { result[match[1]] = match[2]; } return result;}/** 数组是否包含某个字符串 */export const carrContainStr = (a, obj) => { for (var i = 0; i < a.length; i++) { if (a[i] == obj) { return i; } } return -1;}/** 克隆 */export const clone = (obj) => { // Handle the 3 simple types, and null or undefined if (null == obj || "object" != typeof obj) return obj; // Handle Date if (obj instanceof Date) { var copy = new Date(); copy.setTime(obj.getTime()); return copy; } // Handle Array if (obj instanceof Array) { var copy = []; for (var i = 0, len = obj.length; i < len; ++i) { copy[i] = clone(obj[i]); } return copy; } // Handle Object if (obj instanceof Object) { var copy = {}; for (var attr in obj) { if (obj.hasOwnProperty(attr)) copy[attr] = clone(obj[attr]); } return copy; } throw new Error("Unable to copy obj! Its type isn't supported.");}/** 判断机型 */export const isiOS = () => { var u = navigator.userAgent; var isAndroid = u.indexOf('Android') > -1 || u.indexOf('Adr') > -1; //android终端 var isiOS = !!u.match(/\(i[^;]+;( U;)? CPU.+Mac OS X/); //ios终端 if (isiOS) { return true } return false;}
七、vuex
这块我就不细说了,大家可以参考下面的进行在项目里进行配置
vuex官网
VueJS中学习使用Vuex详解
vuex的简单介绍
我对vuex的理解(二) 之 mapGetters取值和mapMutations的传参
八、分装网络请求
可以看一下我的下一篇文档小程序中使用flyio封装网络请求
至此特别感谢一斤代码
-------->一斤代码的简书,他写了很多mpvue小程序的文档,从搭建到使用,写的很详细,大家可以去学习观摩一下?。
原著是一个有趣的人,若有侵权,请通知删除
还没有人抢沙发呢~