ludejun / wxapp-webpack

使用 webpack, scss, redux, vedux(redux绑定库), redux-thunk 开发的微信小程序项目脚手架

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

wxapp-vedux-webpack

使用 webpack, scss, redux, vedux(redux绑定库), redux-thunk 开发的微信小程序项目脚手架

实际使用中,最好去除lodash(新仓库已去除),减少包体积,可参考BundleAnalyzerPlugin分析结果

动态图片打包问题: wxml-loader并不能解析动态图片url引入,需要借助copy-webpack-plugin将图片直接copy打包,url配置在package.json的copyWebpack字段中

要使用云开发能力,可参考本人另一个demo:miniprogram-thirty

功能

  • 支持引用 node_modules 模块
  • 合成vedux库,使用类redux开发方式开发小程序
  • 异步action支持redux-thunk开发,也可以视实际情况删除
  • 合成BundleAnalyzerPlugin,实时分析包体积,为包体积提供可视化优化方向
  • 支持通过配置 alias 来避免 ../../../ 之类的模块引用
  • 通过 babel 支持更丰富的 ES6 兼容,包括 async/await
  • 使用 scss 编写 .wxss 文件,内置了一些有用的 mixinsextends
  • 提供 __DEV__process.env.NODE_ENV 全局常量辅助开发
  • 通过命令行快速创建微信小程序页面
  • 支持在 production 环境下压缩代码

vedux

wxapp-redux 微信小程序和redux绑定库,类react-redux。同npm包名,关于这个连接库详细设计和API请参考上面链接。

简介

wechat-weapp-redux的基础上改进,控制setdata次数与渲染次数,在页面的交互、加载、跳转时setdata次数减少50-80%,渲染时间减少约50%。

有如下功能特性:

  • Redux store变化时禁止后台页面setdata,后台页面的setdata汇总到此页面onload时进行;
  • 优化stateDiff算法;
  • 过滤与当前页面无关的变更;
  • 内部对action触发做节流处理,允许不节流,默认节流;
  • 支持给action传入callback,在action触发后执行;
  • connect的传参mapStateToData,支持传入options(即onLoad的options);
  • connect新增参数mergeProps(对mapStateToData的返回结果做进一步处理);
  • connect新增参数extraOptions(给mergeProps方法传参);

开始使用

确保安装了 Node.js (>= v4.2) 和 yarnnpm

  1. git clone 此项目
  2. 通过命令行工具 cd 到这个目录,执行 yarn 安装依赖模块
  3. 执行 yarn start 开始开发
  4. 通过微信开发者工具,添加 dist (开发环境)目录到项目上,生产环境为release文件夹;如项目复杂度不高,可以改为一个,修改webpack配置output即可

内置命令

  • yarn start 启动 webpack 开发微信小程序项目,能监听文件变化自动重新编译
  • yarn build 编译生成 production 环境的代码到 release 文件夹
  • yarn lint:build 执行 yarn build 命令,并使用 eslint 和 stylelint 来校验代码规范
  • yarn prettier 执行 prettier 来格式化 src 目录下的代码
  • yarn create-page 快速创建微信小程序页面(更多 create-page 的用法,请查看 create-wxapp-page

文件复制

如果 wxmlaxml 有动态引入文件(如 src="{{'images/' + type + '.png'}}"),webpack 将不能动态引入,因此会导致打包后可能会存在缺失文件问题。

遇到这种情况,可以通过 copy-webpack-plugin 解决,把整个 images 目录复制到 dist 下即可。

本脚手架已经内置这个插件。为了方便使用,还可以通过在 package.json 里增加一个 copyWebpack 的字符串数组,来实现目录或文件自动复制。例如:

package.json

{
  // ...
  "copyWebpack": ["images", "icons"]
}

通过执行 yarn startyarn buildsrc/imagessrc/icons 目录会自动复制到 dist/wechat/imagesdist/wechat/icons 目录(支付宝小程序同理)。

更新日志

相关项目

License

MIT

About

使用 webpack, scss, redux, vedux(redux绑定库), redux-thunk 开发的微信小程序项目脚手架


Languages

Language:JavaScript 74.6%Language:SCSS 25.4%