无痛的微信小程序开发体验

weapp-starter

微信小程序开发无痛体验

项目地址

为什么会有这个 repo

在小程序之初便开发应用了,现在小程序的开发也越来越成熟了,完善了很多的API、组件、架构等,社区也由原来的零星点点到现在的不大不小,但也算是有了,期间也诞生了很多的开发框架,越来越多的三方辅助库,我也捣鼓出很多。比较有名的算是 wepy 和 labrador , wepy是 vue 风格的小程序开发框架, labrador 则比较亲和 React ,各有千秋,也各有深坑,而labrador 作者目前已经停止更新了 TnT,作为React深度使用者的我来说是忧伤的,于是我捣鼓出 wn-cli 来用类 React 快速开发微信小程序,然而在这个过程中,想了很多,为什么需要开发框架呢?小程序本身在一开始就强调框架,且现在做的也不差,后来总结了下,无非是不熟悉小程序这套框架,但学习新的中间框架去开发小程序,这不是更加加大了熟悉成本吗?且出了问题增加了处理的代价。

于是,我重新思考了下,最佳的微信小程序开发实践应该是无痛的,且舒服的,无痛的是指在小程序的飞速发展变更中,我们不用重复的浪费学习第三方框架和原生框架。舒服的是指,我们能用上我们熟悉的流行工程流,如:less 预编译、async/await 异步请求,redux数据管理等。

以上,便是这个 repo 的意义与原因。

设计概要

  • [x] 优化小程序 API
    1. Promise 化异步接口
    2. 突破请求数量限制(队列)
  • [x] 使用 async/await
  • [x] 接入 Redux 管理页面数据流
    1. 直接接入,添加可配置项
    2. 添加 saga 管理操作
  • [x] 样式书写采用 less 预编译
    1. 使用 Gulp 管理自动编译,持续集成
  • [x] wxs 管理工具库
    1. 数据的格式化操作,如时间格式化、金币格式化等
  • [x] 按需加载,子页面分包(除却 tab 页面的其他页面)
    1. 按功能模块分包加载(推荐)
    2. 按 tab 分包
    • ps: 小程序 原生分包
  • [x] 资源自动化管理
    1. 上传 CDN

Promise 化异步接口

由于微信的API中异步接口都是有三个回调函数的,分别是 success , fail , complete,执行时机同字面上意思( complete 一定会在接口的最后执行)。于是 结合 Promise ,简单的描述如下:(以下为简版,具体的可以看源码)

原生微信小程序API:

wx.request({
  // ... 其他一些配置项
  success: () => {},
  fail: () => {},
  complete: () => {}
});

添加 Promise 后:

new Promise((resolve, reject) => {
  wx.request({
    // ... 其他一些配置项
    success: resolve,
    fail: reject,
    complete: resolve, // 这里暂取 resolve 来解决
  });
});

Promise 化后,使用起来就简单了:

wx.request({ /* ...一些配置项 */}).then(res => {
  console.log(res)
}, err => {
  console.error(err)
})

结合下面的 async/await 就可以更加方便的书写同步代码

使用 async/await

  1. 添加 babel :
yarn add babel-core
  1. 安装 env presets
yarn add babel-preset-env
  1. 使用 .babelrc
{
  "presets": [
    "env"
  ]
}
  1. 在 Gulp 中使用 babel
// install
yarn add gulp-babel

const babel = require('gulp-babel');
// ...
.pipe(babel())
// ...
  1. 添加 runtime ,在使用 async/await 的地方引入 ./src/utils/lib/runtime.js 文件,幸运的是这件事情在这个repo中的 Gulp 任务中自动处理了。

以上,便可以在微信小程序中使用 async/await 了。

样式书写采用 less 预编译

为什么选择 less ,因为简单方便,前端编译,轻量级。

注意:由于小程序本身的限制,在书写样式的时候,不要使用 less 的嵌套功能!

  1. 添加less 变量库等
// ...
.pipe(addLessImport({
      themePath: path.join(__dirname, './src/theme/index.less'),
      commomPath: path.join(__dirname, './src/app.less'),
    }))
// ...
  1. 编译
// ...
.pipe(less({
      paths: [path.join(__dirname, './src/theme')]
    }))
// ...
  1. 重命名样式文件,以便小程序识别
// ...
  .pipe(rename((path) => {
    path.extname = '.wxss';
  }))
// ...

资源自动化管理

  1. 目前接入腾讯云,监测 assert 文件夹,自动上传图片资源
  2. 根据配置自动生成 less 配置 config.less
gulp.src('src/theme/config.less', { allowEmpty: true })
    .pipe(file('config.less', `@cdn: ~'${config.cdn}';`))
    .pipe(changed('src/theme'))
    .pipe(gulp.dest('src/theme'))
  1. 使用
page {
  background-image: url('@{cdn}/index-bg.png');
  background-attachment: fixed;
}

项目地址

原创声明,本文系作者授权云+社区发表,未经许可,不得转载。

如有侵权,请联系 yunjia_community@tencent.com 删除。

发表于

我来说两句

0 条评论
登录 后参与评论

相关文章

来自专栏携程技术中心

干货 | 如何一步步打造基于React的移动端SPA框架

作者简介 喻珍祥,携程港澳研发高级经理,2004年接触互联网开发,见证前端开发从美工到全栈开发的全过程。2014年加入携程,主要负责永安旅游APP移动前端架构和...

42810
来自专栏编程微刊

js仿通知栏新消息实时推送更新效果

在最近的项目里面,用到websocket做消息推送,其中有这样的一个效果,在消息列表的模块,接收到很多条信息,展示在界面的是最近的十条接受到的消息,实时更新模块...

2173
来自专栏知晓程序

手把手教你用上微信小程序,看完必懂!

1222
来自专栏架构师之路

微信钱包中58到家首页为什么这么快

原文标题《前后端分离和模块化-58到家微信首页重构之路》【深度前端干货】 微信钱包内的58到家全新首页已经上线,感兴趣的同学们可以在微信中打开“我的->钱包->...

3107
来自专栏移动端开发

iOS Paros 连接在同一WIFI下的网络抓包

图文详解:    说说网络抓包,几天前的事了,想抓个包看看 某爱网(全名自己脑补)的数据,就上网找了一下抓包,以前经常抓接口,时间长了忘了。那时候也不是用苹果手...

27810
来自专栏Python爬虫与算法进阶

App爬虫思路

但是我觉得不够全,首先对于一般的HTTP和HTTPS协议,通过最基本的Fiddler和Charles就可以抓包,具体方法请Google。需要保证两点:App走代...

6072
来自专栏DeveWork

Customizer Library:主题“自定义”功能的WordPress类库

这里说的WordPress主题中的“自定义”功能实就是指的是“外观”-“自定义”那里。不过一些第三方主题可能没有这个功能,如果你想在这个“自定义”上想扩展多点,...

2017
来自专栏编程微刊

jedate-开始使用一款好用的时间插件

1903
来自专栏DeveWork

WordPress免插件仅代码实现文章归档模板 II

不多说了,本站目前使用的效果,可以到我的存档页一览,该方法来自zww,感谢原作者,在这之前,建议你: 1、你的博客存档页面地址后面的应该为/articles,而...

5278
来自专栏小文博客

Git:一款比付费主题更像是付费主题的WordPress免费主题

1902

扫码关注云+社区