微信小程序开发实践

243 阅读7分钟

项目是否适合移植到小程序上?

小程序由于微信提供了一些组件,在微信中的一些体验确实不错,对于开发来说,由数据驱动的开发模式也是挺爽的。

概要介绍

其实就是类似于VUE REACT的 MVVM模式,专注于数据和逻辑。 小程序开发框架的目标是通过尽可能简单、高效的方式让开发者可以在微信中开发具有原生 APP 体验的服务。

框架提供了自己的视图层描述语言 WXML 和 WXSS,以及基于 JavaScript 的逻辑层框架,并在视图层与逻辑层间提供了数据传输和事件系统,可以让开发者可以方便的聚焦于数据与逻辑上。

官网:微信小程序开发教程 官方:微信小程序联盟 视频:快速入门

模板层级 请求包装 用户会话处理

实践得到的经验

规则

1.目前打包后的文件不能超过2M,否则不能上传到微信服务器。

小程序不支持的

1.不支持sass语法 2.不支持window、document,不能使用相关的库,如jquery、PreventMoveOverScroll。

3.不支持直接使用svg标签开发。image的src放远程svg可以,background-image里也可以。 但是可以使用的canvas标签*(canvas坑:position absolute的层盖不住canvas)*,可以使用的库:wx-charts (有坑,放在app.js中然后在page中引用的话,找不到ringChart上面的函数,如ringChart.addEventListener。要直接在page中引库。)。 wx-charts 横向铺满的话,需要在外层放一个view,然后给canvas一个width 100% 的 style(不是属性 width)。链接

4.不支持阻止默认事件,没有preventDefault。 5.没有br标签。 6.不支持table表格。 7.不能使用 来增大文字间距。 8.小程序的xxx.wxss文件font-face的url不接受http地址作为参数,可以接受 base64 ,因此可以先将字体文件下载后,转换为base64,然后再引用。链接

新特性

1.img标签换成了image标签<image src="http://sfe.ykt.io/o_1bbd2f7j02583ii2rg1p441gvo9.jpg"></image>。 2.text标签认\n换行,不能包裹<br/>标签,会直接输出出来,有点类似textarea。 3.小程序中 :nth-child(n) 是从0开始的。 4.switch标签。但是不能改变大小样式,像老radio标签一样讨厌。 5.picker标签。但是在开发者工具中选项不会循环,在安卓手机预览中选项会循环。

6.scroll-view标签。有滚动条的盒子。要想在进入页面的时候自动滚动到某处,可以使用scroll-view的scroll-into-view属性,不过一定要在scroll-view存在后设置才会生效,尤其是通过template引用的时候,比如同时通过setData设置使用该template和scroll-into-view的值,并不会使滚动生效。

7.关于屏幕下拉露底:Android不会,iPhone会。可以通过配置解决:disableScroll Boolean false 设置为 true 则页面整体不能上下滚动;只在page.json中有效,无法在app.json中设置该项。链接

8.template标签 模板的作用域:模板拥有自己的作用域,只能使用data传入的数据。

9.在功能按钮上使用catchtap防止冒泡

10.hidden参数,控制蒙版的利器

小窍门

1.关于下拉刷新 要在page.json中设置 enablePullDownRefresh: true onPullDownRefresh内要手动stopPullDownRefresh,否则一直在点点点(loading)。

2.page的onload函数中有参数options可以获取路径的query

3.小程序的支付和微信的支付不是一个appid,需要后端新开发下单接口

4.wxml最好在开发者工具编辑(有提示)。js, wxss可以在熟悉的编辑器编辑。

5.小程序中如果赋予的新值是undefined的话,根本不会进行赋值,也不会覆盖之前的值。如:

app.setData({
    isPaperCollected: finishedQuizList['id'+quizID] || false
})

6.通过多次使用Object.assign({}) 解决data也模块化后data不能深层复制的问题。 Object.assign不是深层复制。

7.在微信web开发者工具中一定要在动作->设置->勾上“不使用任何代理,勾选后直连网络”,否则老是报“ Failed to load resource: net::ERR_NAME_NOT_RESOLVED”的bug:链接

8.每一个小程序页面也可以使用.json文件来对本页面的窗口表现进行配置。 页面的配置比app.json全局配置简单得多,只是设置app.json中的window配置项的内容,页面中配置项会覆盖app.json的window中相同的配置项。页面的.json只能设置window相关的配置项,以决定本页面的窗口表现,所以无需写 window 这个键。链接

9.data是在page中设置的,不是在app.js中的。不涉及渲染的可以不要放data里面。

10.Page.prototype.setData()变更数据同时更新页面数据。 setData 函数用于将数据从逻辑层发送到视图层,同时改变对应的 this.data 的值。直接修改 this.data 无效,无法改变页面的状态,还会造成数据不一致。单次设置的数据不能超过1024kB,请尽量避免一次设置过多的数据。

11.wx:if 是惰性的,如果在初始渲染条件为false,框架什么也不做,在条件第一次变成真的时候才开始局部渲染。 12.给标签添加 display 属性会导致 hidden 失效。 13.使用子组件的页面的钩子函数或方法中的 this 和普通页面的 this 不一样,比如 this.setData 就是 {writable: false, enumerable: false, configurable: false, value: ƒ..} , 如果要重置 setData 方法的话(如国际化),就需要对这种情况特殊处理下:

/**
 * 在小程序中,使用子组件的页面, this.setData configurable 和 writable 都是 false
 * 所以不能负载 setData 方法,只能另起一个函数名,这里用了 setComData,
 * 另外,由于在 langData.js 中 setTransData 方法调用的是 setData,
 * 所以,另外给使用子组件的页面,定义了个 setComTransData 方法,去调用 setComData
 */
let isUsingComponents = !self.__proto__.hasOwnProperty('setData') && self.__proto__.__proto__.hasOwnProperty('setData')

let _ = self.setData

if (!isUsingComponents) {
  self.setData = function(data, isSetTrans = false){
    _.call(self, data)
    if (isSetTrans) {/* 阻止翻译循环调用 setData  */return;}
    langData.setTransData && langData.setTransData.call(self)
  }
} else {
  self.setComData = function(data, isSetTrans = false){
    _.call(self, data)
    if (isSetTrans) {/* 阻止翻译循环调用 setData  */return;}
    langData.setComTransData && langData.setComTransData.call(self)
  }
}

14.setData 中有 undefined 字段的话,真机中的警告信息为null

会话管理

微信的网络请求接口 wx.request() 没有携带 Cookies,这让传统基于 Cookies 实现的会话管理不再适用。为了让处理微信小程序的服务能够识别会话,我们会话管理使用weapp-session-client。这需要服务端的支持。基本原理是包装wx.request并在 Header 上使用特殊的字段跟踪。

使用时遇到的问题: 1.微信开发者工具报错:Uncaught ReferenceError: regeneratorRuntime is not defined 原因是 Generator 函数不被支持。 解决方法:

  • 微信开发者工具关闭ES6转ES5
  • 真正解决办法,提供regeneratorRuntime 链接1 -- 链接2

2.题外话:善用 Promise 本项目后端处理会话管理时要求发送请求时不能使用相同的 X-WX-Code发送多次全部header数据,RawData、Signature等,否则报错。 所以使用weapp-session-client登录的时候要等login返回之后再发送其他的请求, 小程序加载后立即顺序执行app.js和page.js里面的配置,但是wx request是异步的,所以有可能page中的请求开始执行时app.js中的login还没结束,就会导致bug。 可以使用个promise解决掉。

进阶

1.扩展微信小程序框架功能

2.疑问:微信切换账号会不会销毁小程序

3.检查TLS版本的问题 www.dongcoder.com/detail-4106… 解决方法:微信开发者工具勾选开发时不检查检查TLS版本或后端配置

4.蓝牙、震动的调用

5.蒙版处理 习题相关蒙版:属于主动控制类蒙版,可能会有一级、二级蒙版盖上,不会同时有3级蒙版盖上(如缩略图) 直接发送蒙版 点击屏幕返回回页面 按钮进入柱状图 选择时间按钮蒙版 点击屏幕返回页面 按钮进入柱状图 柱状图蒙版 返回页面 查看详情蒙版 返回 柱状图蒙版 进一步课堂红包蒙版版 不赏返回页面(可以改成返回柱状图) 打赏确认支付蒙版 支付中、支付成功、失败蒙版 红包名单页面

试卷相关蒙版:主动控制类蒙版 试卷的选择页蒙版 返回页面 试卷历史发布 返回选择页 试卷答题情况蒙版中 根据来路返回历史发布或选择页(查看历史发布则返回历史发布,新发布则返回选择页) 试卷答题详情 返回答题情况页 刷新、定时器的关系