01 Taro_Mall 开源多端小程序框架设计

Posted 2021-03-07 杰出D

项目介绍

Taro_Mall是一款多端开源在线商城应用程序，后台是基于litemall基础上进行开发，前端采用Taro框架编写，现已全部完成小程序和h5移动端，后续会对APP，淘宝，头条，百度小程序进行适配。Taro_Mall已经完成了 litemall 前端的所有功能

扫码体验

由于小程序没有认证，只发布了一个预览版，只能加15个人，如有需要，请点击小程序申请

小程序 h5移动端

项目架构

项目用Taro做跨端开发框架，Taro基本采用React的写法，项目集成了 redux dva 控制单向数据流，用immer来提供不可变数据，提升整体的性能，减少渲染。

初始化项目

taro init Taro_Mall

进入项目目录开始开发，可以选择小程序预览模式，或者 h5 预览模式，若使用微信小程序预览模式，则需要自行下载并打开微信开发者工具，选择预览项目根目录。

微信小程序编译和发布

yarn dev:weapp  // 编译预览
yarn build:weapp // 构建发布

h5编译和发布

yarn dev:h5  // 编译预览
yarn build:h5 // 构建发布

其它端可以查看package.json 提供的命令

到这里，我们已经把项目初始化完毕，接下来我们引入 dva-core 和 immer，引入dva-core包就可以，不需要引入dva包，dva 包是对 dva-core 和路由，请求库等做了一层封装

yarn add dva-core dva-imme --save

在src 目录下新建 dva.js 文件，文件内容如下, 在创建App的时候，我们把dva-immer插件引入其中。

import {create} from 'dva-core';
import {createLogger} from 'redux-logger';
// import createLoading from 'dva-loading';
import immer from 'dva-immer';

let app;
let store = {};
let dispatch;


function createApp(opt) {
  // opt.onAction = [createLogger()];  // 这里可以引入 redux-logger
  app = create(opt);
  // app.use(createLoading({}));
  app.use(immer()); // 引入 immer

  if (!global.registered) opt.models.forEach(model => app.model(model));
  global.registered = true;
  app.start();

  store = app._store;
  app.getStore = () => store;

  dispatch = store.dispatch;

  app.dispatch = dispatch;
  if (window) {
    window.g_app = app;
  }
  return app;
}

export default {
  createApp,
  getDispatch() {
    return app.dispatch;
  },
  dispatch: store.dispatch
}

接下来在入口文件当中引入我们的 dva 文件

import dva from './dva';
import models from './models';

const dvaApp = dva.createApp({
  initialState: {},
  models: models,
  onError(e, dispatch) {
    console.log('系统出错了!');
    // dispatch(action("sys/error", e));
  },
});
const store = dvaApp.getStore();

我们发现dva创建的时候需要引入models，我们在src目录创建models 来存放我们的 model 文件，来管理状态， 我们看下models 文件下的入口文件

import home from './home';
......

export default [
  home,demo, goods, catalog, search       // 导入我们的模块
]

我们可以写一个简单的model，例如: demo.js

import delay from '../utils/delay';

export default {
  namespace: 'demo',
  state: {
    list: [],
    counter: {
      num: 0,
    }
  },
  reducers: {
    add: (state, {payload}) => {
      state.counter.num ++;
    },

    dec: (state, {payload}) => {
      state.counter.num --;
    }

  },
  effects: {
    *asyncAdd(_, {all, call, put}) {
      yield call(delay, 2000);//增加延迟测试效果

      yield put({type: 'add'});
    },
  }
};

接下来，我们要在taro redux的中的Provider传入 store

<Provider store={store}>
        <Index />
 </Provider>

接下来对请求库做下简单的封装，这里主要封装了对错误消息和统一处理，和提供了get，post方法，如需其它方法，可自行封装

import Taro from '@tarojs/taro';
import {showErrorToast} from '../utils/util';


/**
 * 封封微信的的request
 */
function request(url, data = {}, method = "GET") {
  return new Promise(function(resolve, reject) {
    Taro.request({
      url: url,
      data: data,
      method: method,
      header: {
        'Content-Type': 'application/json',
        'X-Litemall-Token': Taro.getStorageSync('token')
      },
      success: function(res) {

        if (res.statusCode == 200) {

          if (res.data.errno == 501) {
            // 清除登录相关内容
            try {
              Taro.removeStorageSync('userInfo');
              Taro.removeStorageSync('token');
            } catch (e) {
              // Do something when catch error
            }
            // 切换到登录页面
            Taro.navigateTo({
              url: '/pages/auth/login/login'
            });
          } else if(res.data.errno == 0) {
            resolve(res.data.data);
          } else {
            // Taro.showModal({
            //   title: '错误信息',
            //   content: res.data.errmsg,
            //   showCancel: false
            // });
            showErrorToast(res.data.errmsg);
            reject(res.data.errmsg);
          }
        } else {
          reject(res.errMsg);
        }

      },
      fail: function(err) {
        reject(err)
      }
    })
  });
}

request.get = (url, data) => {
  return request(url, data, 'GET');
}

request.post = (url, data) => {
  return request(url, data, 'POST');
}

export default request;

现在我们基本就可以用我们熟悉的套路去做开发了

结束语

Taro 遵循 React 语法规范的 多端开发 解决方案。当业务要求同时在不同的端都要求有所表现的时候，针对不同的端去编写多套代码的成本显然非常高，这时候只编写一套代码就能够适配到多端的能力就显得极为需要。

github : Taro_Mall 如果对大家有帮助，请 star 一下