开发者社区
社区提问意见反馈
开发者钉组织
扫描二维码
加入支付宝开发者钉组织
了解支付宝开放能力最新动态
和同城同行业凯发k8官方网娱乐官方的合作伙伴交流业务
与开放平台产研团队沟通
文档中心
小程序 
框架概述
目录结构
native 渲染
性能与优化
小程序全局配置
acss 语法参考
小程序页面
axml
sjs 语法参考
事件系统
自定义组件
基础能力
基础库
基础库介绍
基础库 2.x 升级
基础库更新日志
小程序的 javascript 引擎
小程序场景值
场景值列表
兼容
开发 > 框架 > 基础库 > 基础库介绍
收藏
订阅更新
我的文档
设置
基础库是负责小程序框架的加载的容器，提供小程序框架需要的标准组件和标准 api 接口。
基础库与客户端的关系
小程序能力需要支付宝客户端来支撑，每一版基础库新增能力都需要特定版本以上客户端才能运行，高版本基础库的某些新能力无法兼容低版本客户端，关于基础库兼容方法，可参见 兼容 文档。
通过 my.sdkversion 查看当前基础库版本号。
基础库更新时机
当基础库准备更新时，会在客户端内进行逐步灰度直到全量发布。 新版本发布后一般会在 1~2 星期内覆盖 98% 以上的用户，查看 更新日志。 当用户客户端更新至最新基础库后，小程序就会运行在最新的基础库上。
随着基础库的不断更新，老版本客户端不支持的能力越来越多，所以基础库支持范围有一个最低客户端版本的要求，即部分老版本客户端以后将无法更新到最新的基础库，会停留在某一历史版本。例如，如果用户的支付宝客户端版本是 1.0.0 版本，那么基础库最多更新到 1.1.0，详情可查看 v1.x 版本。
基础库版本分布
当前小程序基础库存在 1.x 和 2.x 版本，在新版本客户端上同时存在，详情可查看 基础库 2.x 升级，对应的版本分布如下：
v2.x
更新时间：2024 年 12 月 26 日。
- 代表此版本占比低于 0.01%。
基础库版本
用户占比
支付宝客户端最低版本
>=2.9.69
98.86%
10.1.92
2.9.65
0.72%
10.1.92
2.9.63
0.06%
10.1.92
2.9.61
0.04%
10.1.92
2.9.59
0.14%
10.1.92
2.9.57
-
10.1.92
2.9.55
-
10.1.92
2.9.54
-
10.1.92
2.9.53
-
10.1.92
2.9.41
0.01%
10.1.92
2.9.39
-
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
-
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.15%
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 版本
​
 上一篇：分包异步化下一篇：基础库 2.x 升级 
相关问题
内容没有解决您的问题？您还可以前往 或 寻求帮助
凯发k8官方网娱乐官方 copyright © 2022 支付宝（杭州）信息技术有限公司  | icp证浙b2-20160559
该文档对你是否有帮助？
当前页面目录
网站地图