字节小程序
开发者社区
小程序小游戏
登录
小程序兼容性说明

小程序兼容性说明

1490浏览作者: Fremontlee

字节跳动小程序目前迭代速度比较快,各个app之间差异也比较大,开发者需要做好兼容工作,避免因为在低版本上使用了一个不兼容的api而出现体验问题。一般可以通过版本号比较api存在判断tt.caniuse区分宿主app三种方式进行兼容处理。另外上线发布的时候也可以选择支持小程序的最低基础库版本。

版本号比较
可以通过tt.getSystemInfo或者tt.getSystemInfoSync得到SDKVersion,SDKVersion是三位版本号,由[大版本].[小版本].[修订版本]三部分组成,例如:1.11.1。一般会在api文档上标注支持该api的最低版本,或者在组件文档上标注支持某个属性的最低版本。
api存在判断
一般新增的api在低版本基础库上是不存在的,贸然调用会导致错误。建议做如下判断:

if (tt.navigateToMiniProgram) {
tt.navigateToMiniProgram()
}
else {
tt.showModal({
title: '提示',
content: '当前客户端版本过低,无法使用该功能,请升级客户端或关闭后重启更新。'
})
}

caniuse(重磅更新,戳链接查看更多https://microapp.bytedance.com/dev/miniapp/uczN3EjL3czNx4yN3cTM
如果api的返回参数有更新,可以通过caniuse来判断:

tt.getImageInfo({
src: '../images/test.jpg',
success: (e) {
if (tt.caniuse('getImageInfo.path')) {
console.log(e.path)
}
}
})

区分app
目前字节跳动小程序已经集成到了多款app,可以通过如下方法判断小程序运行于哪个app

const info = tt.getSystemInfoSync();
console.log(info.appName);
if (info.appName.toUpperCase() === 'DOUYIN') {
// do something
}

info.appName对应的app:
info.appNameappToutiao 头条/

Douyin 抖音/

news_article_lite 头条极速版

基础库最低版本限制
可在开发者后台,进入设置页–选择JSSDK最低版本号

图片名称

最后一次编辑于 2020年06月21日
加载中