网站首页 » 记录 » 小程序基础版本的选择

小程序基础版本的选择

December 31, 2020 记录

### 为何关注小程序的基础库?
小程序的运行环境分为渲染层和逻辑层,渲染层和逻辑层都有基础库,一般提到基础库是包含渲染层和逻辑层的基础库。随着微信基础库的迭代升级,可能会新增功能、修复基础库的缺陷等等。在开发过程中使用的一些微信基础库API不一定老版本一定存在。
为了保证小程序的正常运行,需要设置小程序的基础版本。低于此版本的基础库,小程序将不可用;使用高于基础库版本的API,需要做兼容降级。
### 微信基础库版本的分布情况
微信有官方的基础库版本的分布情况,每日将会更新分布情况,见链接https://developers.weixin.qq.com/miniprogram/dev/framework/client-lib/version.html

### 如何判断该使用哪个版本的基础库?
**这里建议两个维度进行判断**:

1. 根据基础库分布情况,选定一个基础库版本的候选名单
2. 统计小程序待实现功能,调用的微信基础库的API的最低版本的分布情况

以此两个维度合理取一个基础库版本。

某小程序选择了2.10.4的版本作为基础库。截止2020年12月22日,小程序基础库版本大于等于2.10.4的版本总体占比为98.47%,如图所示
### 小程序API降级兼容方案
当选择了基础库版本后,若是使用了超过基础库版本的API,那么需要做兼容方案。兼容方案可以参考微信官方文档,这里做简要概述

1. 对比版本号,若是当前微信客户端的小程序基础版本小于API所要求的版本,那么不调用该方法,并做相应提示
2. 对于新增的API,可以通过判断该API是否存在来判断是否支持用户使用的基础库版本
3. 使用wx.canIUse 判断该方法是否在当前的基础库中可用,但要注意wx.canIUser的基础库版本要求是1.1.1,若是基础库小于1.1.1那么也需要使用前两种方式进行判断

### 小程序后台设置
在小程序后台的设置页面,设置基础库最低版本,选定最低版本后,若用户使用的基础库版本低于设置的最低版本要求,则无法正常使用小程序,并会提示用户更新微信版本。这是由微信支持的功能,此功能仅在?iOS 6.5.8 / 安卓 6.5.7 及以上版本微信客户端支持。根据11月5日基础库版本的占比,低于iOS6.5.8和安卓6.5.7的总体占比不足0.02%