• 下载
  • 社区

基础库

基础库与客户端的关系


小程序能力需要支付宝客户端来支撑,每一版基础库新增能力都需要特定版本以上客户端才能运行,高版本基础库的某些新能力无法兼容低版本客户端,关于基础库兼容方法,可以查看 兼容 文档。可以通过 my.SDKVersion 查看当前基础库版本号。


基础库更新时机


当基础库准备更新时,会在客户端内进行逐步灰度直到全量发布。当用户客户端更新至最新基础库后,小程序就会运行在最新的基础库上。

随着基础库的不断更新,老版本客户端不支持的能力越来越多,所以基础库支持范围有一个最低客户端版本的要求,即部分老版本客户端以后将无法更新到最新的基础库,会停留在某一历史版本。例如,如果用户的支付宝客户端版本是 1.0.0 版本,那么基础库最多更新到  1.1.0


基础库版本分布


更新时间:2019 年 12 月 4 日

基础库版本

用户占比

支付宝客户端最低版本

>=1.21.4

93.64%

10.1.70

1.20.5

0.79%

10.1.68

1.20.1

0.33%

10.1.68

1.19.4

0.53%

10.1.65

1.16.4

0.35%

10.1.58

1.13.15

0.98%

10.1.32

其它

3.38%

-


设置最低基础库版本


从 开发中心 > 小程序应用 > 我的小程序,进入小程序详情页,点击左侧栏 设置,在 基础设置 栏,可设置小程序的最低基础库版本。若小程序用户使用的基础库版本低于设置的最低版本要求,则无法正常使用小程序,并将提示用户更新支付宝版本。设置版本号后,小程序需重新发版才会生效。


设置基础库版本.png


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


最低基础库版本.png


选中需设置为最低基础库版本的版本号,点击 确定 按钮,即设置成功。


选中基础库版本.png

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


已设置最低基础库版本.png

常见问题


Q:如何更新基础库版本

A:没有API去执行更新的,是根据支付宝客户端版本来更新的。