支付宝小程序框架 基础库
基础库是负责小程序框架的加载的容器,提供小程序框架需要的标准组件和标准 API 接口。
基础库与客户端的关系
小程序能力需要支付宝客户端来支撑,每一版基础库新增能力都需要特定版本以上客户端才能运行,高版本基础库的某些新能力无法兼容低版本客户端,关于基础库兼容方法,可以查看 兼容 文档。可以通过 my.SDKVersion 查看当前基础库版本号。
基础库更新时机
当基础库准备更新时,会在客户端内进行逐步灰度直到全量发布。当用户客户端更新至最新基础库后,小程序就会运行在最新的基础库上。
随着基础库的不断更新,老版本客户端不支持的能力越来越多,所以基础库支持范围有一个最低客户端版本的要求,即部分老版本客户端以后将无法更新到最新的基础库,会停留在某一历史版本。例如,如果用户的支付宝客户端版本是 1.0.0 版本,那么基础库最多更新到 **1.1.0。
基础库版本分布
更新时间:2020 年 4 月 21 日
基础库版本 | 用户占比 | 支付宝客户端最低版本 |
---|---|---|
>=1.24.2 | 96.54% | 10.1.75 |
1.24.1 | 0.75% | 10.1.75 |
1.23.7 | 0.24% | 10.1.75 |
1.20.5 | 0.17% | 10.1.68 |
1.20.1 | 0.25% | 10.1.68 |
其它 | 2.05% | - |
设置最低基础库版本
从 开发中心 > 小程序应用 > 我的小程序,进入小程序详情页,点击左侧栏 设置,在 基础设置 栏,可设置小程序的最低基础库版本。若小程序用户使用的基础库版本低于设置的最低版本要求,则无法正常使用小程序,并将提示用户更新支付宝版本。设置版本号后,小程序需重新发版才会生效。
点击 最低基础库版本 对应的 设置 按钮,可看到不同的最低基础库版本对应的受影响用户 UV 占比,即近 30 天内访问小程序的用户的基础库版本小于所选版本的占比。开发者可据此设置小程序的最低基础库版本。
选中需设置为最低基础库版本的版本号,点击 确定 按钮,即设置成功。
此时,最低基础库版本 设置项对应的 状态 变为 已设置。
常见问题
Q:如何更新基础库版本?
A:没有API去执行更新的,是根据支付宝客户端版本来更新的。