开发者社区
社区提问意见反馈
开发者钉组织
扫描二维码
加入支付宝开发者钉组织
native 渲染
性能与优化
小程序全局配置
小程序页面
axml
sjs 语法参考
事件系统
自定义组件
基础能力
基础库
基础库更新日志
开发 > 框架 > 基础库 > 基础库介绍
收藏
订阅更新
我的文档
设置
基础库是负责小程序框架的加载的容器,提供小程序框架需要的标准组件和标准 api 接口。
基础库与客户端的关系
小程序能力需要支付宝客户端来支撑,每一版基础库新增能力都需要特定版本以上客户端才能运行,高版本基础库的某些新能力无法兼容低版本客户端,关于基础库兼容方法,可参见 兼容 文档。
通过 my.sdkversion 查看当前基础库版本号。
基础库更新时机
当基础库准备更新时,会在客户端内进行逐步灰度直到全量发布。 新版本发布后一般会在 1~2 星期内覆盖 98% 以上的用户,查看 更新日志当用户客户端更新至最新基础库后,小程序就会运行在最新的基础库上。
随着基础库的不断更新,老版本客户端不支持的能力越来越多,所以基础库支持范围有一个最低客户端版本的要求,即部分老版本客户端以后将无法更新到最新的基础库,会停留在某一历史版本。例如,如果用户的支付宝客户端版本是 1.0.0 版本,那么基础库最多更新到 1.1.0,详情可查看 v1.x 版本
基础库版本分布
当前小程序基础库存在 1.x2.x 版本,在新版本客户端上同时存在,详情可查看 基础库 2.x 升级,对应的版本分布如下:
v2.x
更新时间:2024 年 09 月 18 日。
- 代表此版本占比低于 0.01%。
基础库版本
用户占比
支付宝客户端最低版本
>=2.9.55
97.50%
10.1.92
2.9.54
1.82%
10.1.92
2.9.53
0.24
10.1.92
2.9.41
0.25%
10.1.92
2.9.39
0.01%
10.1.92
2.9.38
-
10.1.92
2.9.35
-
10.1.92
2.9.32
-
10.1.92
2.9.29
-
10.1.92
2.9.28
0.01%
10.1.92
2.9.25
-
10.1.92
2.9.23
-
10.1.92
2.9.21
-
10.1.92
2.9.19
-
10.1.92
2.9.17
-
10.1.92
2.9.14
0.01%
10.1.92
2.9.13
-
10.1.92
2.9.11
0.02%
10.1.92
2.9.9
-
10.1.92
2.9.7
-
10.1.92
2.9.5
-
10.1.92
2.9.3
-
10.1.92
2.9.1
-
10.1.92
2.8.23
-
10.1.92
2.8.21
-
10.1.92
2.8.19
-
10.1.92
2.8.17
-
10.1.92
2.8.15
-
10.1.92
2.8.12
-
10.1.92
2.8.11
-
10.1.92
2.8.10
-
10.1.92
2.8.9
-
10.1.92
2.8.8
-
10.1.92
2.8.7
-
10.1.92
2.8.6
-
10.1.92
2.8.5
-
10.1.92
2.8.4
-
10.1.92
2.8.3
-
10.1.92
2.8.2
-
10.1.92
2.8.1
-
10.1.92
2.8.0
-
10.1.92
2.7.24
-
10.1.92
2.7.23
-
10.1.92
2.7.22
-
10.1.92
2.7.21
-
10.1.92
2.7.20
-
10.1.92
2.7.19
-
10.1.92
2.7.18
-
10.1.92
2.7.17
-
10.1.92
2.7.16
-
10.1.92
其它
0.14%
10.1.92
v1.x
更新时间:2021 年 12 月 13 日。
基础库版本
用户占比
支付宝客户端最低版本
>=1.25.4
99.18%
10.1.75
1.25.3
0.02%
10.1.75
1.25.1
0.02%
10.1.75
1.24.13
0.74%
10.1.75
其它
0.04%
-
设置最低基础库版本
登录 > 进入小程序详情页 > 小程序信息 > 基础设置,可设置小程序的最低基础库版本。若小程序用户使用的基础库版本低于设置的最低版本要求,则无法正常使用小程序,并将提示用户更新支付宝版本。设置版本号后,小程序需重新发版才会生效。
注意:请确保已完成 基础库 2.x 升级,才能将最低基础库版本号设置为基础库 2.0 对应的版本号,否则在真机上会一直提示升级支付宝版本。

点击 最低基础库版本 对应的 设置 按钮,可看到不同的最低基础库版本对应的受影响用户 uv 占比,即近 30 天内访问小程序的用户的基础库版本小于所选版本的占比。开发者可据此设置小程序的最低基础库版本。
选中需设置为最低基础库版本的版本号,点击 确定 按钮,即设置成功。

此时,最低基础库版本 设置项对应的状态变为 已设置

常见问题
q:如何更新基础库版本?
a:没有 api 去执行更新的,是根据支付宝客户端版本来更新的。
q:如何切换 ide 使用的基础库?
a:支付宝小程序 ide 从 2.9 版本开始,支持切换运行的基础库版本。若要切换基础库版本,请点开模拟器顶部的四叶草设置菜单,点击 设置,便可以选择基础库版本进行模拟运行。注意:使用该功能需要保持网络通畅。

相关文档
兼容
v1.x 版本
内容没有解决您的问题?您还可以前往 或 寻求帮助
凯发k8官方网娱乐官方 copyright © 2022 支付宝(杭州)信息技术有限公司  | icp证浙b2-20160559
该文档对你是否有帮助?
当前页面目录
网站地图