MPVue 开发小程序的通用能力封装
Promisify 的 wx API
import { wxp } from 'common-mpvue';
wxp.request({ ...config }).then(resp => {
// do something
});可持久化至小程序 storage 的 VueStore
import { PersistStore } from 'common-mpvue';
const store = new PersistStore(storageKey, {
...storeOptions
});Emitter
方便不同页面间通信，为保证同一个 emitter 实例，请通过getApp().emitter获取这个绑定在 app 下的 emitter 实例
const app = getApp();
// 添加监听
app.emitter.on('event1', function() {});
// 添加一次性监听
app.emitter.once('event1', function() {});
// 移除监听
app.emitter.off('event1', listener);
// 移除全部监听
app.emitter.offAll('event1');Navigator
解决了页面栈过大时无法跳转的问题，自动使用redirectTo替代navigateTo
const app = new App();
app.nav.navigateTo('/pages/index/index', { param1: '1' });
app.nav.navigateToH5('https://example.com');
// 注意配置小程序webview页面 /pages/webview/webviewUtilities
提供少量的实用方法
const app = getApp();
// 给url添加query参数
app.utils.addUrlQuery('/pages/index/index', { param1: '1' });
// => /pages/index/index?param1=1
// 解析url的query为对象
app.utils.parseUrlQuery('/pages/index/index?param1=1');
// => {param1: 1}Request
提供了封装的 Request 对象，适度的请求队列管理，建议使用wx.httpRequest或wxp.httpRequest这个绑定在全局变量下的固定实例
wx.httpRequest.httpGet('https://example.com', { param1: '1' });
// json形式post
wx.httpRequest.httpJsonPost('https://example.com', { data1: '1' }, { ...requestOptions });
// form表单形式post
wx.httpRequest.httpFormPost('https://example.com', { data1: '1' }, { ...requestOptions });
// httpPost等同httpFormPost
wx.httpRequest.httpPost('https://example.com', { data1: '1' }, { ...requestOptions });为了减少重复填写配置，可以重新实例化一个有固定配置的请求实例
// 配置请求携带token并以cookie形式传递
const httpRequest = wx.httpRequest
.auth()
.cookieToken()
.form();
httpRequest.GET('https://example.com');
httpRequest.POST('https://example.com', { data1: '1' });目前支持如下配置链
- auth - 携带 token 用于鉴权，auth(true)
- tokenKey - 携带 token 的 key，tokenKey('key')
- headerToken - 通过 header 携带 token
- cookieToken - 通过 cookie 携带 token
- qsToken - 通过 url query 携带 token
- form - 通过 form 表单形式 post
- custom - 携带自定义 header 头，包含设备信息等
按照约定优于配置的原则，推荐数据接口有统一约定的响应
推荐格式
{
code: 200, // 标记本次响应状态，200为成功，当API不论错误还是异常均是以200的http status响应时，通过此code标记实际的响应status是必要的
loginCode: 200, // loginCode可选，当登录态失效时返回非200的loginCode，方便库清理本地登录状态以引导重新登录
message: "", // 错误时推荐返回非空message，便于promise catch
data: {
posts: [],
total: 100
}
}说明
为了将这些能力引入到 app,wx,wxp 等对象上，需要按如下操作：
入口 main.js
import { wrap } from 'common-mpvue';
import App from './index.vue';
wrap(App, appConfig, appProps);
wrap的签名如下
/**
* 封装和扩展小程序app实例以及wx
* @param App 入口的Vue组件
* @param config app配置
* @param props 给app实例扩展更多的方法或属性
*/
wrap(App, config: AppConfig, props?: BaseKV)
interface AppConfig {
// 小程序名称
name: string;
// 小程序版本
version: string;
// 小程序工程package.json中的name
pkgName: string;
// 开发环境
env?: 'production' | 'development';
// api域名
domain?: string;
// 使用app.logger可上报信息的API
reportDomain?: string;
// 用于展示H5的页面，例如/pages/webview/webview
webviewSchema?: string;
}页面 main.js
import { WrapPage } from 'common-mpvue';
import Page from './index.vue';
new WrapPage(Page);
// 或者为页面添加vuex store
new WrapPage(Page, {
state() {
name: '';
},
mutations: {
updateName(state, name) {
state.name = name;
}
}
});在页面的 vue 单文件组件内，可以通过this.$app访问小程序 app 实例，可以通过this.$store访问共享的业务 vuex store，可以通过this.$state访问该页面的状态模块