支付宝小程序框架 基础库

基础库是负责小程序框架的加载的容器，提供小程序框架需要的标准组件和标准 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去执行更新的，是根据支付宝客户端版本来更新的。