前言
从接触小程序开始,到现在大大小小做了差不多有五六个小程序项目了,小项目的只有几个页面,大的项目有几十个页面。此篇文章是对之前项目的一个总结,项目的脚手架,开发框架和后期的优化是一个逐渐进化完善的过程,如果你打算开发小程序或者已经在开发小程序,相信这些经验对你会有一定的帮助。
脚手架
小程序开发者工具可以直接编写小程序的,但是开发工具就像武士手中的剑,多年磨炼,已经达到人剑合一了,突然换把武器,那势必影响杀敌效率,所以使用自己熟悉的开发工具还是很有必要的。
本人所在的公司基本都是中小型公司,项目开发周期都很短,前期的准备工作最多也就几天时间,所以自己去撸一套脚手架然后用于项目开发,难度比较大,在网上找优质的资源是最好的选择。
大佬justjavac的开源项目 微信小程序开发资源汇总,涵盖了大量的优质小程序开发资源,在此推荐一波。
当然,脚手架的选择也是视项目而定的,如果只有几个页面的项目,搞一套很重的工具未免有点画蛇添足了。我们的做法是小项目,直接撸,大点的项目选用网络上的优质资源+自己改写。
- 17年的电商项目,模块不多,采用的脚手架比较简单,使用gulp监听文件改动,实时编译,支持ES6+语法。
- 18年中旬的电商项目,到了新的公司,当时选用了WePY进行开发,特性简单介绍下:
- 类Vue的开发风格
- 组件化开发(WePY出来的时候,小程序还不支持组件)
- 支持加载外部NPM包(小程序原生也支持)
- 使用babel编译,支持ES6/7的语法
- 针对原生API进行优化
详细介绍请点击WePY文档进行查看,后续框架选择上也会提到,差点被这框架害惨了。
- 最近的一个地产项目,也是下一个项目打算使用的,weapp-start,上文提到的小程序开发资源汇总中也有提到,特性如下:
- 支持 npm 包引入
- 支持 promise, async/await 等最新语法
- 支持多种编译器,如 pug/less/stylus
- 支持 ESlint
- 支持本地 mock 数据
- 支持一键生成项目,组件模版
- 支持发布前资源压缩
- 支持自定义插件
- 多种工具,加速开发
项目的地址为weapp-start,其中weapp-plugin-require(分析依赖,导入第三方 npm) ,存在问题,window操作系统会出现路径错误,我已修复,并给作者提了PR,但作者并没有修复这个问题,如果有同学要用到这个脚手架,请下载我修改好的文件进行替换,下载地址。
另推荐我根据weapp-start搭建的环境,目录结构为:
├── README.md // 说明文档
├── dist // 编译后的代码,用小程序开发工具打开此文件夹
├── mock.js // 模拟数据的文件
├── package-lock.json
├── package.json
├── project.config.json // 项目配置文件
├── src // 项目代码都在这个文件夹下
│ ├── app.js // 等同于小程序根目录下的app.js
│ ├── app.json // 等同于小程序根目录下的app.json
│ ├── app.wxss // 等同于小程序根目录下的app.wxss
│ ├── assets // 项目中使用到的静态资源
│ │ └── images
│ │ ├── example
│ │ └── tab
│ ├── components // 公用的组件
│ ├── page // 存放小程序的各个页面文件
│ │ ├── example // example 页面
│ │ │ ├── components // example页面中的组件
│ │ │ ├── index.js
│ │ │ ├── index.json
│ │ │ ├── index.wxml
│ │ │ ├── index.wxss
│ │ │ ├── services // example页面中接口
│ │ │ ├── template // example页面中的模板
│ │ │ └── wxs // example页面中的wxs文件
│ │ ├── globalStore.js // 全局共享的数据
│ │ └── test
│ │ ├── index.js
│ │ ├── index.json
│ │ ├── index.wxml
│ │ └── index.wxss
│ ├── template // 公用的模板
│ └── utils // 公用的方法或工具
│ ├── config.js // 全局的一些配置信息
│ ├── create.js // 状态管理插件
│ ├── mitt.js // 状态管理插件
│ ├── obaa.js // 状态管理插件
│ ├── util.js // 公用方法
│ ├── wxRequest.js // 封装的小程序请求数据方法
│ └── wxapi.js // 对小程序api进行Promise封装
└── weapp.config.js // 对脚手架的配置文件
复制代码
项目地址为点击查看,觉得有用的请Star或者fork哟。
当然,网上也有很多优秀的脚手架,大家可以根据自己的需要选择哟。
小程序开发框架
17年的项目并没有使用开源的框架,直接使用原生小程序写的,开发过程印象中并没有很多的坑,只记得当时用到了一个富文本的插件,wxParse,现在已5000多个Star了,虽然现在小程序有了富文本组件rich-text,但在最近的项目中还是用了这个插件,因为后端的兄弟说,他们不能将html转成rich-text需要的数据格式,后端是java的,有使用这个组件的同学,麻烦下面留个言,我要去鄙视后端一下。
前文提到自己在项目开发过程中使用过WePY框架,那么下面我就简单列一下现在比较火热的三大小程序框架WePY,mpvue和Taro的特性,然后着重说下WePY:
- mpvue(美团)
- 彻底的组件化开发能力:提高代码复用性
- 完整的 Vue.js 开发体验
- 方便的 Vuex 数据管理方案:方便构建复杂应用
- 快捷的 webpack 构建机制:自定义构建策略、开发阶段 hotReload
- 支持使用 npm 外部依赖
- 使用 Vue.js 命令行工具 vue-cli 快速初始化项目
- H5 代码转换编译成小程序目标代码的能力
- taro (京东)
- React 语法风格
- 支持使用 npm/yarn 安装管理第三方依赖。
- 持使用 ES7/ES8 甚至更加新的 ES 规范,一切都可自行配置。
- 持使用 CSS 预编译器,例如 Sass 等。
- 持使用 Redux 进行状态管理。
- 持使用 Mobx 进行状态管理。
- 程序 API 优化,异步 API Promise 化等等。
- WePY (腾讯)
上文已列出,此处不再赘述
三大框架分别是国内三家大佬的前端团队产物,印象中mpvue和taro都是18年下半年出来的,WePY出来的最早,几乎和小程序同步。
mpvue拥抱了vue,taro拥抱了react,WePY握住了vue的手,mpvue和taro都没有用过,我们只是开发个小程序,不用做到H5和RN共用一套代码,所以18年中开发的一个电商小程序选择了WePY,毕竟腾讯的产物,亲儿子。
后来了解到,是腾讯的儿子没错,不过是养子,WePY本来是腾讯内部一员工的个人项目,后来腾讯团队看这个项目不错,就由官方来维护了,由此带来了一些问题,曾在掘金看到过对WePY作者的专访(好像是专访,文章我找不到了),作者自己也承认,WePY前期的一些核心代码存在的缺陷,后期很难修复了,像脏检查机制,据说2.0会有很大的改变。
贴一张WePY其中的一个Issue,我们当时的心情和他是一样一样的,不过我们不用重构了,项目死掉了,哈哈哈哈(悲凉的笑)
自己曾经写过一篇wepy+weappx开发小程序遇到的坑以及解决方案,文中列举了开发过程中遇到的一些问题和解决方式,在此就不赘述了,想了解的同学可以点击查看。
如果你要问我开发小程序选择那个框架合适?我只能给出一个建议,根据需求来定,如果只是单纯的想做个小程序,就不要用框架了,小程序的语法目前已经很完善了,何必要去学习两套语法呢,出了问题,又改不动他们框架,一句话概括下就是,小程序原生有的问题他们肯定有,原生没的问题,他们可能给你造出来。
当然,如果有写一套代码适用H5和RN,那么可以考虑下mpvue和taro,作者更新很频繁,有团队维护,至于能不能提高效率,还得看需求,我们现在是不会选用任何框架了,小程序已经玩的很熟,没必要再折腾了。
小程序开发建议
在开发过程中,我们总结了一些感觉比较好的开发实践,在此奉献一波,大佬别笑哈。
- 目录结构
上文中脚手架第三项中贴出的目录结构,是目前我们觉得比较好的一种形式(参照umi项目的建议),按页面组织代码,将一个页面所需要的内容放在同一个文件夹,方便日后的维护和有类似页面开发时候的复制,存在公用组件的时候,放到外部的文件夹中,当一个项目大了以后,这种目录结构,真的很方便。
- 组件的层级
组件的层级真的不能太深,2层最好,不能超过3层,之前项目有的封装组件过度,层级太深,后期维护,根据数据传递一层层的去找代码,简直不要太爽(反话)。
- 状态管理
目前小程序能用的状态管理框架也是比较多的,Redux,Mobx,还有基于Redux二次开发的像weappx,都很好,在这推荐两个自己用过和打算用的,使用过的weappx,打算用的omi-mp-create,项目比较小可以不用,大项目还是用上吧,都放到global中,不好维护。
- 频繁setData的功能放到组件中
电商项目中,少不了类似倒计时这种功能的,像这种需要频繁setData操作的功能,应该单独放到一个组件中,为啥呢?当你setData的时候,小程序会有一个遍历监听了data数据方法的过程,比如当你setData的时候,小程序wxs中的函数都会执行,在我上文提到自己的脚手架中有这个例子weapp-quick-start,感兴趣的可以测试一下。
- 使用WXS
小程序对js表达式的支持并不是很好,当然,就算可以,我也曾见过这样的代码
<block wx:if="{{drawgift.giftDetail.virtualGoods.length>1||((drawgift.giftDetail.realGoods.length>0||drawgift.giftDetail.couponGoods.length>0)&&drawgift.giftDetail.virtualGoods.length>0)}}">
复制代码
把这些判断的逻辑放到wxs中,统一维护岂不是美哉。还有一点,官方说在 iOS 设备上小程序内的 wxs 会比 javascript 代码快 2 ~ 20 倍,所以,能用还是要用起来的。
- 控制包的大小,分包加载等
不用的包,别偷懒,统统删掉,至于分包加载等,推荐看下这篇文章,我就不啰嗦了微信小程序:一些运行细节及针对性的优化策略
结语
文章中涉及到的具体的技术点不多,更多的是对走过的路的一种回顾,觉得有帮助的童鞋,点个?哟!